Este documento se ha actualizado.
La traducción en Español (España) no está disponible todavía.

Actualización del documento en inglés: 14 oct.

Referencia de los plugins web

La plataforma de Messenger proporciona un conjunto muy práctico de plugins web que te facilitan iniciar una conversación con personas que han visitado tu web. Todos los plugins se implementan con el SDK de Facebook para JavaScript.

Plugin de chat de cliente (versión beta)

Con el plugin de chat de cliente de la plataforma de Messenger, puedes integrar el bot de Messenger directamente en el sitio web. De esta manera, los clientes pueden interactuar con tu empresa en cualquier momento y disfrutar de la misma experiencia personalizada con contenido multimedia enriquecido que obtienen en Messenger.

Para obtener más información sobre su uso, consulta Plugin de chat de cliente.

Incluir formato

<div class="fb-customerchat"
  page_id="{PAGE_ID}">
  
</div>

Atributos

Atributo	Tipo	Descripción
`class`	Cadena	El valor debe ser `fb-customerchat`.
`page_id`	Cadena	Identificador de tu página.
`ref`	Cadena	*Opcional.* Cadena personalizada que se pasa a tu webhook en los eventos `messaging_postbacks` y `messaging_referrals`.
`theme_color`	Cadena	*Opcional.* Color que se usa como estilo para el plugin, incluido el color de fondo del icono del plugin de chat de cliente y el de los mensajes que envían los usuarios. Compatible con cualquier código de color hexadecimal que incluya un signo numérico inicial (por ejemplo, #0084FF), excepto el blanco. Te recomendamos que elijas un color que contraste con el blanco.
`logged_in_greeting`	Cadena	*Opcional.* Texto de saludo que se mostrará si el usuario tiene la sesión iniciada en Facebook. Máximo 80 caracteres.
`logged_out_greeting`	Cadena	*Opcional.* Texto de saludo que se mostrará si el usuario no tiene la sesión iniciada en Facebook. Máximo 80 caracteres.
`greeting_dialog_display`	Cadena	*Opcional.* Define cómo se mostrará el cuadro de diálogo de saludo. Se admiten los siguientes valores: `show`: el cuadro de diálogo de saludo siempre se mostrará cuando el plugin se cargue. `fade`: el cuadro de diálogo de saludo se mostrará y, a continuación, desaparecerá y se mantendrá oculto. `hide`: el cuadro de diálogo de saludo se mantendrá oculto hasta que el usuario haga clic en el plugin. El valor predeterminado es `show` en ordenadores y `hide` en dispositivos móviles.
`greeting_dialog_delay`	Cadena	*Opcional.* Define el número de segundos de espera antes de que aparezca el cuadro de diálogo de saludo una vez cargado el plugin. Se puede usar para personalizar el momento en que quieres que aparezca este cuadro de diálogo.
`minimized`	Booleano	Aviso de retirada Este atributo se ha retirado. En su lugar, usa `greeting_dialog_display` para personalizar el plugin. El atributo `greeting_dialog_delay` tendrá prioridad sobre el atributo `minimized`. *Opcional.* `true` Cuando se establece en “true”, tendrá el mismo efecto que establecer “greeting_dialog_delay” en “fade”. `false` Cuando se establece en “false”, tendrá el mismo efecto que establecer “greeting_dialog_delay” en “show”.

Plugin Enviar mensaje

Invita a una persona directamente a una conversación en Messenger.

Para obtener más información sobre su uso, consulta Plugin “Enviar mensaje”.

Incluir formato

<div class="fb-messengermessageus" 
  messenger_app_id="{APP_ID}" 
  page_id="{PAGE_ID}"
  color="{blue | white}"
  ref="{PASS_THROUGH_PARAM}" 
  size="{standard | large | xlarge}">
  
</div>

Atributos

Atributo	Atributo HTML5	Tipo	Descripción
`class`		Cadena	El valor debe ser `fb-messengermessageus`.
`page_id`		Cadena	Identificador de tu página.
`messenger_app_id`		Número	Tu identificador de la aplicación de Facebook.
`color`	`data-color`	Cadena	Color del botón: `blue` o `white`. El valor predeterminado es `blue`.
`size`	`data-size`	Cadena	Tamaño del botón: `standard`, `large` o `xlarge`. El valor predeterminado es `large`.
`ref`		Cadena	*Opcional.* Cadena personalizada que se pasa a tu webhook en los eventos `messaging_postbacks` y `messaging_referrals`.

Plugin Enviar a Messenger

Envía un mensaje a una persona desde tu bot de Messenger en segundo plano y actívale la opción.

Para obtener más información sobre su uso, consulta Plugin “Enviar a Messenger”.

Incluir formato

<div class="fb-send-to-messenger" 
  messenger_app_id="{APP_ID};" 
  page_id="{PAGE_ID}" 
  ref="{PASS_THROUGH_PARAM}" 
  color="{blue | white}" 
  size="{standard | large | xlarge}">
  
</div>

Atributos

Atributo	Tipo	Descripción
`class`	Cadena	El valor debe ser `fb-send-to-messenger`.
`page_id`	Cadena	Identificador de tu página.
`messenger_app_id`	Número	Tu identificador de la aplicación de Facebook.
`color`	Cadena	*Opcional.* Color del botón: `blue` o `white`. El valor predeterminado es `blue`.
`size`	Cadena	*Opcional.* Tamaño del botón: `standard`, `large` o `xlarge`. El valor predeterminado es `large`.
`ref`	Cadena	*Opcional.* Parámetro de estado personalizado. Máximo 250 caracteres. Los caracteres válidos son `a-z A-Z 0-9 +/=-._`. Por motivos de seguridad, debe codificarse y cifrarse.
`enforce_login`	Booleano	*Opcional.* Si es `true`, los usuarios con la sesión iniciada deberán volver a iniciar sesión al hacer clic en el botón. Adopta `false` como valor predeterminado.

Utiliza el parámetro ref para pasar el estado con la autenticación. Si muestras el plugin en varios lugares, es recomendable modificar el estado en función del lugar donde aparezca.

Plugin Checkbox

El plugin Checkbox suscribe a una persona a tu bot de Messenger con un formulario, como el de pago o registro.

Para obtener más información sobre su uso, consulta Plugin “Checkbox”.

Incluir formato

<div class="fb-messenger-checkbox"  
  page_id="{PAGE_ID}"
  messenger_app_id="{APP_ID}"
  user_ref="{UNIQUE_REF_PARAM}"
  allow_login="{true}"
  size="{small | medium | large | standard | xlarge}"
  skin="{light | dark}"
  center_align="{true|false}">
  
</div>

Atributos

Atributo	Tipo	Descripción
`class`	Cadena	El valor debe ser `fb-messenger-checkbox`.
`page_id`	Número	Identificador de la página de Facebook asociado con tu bot.
`messenger_app_id`	Número	Tu identificador de la aplicación de Facebook.
`user_ref`	Cadena	Parámetro único para hacer referencia a un usuario. Máximo 250 caracteres. Los caracteres válidos son `a-z A-Z 0-9 +/=-._`.
`allow_login`	Booleano	*Opcional.* Permite a las personas iniciar sesión si no hay ninguna activa. El valor predeterminado es `true`.
`size`	Cadena	*Opcional.* Tamaño del plugin: `small`, `medium`, `large`, `standard` o `xlarge`. El valor predeterminado es `large`.
`skin`	Cadena	*Opcional.* Define el estilo de color del contenido del plugin. Se admiten las siguientes opciones: `light`: el plugin se representa con texto oscuro. `dark`: el plugin se muestra con texto de color blanco, un icono de Messenger transparente y un rayo blanco. El valor predeterminado es `light`.
`center_align`	Booleano	*Opcional.* Establece si el contenido del plugin debe mostrarse centrado. Adopta `false` como valor predeterminado.

Referencia de los plugins web

Contenido

Plugin de chat de cliente (versión beta)

Incluir formato

Atributos

Aviso de retirada

Plugin Enviar mensaje

Incluir formato

Atributos

Plugin Enviar a Messenger

Incluir formato

Atributos

Plugin Checkbox

Incluir formato

Atributos