Messenger de Meta

Vista previa

Este producto o función está sujeto a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones específicas del Servicio. Los productos y las funciones que se encuentran en la fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Mediante la integración de Meta Messenger, puedes crear un bot de Meta Messenger para interactuar con tus usuarios finales.

Nota: Cuando se usa una integración de terceros, las solicitudes y los datos del usuario final se envían a Google y al tercero. Las Condiciones del Servicio, el ANS, los precios y las cuotas de tu edición de agente se aplican a la administración de estas solicitudes por parte de Google. Las Condiciones del Servicio, el ANS, los precios y las cuotas del tercero se aplican a la administración de estas solicitudes por parte del tercero.

Cómo funciona

Nota: Esta integración no es compatible con Workplace de Meta.

La integración funciona de la siguiente manera:

• Creas una app de Meta que usa la plataforma de Meta Messenger.
• Configura la integración de agentes de conversación (Dialogflow CX) y la app de Meta para que se comuniquen entre sí.
• La integración de agentes conversacionales (Dialogflow CX) envía mensajes al usuario final mediante la API de Meta Messenger.
• La integración de agentes conversacionales (Dialogflow CX) actúa como los webhooks de Meta para la plataforma de Messenger para recibir mensajes del usuario final.

Configuración

Nota: Asegúrate de habilitar la facturación en el proyecto antes de probar la integración.

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

1. Sigue los pasos para crear una app de Meta: Desarrollo de apps de Meta.

2. Configura la app de Meta para usar la plataforma de Meta Messenger. Sigue los pasos que se indican en la documentación sobre los webhooks de Meta para la plataforma de Messenger para lograr lo siguiente:

   • Agrega la plataforma de Messenger a tu app de Meta.
   • Suscribir tu app a una página de Meta Asegúrate de que messages y messaging_postbacks estén habilitados en la suscripción a la página.
   • En este paso, se te proporciona un token de acceso. Copia este valor. Este token se usa para configurar la integración desde la consola de agentes conversacionales (Dialogflow CX).
   • Aún no debes configurar el webhook ni probar tu integración.

3. Configura la integración desde la consola de agentes de conversación (Dialogflow CX):

   1. Ve a la consola de Dialogflow CX.
   2. Haz clic en la pestaña Administrar en el panel izquierdo.
   3. Haz clic en Integrations, en el menú de la barra lateral izquierda.
   4. Haz clic en el botón Conectar en la tarjeta Meta Messenger.

   5. Se abrirá un cuadro de diálogo de configuración:

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

      • Verify Token: Puede ingresar el token privado que desees. Copia este valor. Se usa para configurar el webhook de Meta Messenger.

      • Page access token: Ingresa el token de acceso que copiaste durante la configuración de la app de Meta antes.

      • Habilita el botón Comenzar: Consulta la sección botón Comenzar.

      • URL de webhook: Copia este valor. Se usa para configurar el webhook de Meta Messenger.

      • Start: Haz clic a fin de iniciar este servicio de integración para tu agente.

4. Finaliza la configuración de la app de Meta y pruébala. Sigue los pasos que se indican en la documentación sobre los webhooks de Meta para la plataforma de Messenger para lograr lo siguiente:

   • Configura el webhook de Meta para tu app. Usa los valores de Webhook URL y Verify Token que copiaste antes. Asegúrate de habilitar messages y messaging_postbacks en la suscripción de 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 activen los eventos.

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

Botón Comenzar

Para configurar el botón de Comenzar de Meta Messenger, haz lo siguiente:

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

   • Este servicio de integración habilita el botón por ti mediante una llamada a la API de Messenger Profile.

     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 eventos personalizado para el evento FACEBOOK_WELCOME.

Para probarla, haz lo siguiente:

1. Borra la conversación anterior con tu página de Meta (si corresponde).

   • El botón Comenzar solo aparece en las conversaciones nuevas.

2. Inicia una conversación nueva con tu página de Meta.

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

Siempre puedes llamar a la API de perfil de Messenger para administrar el botón Comenzar. Esto puede ser útil para realizar 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 son compatibles con la carga útil personalizada en Entregas. Consulta Objeto de mensaje de parámetros de la API de Send para conocer 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"
    }
  }
}

Respuestas específicas del canal

Después de configurar las respuestas específicas del canal, el canal DF_CX_FB_MESSENGER se usa automáticamente cuando el agente responde a los mensajes de Meta Messenger.