Conexión de un bot a Facebook

Puede configurar el bot para comunicarse con personas a través de Facebook Messenger o Facebook Workplace. En este artículo se describe cómo crear una aplicación de Facebook mediante el sitio Meta for Developers, conectar el bot a la aplicación de Facebook en Azure y probar el bot en Facebook.

En este artículo se muestra cómo agregar el canal de Facebook al bot a través de Azure Portal. Para obtener información sobre cómo usar un adaptador de canal personalizado, consulte Información adicional.

Requisitos previos

• Suscripción a Azure. Si aún no tiene una, cree una cuenta gratuita antes de empezar.
• Un bot publicado en Azure que quiere conectarse a Facebook.
• Una cuenta de Facebook para desarrolladores. Si no tiene una cuenta, puede crear una en developers.facebook.com.
• Una página de Facebook desde la que los usuarios accederán al bot. Si no tiene una, cree una Página nueva.
• Para usar Facebook Workplace con el bot, debe crear una cuenta de Workplace y una integración personalizada para conectar el bot.

Cree una aplicación de Facebook.

Facebook Messenger

Los usuarios accederán al bot desde una página de Facebook. Para conectar el bot, habilitará Facebook Messenger en la página de Facebook y, a continuación, conectará el bot a la página.

Creación de la aplicación

1. Inicie sesión en la cuenta de Meta for Developers.
2. Vaya a Crear una nueva aplicación de Facebook.
3. En la página Seleccionar un tipo de aplicación, seleccione Empresa y, a continuación, Siguiente.
4. En la página Proporcionar información básica, introduzca un nombre para la aplicación y seleccione Crear aplicación.
   • Si se le solicita, escriba la contraseña y seleccione Enviar para crear la aplicación.
   • Una vez creada la aplicación, el sitio va a una página de la aplicación.
5. Expanda Configuración y seleccione Básico.
   1. Copie y guarde el identificador de aplicación y el Secreto de aplicación.
6. Ahora en Configuración, seleccione Avanzado.
   1. En el panel resultante, desplácese hacia abajo hasta la configuración de Seguridad y habilite Permitir el acceso de API a la configuración de la aplicación.
   2. Seleccione Save changes (Guardar los cambios).

Habilitación de Messenger

1. Seleccione Panel.
2. En el panel de resultados, desplácese hacia abajo hasta el icono de Messenger y seleccione Configurar.
3. El sitio agrega la configuración de Messenger a la aplicación y muestra la página de configuración.

Adición de páginas y generación de tokens

1. En Messenger, seleccione Configuración.

2. Desplácese hacia abajo hasta Tokens de acceso y seleccione Agregar o quitar páginas.

   1. Cuando se le solicite que la identidad se asocie a Messenger, continúe con su cuenta actual o inicie sesión en otra.
   2. Cuando se le solicite las páginas que quiere usar con la aplicación, seleccione las páginas y, a continuación, seleccione Siguiente.
   3. Si se le pide que envíe la solicitud de revisión de inicio de sesión, revise la información y seleccione Listo.
   4. Si se ejecuta correctamente, el sitio muestra una página correcta. Seleccione OK (Aceptar) para continuar.

3. La Página que agregó aparece ahora en la lista de Páginas.

   Copie el id. de la Página y guárdelo para más adelante.

4. Seleccione Generar token para la Página.

   1. El sitio muestra información de seguridad y le ofrece la oportunidad de copiar el token.
   2. Lea y confirme la advertencia.
   3. Copie el token y seleccione Listo.

Ahora tiene la información de la aplicación y un token para el paso siguiente. Deje los pasos pendientes de configuración de Facebook. Los usará más adelante.

Configura tu bot en Azure

Para enviar mensajes y otros eventos desde el bot a Facebook Messenger, habilite la integración de webhooks.

1. En una nueva ventana del explorador, abra Azure Portal.
2. Abra la hoja de recursos del bot de Azure para el bot.
3. Abra Canales y seleccione Facebook.
4. En Configuración del canal de Facebook, introduzca la información de Facebook que copió en los pasos anteriores.
   1. Escriba el identificador de la aplicación de Facebook y el Secreto de la aplicación de Facebook.
   2. Escriba el identificador de página y el Token de acceso.
   3. Copie los valores URL de devolución de llamada y verificar token generados.
   4. Seleccione Agregar.

Sugerencia

• Si no tiene una copia de la información de los pasos anteriores, puede recuperarla para el sitio meta para desarrolladores.
• Si es necesario, cree un nuevo token web para la página. Para obtener instrucciones, consulte Adición de páginas y generación de tokens.

Habilitación de webhooks

Vuelva a la configuración de Facebook para finalizar el proceso de configuración.

1. En el sitio meta para desarrolladores, vuelva a la página de configuración de Messenger de la aplicación.
2. En el panel de resultados, desplácese hacia abajo hasta la sección Webhooks y seleccione Agregar URL de devolución de llamada.
3. En la página Editar URL de devolución de llamada:
   1. Introduzca la URL de devolución de llamada y verifique los valores de token que copió desde el Azure Portal.
   2. Seleccione Comprobar y guardar.
4. La Página que agregó aparece ahora en la lista de Páginas bajo Webhooks.
5. Seleccione Añadir suscripciones para la Página.
   1. En la página Editar suscripciones de página, seleccione los siguientes campos de suscripción:
      • messages
      • messaging_postbacks
      • messaging_options
      • message_deliveries
   2. Seleccione Guardar.
6. El sitio muestra los campos de suscripción agregados junto a la Página del bot.

Facebook Workplace

Nota:

El 16 de diciembre de 2019, Workplace by Facebook cambió su modelo de seguridad de las integraciones personalizadas. Facebook no acepta nuevas integraciones de aplicaciones para Facebook Workplace.

Hacer pública la aplicación

Una aplicación se encuentra en Modo para desarrolladores hasta que no se publica. Los complementos y las funcionalidades de API solo funcionarán para los administradores, los desarrolladores y los evaluadores.

Solo el creador (la cuenta de desarrollo de Facebook que creó la página y el bot) puede obtener una respuesta de bot. Los usuarios normales de Facebook no pueden ver la página ni el bot. Asignar roles de desarrollo o pruebas a los usuarios de destino, por lo que también pueden chatear con el bot.

Los usuarios que se van a agregar a los roles de evaluador deben registrarse primero en el sitio para desarrolladores de Meta. El rol de evaluador no está disponible para los usuarios de Facebook que no tienen una cuenta de desarrolladores de Meta. Para obtener más información sobre los roles de aplicación y los usuarios de prueba, consulte la documentación para desarrolladores de Meta for Developers.

Enviar para revisión

Facebook requiere una dirección URL de la directiva de privacidad y una dirección URL de las Condiciones del servicio en su página de configuración de aplicación básica. La página Código de conducta contiene vínculos a recursos de terceros para ayudar a crear una directiva de privacidad. La página Condiciones de uso contiene los términos de ejemplo que le ayudarán a crear un documento de condiciones del servicio adecuado.

Al finalizar el bot, Facebook tiene su propio proceso de revisión para las aplicaciones que se publican en Messenger. El bot se probará para asegurarse de que es compatible con las Políticas de la plataforma de Facebook.

Hacer pública la aplicación y publicar la Página

Una vez que la revisión se considere correcta, en el panel de aplicaciones en Revisión de la aplicación, establezca la aplicación en Pública. Asegúrese de que la página de Facebook asociada a este bot esté publicada. El estado aparece en la configuración de las páginas.

Configure la versión de la API

Si recibe una notificación de Facebook sobre una determinada versión de Graph API en desuso:

1. Vaya a Meta para desarrolladores.
2. Vaya a la aplicación que creó para el bot.
3. En Configuración, seleccione Avanzado.
4. Seleccione Actualizar versión de API y, a continuación, cambie Actualizar todas las llamadas a la versión 4.0.

Pruebe la conexión siguiendo los pasos descritos en la sección Probar el bot en Facebook.

Prueba del bot en Facebook

Ahora puede probar si el bot está conectado a Facebook correctamente mediante el envío de un mensaje mediante la página de Facebook asociada a la nueva aplicación de Facebook.

1. Vaya a Facebook y cambie al perfil de su página.
2. Seleccione más acciones (...) y, a continuación Agregar botón de acción.
   1. En el cuadro de diálogo Personalizar su botón de acción, seleccione Probarlo y siga las instrucciones.
   2. En la página Botón de acción en Obtener personas para ponerse en contacto con usted, seleccione Enviar mensaje.
   3. Seleccione Siguiente, complete el cuadro de diálogo y guarde los cambios.
3. Vuelva a su perfil personal.
4. Vaya a la página y seleccione Mensaje para probar la conexión con el bot.

También puede probar esta característica con el bot de ejemplo para el adaptador de Facebook; para ello, rellene el archivo appsettings.json con los mismos valores descritos en los pasos anteriores.

Información adicional

Consulte el ejemplo de eventos de Facebook de C# de Bot Framework para obtener un bot de ejemplo que admita la comunicación de Facebook Messenger.

Para obtener documentación de Facebook Messenger, consulte:

• Documentación de la plataforma de Messenger.
• Instrucciones previas al lanzamiento
• Inicio rápido
• Guía de instalación

Para obtener documentación de Facebook Workplace, consulte:

• Centro de ayuda del área de trabajo
• Documentación para desarrolladores de Workplace