Referencia de plugins web

La plataforma de Messenger ofrece un práctico conjunto de plugins web que te permite iniciar fácilmente una conversación con personas que visitaron tu sitio en la web. Todos los plugins se implementan con el SDK de Facebook para JavaScript.

Índice

Plugin de chat con clientes
Plugin "Enviar mensaje"
Plugin "Enviar a Messenger"
Plugin Checkbox

Plugin de chat con clientes (beta)

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

Para obtener información sobre el uso, consulta Plugin de chat con clientes.

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	El identificador de la página.
`ref`	Cadena	*Opcional.* Cadena personalizada que se pasa al webhook en los eventos `messaging_postbacks` y `messaging_referrals`.
`theme_color`	Cadena	*Opcional.* El color que se usará como tema del plugin, incluido el color de fondo del icono del plugin de chat con clientes y el color de fondo de los mensajes que envíen los usuarios. Admite cualquier código de color hexadecimal con el signo de numeral al principio (p. ej., #0084FF), excepto el blanco. Te recomendamos que elijas un color con un contraste alto con respecto al blanco.
`logged_in_greeting`	Cadena	*Opcional.* El texto de saludo que se mostrará si el usuario ya inició sesión en Facebook. No debe superar los 80 caracteres.
`logged_out_greeting`	Cadena	*Opcional.* El texto de saludo que se mostrará si el usuario aún no inició sesión en Facebook. No deben superar los 80 caracteres.
`greeting_dialog_display`	Cadena	*Opcional.* Establece cómo se verá el cuadro de diálogo de saludo. Se admiten los siguientes valores: `show`: el cuadro de diálogo de saludo siempre se mostrará cuando se cargue el plugin. `fade`: el cuadro de diálogo de saludo del plugin se mostrará y, después, se desvanecerá y permanecerá oculto. `hide`: el cuadro de diálogo de saludo del plugin estará siempre oculto hasta que el usuario haga clic en el plugin. El valor predeterminado es `show` en computadoras y `hide` en celulares.
`greeting_dialog_delay`	Cadena	*Opcional.* Establece después de cuántos segundos se muestra el cuadro de diálogo de saludo una vez que se carga el plugin. Sirve para personalizar el momento en el que quieres que aparezca el cuadro de diálogo de saludo.
`minimized`	Booleano	Aviso de obsolescencia Este atributo está obsoleto. En su lugar, usa `greeting_dialog_display` para personalizar el plugin. El atributo `greeting_dialog_delay` tendrá prioridad sobre el atributo `minimized`. *Opcional.* `true` Si se establece en "true", tendrá el mismo efecto que establecer en "fade" el atributo "greeting_dialog_delay". `false` Si se establece en "false", tendrá el mismo efecto que establecer en "show" el atributo "greeting_dialog_delay".

Plugin "Enviar mensaje"

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

Para obtener información sobre el uso, consulta Plugin "Enviar mensaje".

Incluir formato

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

Atributos

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

Plugin "Enviar a Messenger"

Envía un mensaje en segundo plano a una persona desde el bot de Messenger y suscríbela.

Para obtener información sobre el uso, consulta Plugin "Enviar a Messenger".

Incluir formato

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

Atributos

Atributo	Tipo	Descripción
`class`	Cadena	Valor debe ser `fb-send-to-messenger`.
`page_id`	Cadena	El identificador de la página.
`messenger_app_id`	Número	Identificador de la app 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. 250 caracteres como máximo. Los caracteres válidos son `a-z A-Z 0-9 +/=-._`. Se debe codificar y cifrar para fines de seguridad.
`enforce_login`	Booleano	*Opcional.* Si es `true`, los usuarios con una sesión iniciada deben volver a iniciar sesión al hacer clic en el botón. El valor predeterminado es `false`.

Utiliza el parámetro ref para pasar el estado con la autenticación. Si colocas el plugin en varios lugares, tal vez quieras modificar el estado en función del lugar donde se muestra el plugin.

Plugin Checkbox

El plugin Checkbox suscribe a una persona al bot de Messenger como parte de un formulario, por ejemplo, de pago o registro.

Para obtener información sobre el uso, consulta plugin Checkbox.

Incluir formato

<div class="fb-messenger-checkbox"  
  origin=<PAGE_DOMAIN>
  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 asociada al bot.
`messenger_app_id`	Número	Identificador de la app de Facebook.
`user_ref`	Cadena	Parámetro único para hacer referencia a un usuario. 250 caracteres como máximo. Los caracteres válidos son `a-z A-Z 0-9 +/=-._`.
`allow_login`	Booleano	*Opcional.* Permite que las personas inicien sesión cuando no hay una sesión 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.* Establece el tema de color para el contenido del plugin. Se admiten las siguientes opciones: `light`: el plugin se muestra con texto oscuro. `dark`: el plugin se muestra con texto blanco, el icono de Messenger transparente y el rayo blanco. El valor predeterminado es `light`.
`center_align`	Booleano	*Opcional.* Establece si el contenido del plugin se deberá centrar. El valor predeterminado es `false`.

Referencia de plugins web

Índice

Plugin de chat con clientes (beta)

Incluir formato

Atributos

Aviso de obsolescencia

Plugin "Enviar mensaje"

Incluir formato

Atributos

Plugin "Enviar a Messenger"

Incluir formato

Atributos

Plugin Checkbox

Incluir formato

Atributos