---
title: Integraciones
slug: helper-es/integraciones
description: Learn how to integrate the virtual assistant, Helper, seamlessly with 4biz, Facebook Messenger, and through the API Rest. This comprehensive document provides step-by-step instructions for each integration method, including configuring parameters for 4biz
createdAt: 2022-06-13T21:44:37.000Z
---

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&#x20;*&#x70;uede integrarse de forma nativa con <font color="#ff6900">**4biz**</font>, Facebook o con el propio sistema del usuario a través de la *API Rest*.

## Procedimiento

1. Después de acceder a la plataforma, acceda al menú "**Integraciones**";
2. Se presentarán las siguientes opciones de integración: **Facebook Messenger**, <font color="#ff6900">**4biz** </font>y ***API Rest***;
3. Seleccione la opción que desea integrar.

### 4biz

Helper ya se integra de forma nativa con <font color="#ff6900">**4biz**</font>, 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: :&#x20;

| **Parámetro**                               | **Valor**                                                                                                                                                                                                                     |
| ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **402 Helper Assistant - External URL**     | <u>****</u><font color="#2166ae"><u>**http\://\[nombre-servidor\].helperassistant.com**</u></font><u>****</u>                                                                                                                 |
| **441 Helper Assistant - Conversation API** | <u>****</u><font color="#2166ae"><u>**http\://\[nombre-servidor\]\[acrónimo-idioma\].helperassistant.com/webhooks/rest/webhook**</u></font><u>****</u>                                                                        |
| **442 Helper Assistant - Parameters API**   | <u>****</u><font color="#2166ae"><u>**http\://\[nome-servidor\]\[**</u></font><font color="#2166ae"><u>**acrónimo**</u></font><font color="#2166ae"><u>**-idioma\].helperassistant.com/conversations/**</u></font><u>****</u> |

:::hint{type="warning"}
📌 <u>**IMPORTANTE**</u>**!**

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 "<font color="#ff6900">**4biz**</font>" y se le presentarán los valores para copiar y pegar en el valor de la propia plataforma <font color="#ff6900">**4biz**</font>.&#x20;

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"}`