Intercom HITL

  # Intercom Integración HITL

Esta integración permite a Botpress utilizar Intercom como proveedor HITL (Human in the Loop). Los mensajes del bot aparecerán en Intercom, y las respuestas del agente se enviarán de vuelta al bot.

## Características

- Perfecta integración entre Botpress e Intercom

- Sincronización de mensajes en tiempo real
- Soporte para mensajes de texto
- Gestión automática de sesiones de conversación
- Gestión de eventos Webhook
- Asignación de agentes y gestión de conversaciones

## Configuración

La integración requiere la siguiente configuración:

- `accessToken`: Su token de acceso Intercom (necesario para la autenticación de la API).

## Configuración de la aplicación de Intercom para la integración Botpress 

Esta guía le guiará a través de la instalación y configuración de Intercom para permitir la integración con su chatbot Botpress .

### Instrucciones paso a paso

#### 1. Crear una aplicación de Intercom 

* Navegue aintercomintercom
* Inicie sesión en su cuenta de Intercom 
* Ir a **Apps** en el hub
 desarrolladores
* Haga clic en **"Crear aplicación "**.
* Introduzca el nombre de su aplicación (por ejemplo,Botpress HITL Integration")
* Haga clic en "Crear aplicación".

#### 2. Copie el código de acceso

* En el panel de control de su aplicación, vaya a **Autenticación**.
* Copie el **Token de Acceso** mostrado en la sección de Token de Acceso
* En su **configuración de integración de Botpress Intercom , pegue este código de acceso.

#### 3. Configurar Webhooks

##### a. Webhook
Eventos de Conversación Webhook

* Ve a **Webhooks** en el dashboard de tu app
* Haz click en **"Añadir Webhook"**.
* Establece el Webhook URL** a tu Botpress Intercom integration webhook URL**.
* **Suscribirse sólo a estos eventos:**
  * Conversation.admin.assigned
  * Conversation.admin.closed
  * Conversation.admin.replied
* Haz click en **"Guardar Webhook"**.

### Summary of Required Botpress Config

* **Token de Acceso**: De autenticación de Intercom App
* Webhook URL**: Proporcionado por Botpress

## Uso

1. Configure la integración con su Token de Acceso Intercom 
2. Inicie una sesión de conversación utilizando la acción `startHitl`.
3. Los mensajes del bot aparecerán en las conversaciones de Intercom 
4. Las respuestas del agente en Intercom se enviarán de vuelta al bot
5. El estado de la conversación se gestiona automáticamente entre Botpress e Intercom
. Intercom

**Nota:** Al iniciar una sesión HITL, si el correo electrónico del usuario no existe como contacto en Intercom, se creará automáticamente un nuevo contacto. Si el correo electrónico ya existe, se utilizará el contacto existente para el proceso HITL.

## Soporte

Para obtener asistencia, póngase en contacto con el equipo de Botpress o consulte laIntercom documentación de la API deIntercom ]intercom.

## Solución de problemas

### Problemas comunes

1. Webhook no recibe eventos**: Asegúrese de que la URL de su webhook es accesible al público y está correctamente configurada
2. **Errores de autenticación**: Verifica que tu Access Token es correcto y tiene los permisos requeridos
3. **Los mensajes no se sincronizan**: Compruebe que la conversación se ha creado correctamente y que el contacto existe en Intercom

### Modo depuración

Habilite el registro de depuración en la configuración de Botpress para solucionar problemas de integración.