Se usó la API de Cloud Translation para traducir esta página.
Switch to English

Messenger de Facebook

Con la integración de Dialogflow Messenger, puedes crear un bot de Facebook Messenger para interactuar con tus usuarios finales.

Cómo funciona

La integración funciona de la siguiente manera:

Configuración

Para configurar la integración, debes realizar las siguientes acciones:

  1. Sigue los pasos para crear una app de Facebook: Desarrollo de aplicaciones de Facebook.

  2. Configura la app de Facebook para usar la plataforma de Facebook Messenger. Sigue los pasos de la documentación Configura tu aplicación para Facebook a fin de lograr lo siguiente:

    • Agregar la plataforma de Messenger a tu app de Facebook.
    • Suscribir tu app a una página de Facebook. Asegúrate de que messages y messaging_postbacks estén habilitados en la suscripción de la página.
    • En este paso, se te proporciona un token de acceso. Copia este valor. Este token se usará para configurar la integración de la consola de Dialogflow.
    • Aún no debes configurar el webhook ni probar tu integración.
  3. Configura la integración desde la consola de Dialogflow:

    1. Ir a la consola de Dialogflow CX
    2. Haz clic en la pestaña Administrar del panel izquierdo.
    3. Haz clic en Integrations, en el menú de la barra lateral izquierda.
    4. Haz clic en el botón Conectar en el mosaico Facebook Messenger.
    5. Se abrirá un cuadro de diálogo de configuración:

      • Secreto de la app: Ingresa el secreto de la aplicación en la configuración básica del panel de la app de Facebook.

      • Verify token: Puedes ingresar cualquier token privado que desees. Copia este valor. Esto se usará para configurar el webhook de Facebook Messenger.

      • Token de acceso a la página: ingresa el token de acceso que copiaste durante la configuración de la app de Facebook anterior.

      • Habilitar el botón Comenzar: consulta la sección botón Comenzar.

      • URL de webhook: Copia este valor. Esto se usará para configurar el webhook de Facebook Messenger.

      • Iniciar: haz clic para iniciar este servicio de integración para tu agente.

  4. Finaliza la configuración de la app de Facebook y pruébala. Sigue los pasos que se indican en la documentación sobre la Configuración de tu aplicación de Facebook para lograr lo siguiente:

    • Configura el webhook de Facebook para tu app. Usa los valores de URL de webhook y Token de verificación que copiaste antes. Asegúrate de habilitar messages y messaging_postbacks en la suscripción a la página.
    • Probar tu app.

Eventos

Esta integración invoca los siguientes eventos. Puedes crear controladores de eventos personalizados para definir qué hacer cuando se activan los eventos.

Evento Descripción
FACEBOOK_WELCOME Se activa cuando un usuario final hace clic en el botón de introducción de Facebook Messenger.
FACEBOOK_MEDIA Se activa cuando el mensaje de un usuario final contiene archivos adjuntos (p.ej., audio, imagen, video, etcétera).

Botón Comenzar

Para configurar el botón de introducción de Facebook Messenger, haz lo siguiente:

  1. Habilita Habilitar el botón Comenzar cuando habilites este servicio de integración.

    • Este servicio de integración habilitará el botón mediante la llamada a la API de perfil de Facebook Messenger.

      curl -X POST \
      -H "Content-Type: application/json" \
      -d '{"get_started": {"payload": "FACEBOOK_WELCOME"}}' \
      "https://graph.facebook.com/v10.0/me/messenger_profile?access_token=${PAGE_ACCESS_TOKEN}"
      
  2. Crea un controlador de evento personalizado para el evento FACEBOOK_WELCOME.

Para probarla, haz lo siguiente:

  1. Borre la conversación anterior con su página de Facebook (si corresponde).

    • El botón Comenzar solo se muestra en las conversaciones nuevas.
  2. Inicia una conversación nueva con tu página de Facebook.

  3. Haz clic en el botón Comenzar y verifica la respuesta del controlador de evento personalizado.

Siempre puedes llamar a la API de perfil de Facebook Messenger para administrar el botón Comenzar. Esto podría ser útil para las pruebas.

Por ejemplo, la siguiente solicitud verifica el estado del botón Comenzar:

curl -X GET \
"https://graph.facebook.com/v10.0/me/messenger_profile?fields=get_started&access_token=${PAGE_ACCESS_TOKEN}"

La siguiente solicitud inhabilita el botón Comenzar:

curl -X DELETE \
-H "Content-Type: application/json" \
-d '{"fields": ["get_started"]}' \
"https://graph.facebook.com/v10.0/me/messenger_profile?access_token=${PAGE_ACCESS_TOKEN}"

Mensajes de respuesta enriquecida

Los mensajes de respuesta enriquecida se admiten a través de la Carga útil personalizada en la Entrega. Consulta el objeto de mensaje de la API de envío de Facebook Messenger para ver el formato del mensaje.

Por ejemplo, la siguiente carga útil personalizada proporciona un mensaje de texto simple:

{
  "text": "Hello, world"
}

La siguiente carga útil personalizada proporciona un mensaje de imagen:

{
  "attachment": {
    "type": "image",
    "payload": {
      "url": "https://example.com/test.jpg"
    }
  }
}