Integraciones
Las integraciones con el asistente virtual Helper se refieren a los canales en los que el administrador proporcionará el asistente. Esta funcionalidad permitirá la inserción de los enlaces de las plataformas deseadas para tener la integración del asistente virtual con el sistema seleccionado.
Veremos más adelante que el chatbot puede integrarse de forma nativa con 4biz, Facebook o con el propio sistema del usuario a través de la API Rest.
Procedimiento
- Después de acceder a la plataforma, acceda al menú "Integraciones";
- Se presentarán las siguientes opciones de integración: Facebook Messenger, 4biz y API Rest;
- Seleccione la opción que desea integrar.
4biz
Helper ya se integra de forma nativa con 4biz, por lo que es muy fácil añadirlo a su entorno.
Para realizar la integración, es necesario que configure los parámetros necesarios en su propio entorno de producción. Para ello, acceda al sistema y en el menú de procesos, seleccione Parametrización > Parámetros 4biz.
Busque y complete los siguientes parámetros: :
Parámetro | Valor |
|---|---|
402 Helper Assistant - External URL | http://[nombre-servidor].helperassistant.com |
441 Helper Assistant - Conversation API | http://[nombre-servidor][acrónimo-idioma].helperassistant.com/webhooks/rest/webhook |
442 Helper Assistant - Parameters API | http://[nome-servidor][acrónimo-idioma].helperassistant.com/conversations/ |
📌 IMPORTANTE!
Los valores a completar en los parámetros anteriores dependerán del valor mostrado en la herramienta Helper. Para ello, accede a tu asistente virtual y selecciona "Integraciones". Para integrarse con la plataforma, seleccione "4biz" y se le presentarán los valores para copiar y pegar en el valor de la propia plataforma 4biz.
Estos parámetros no se pueden cambiar por el cliente.
Facebook Messenger
También puede integrar el asistente virtual Helper con el chat de Facebook Messenger. En este caso las instrucciones las proporciona el propio Facebook y proporcionamos la información necesaria para realizar la integración:
- Callback URL
- Verify Token
- Secret
- Page Access Token
API Rest
En esta funcionalidad, el cliente puede personalizar el asistente virtual para otro canal. Por ejemplo, si el cliente ya tiene un sitio institucional y quiere incluir el asistente virtual para su chat. Para ello, simplemente seleccione la opción de comunicación API Rest. La API Rest es el protocolo de comunicación del asistente virtual. Muestra la siguiente información para llevar a cabo la integración con éxito:
- Endpoint
- Método
- Media Type
Y los formatos necesarios para la integración:
- Formato de envío de mensajes al bot:
{"sender": "joao", "message": "cuéntame algunas cosas sobre ti" }
- Formato de retorno del mensaje del bot en texto:
{ "recipient_id": "joao", "text": "Puedo ayudarle a trabajar más inteligentemente, en lugar de más" }
- Formato de retorno del mensaje del bot en botón:
{ "recipient_id": "joao", "text": "¿Podrías evaluar mi servicio?", "buttons": [ { "title": "Sí", "payload": "sí" }, {"title": "No","payload": "no" } ] }
- Formato de retorno del mensaje del bot en imagen:
{"image": "https://helperassistantimages.s3.amazonaws.com/dev/fe711b50-d974-11e9-9622-94de80f33bee.png", "recipient_id": "joao"}
O
{"attachment": "https://helperassistantimages.s3.amazonaws.com/dev/fe711b50-d974-11e9-9622-94de80f33bee.png","recipient_id": "joao"}