# Integración Botpress HITL
Esta integración te permite conectar tu bot Botpress con la plataforma de conversaciones de Brevo, permitiendo una configuración Human-in-the-Loop (HITL). Esto significa que tu bot Botpress puede manejar las interacciones iniciales del usuario y escalar sin problemas las conversaciones a agentes humanos en Brevo cuando sea necesario.
## Cómo funciona
Cuando un usuario interactúa con tu bot Botpress , la conversación puede transferirse a un agente humano en Brevo. El agente puede entonces hacerse cargo de la conversación y proporcionar soporte personalizado. Los mensajes del usuario de Botpress se transmitirán al agente de Brevo, y viceversa.
## Principales limitaciones
Tenga en cuenta las siguientes limitaciones al utilizar esta integración:
- **Atribución de mensajes:** Los mensajes enviados por el usuario Botpress al agente Brevo aparecerán como si fueran enviados por la cuenta del agente Brevo que está configurada con la integración. Sin embargo, para distinguir estos mensajes, se les antepondráBotpress User:". Por ejemplo: Botpress Botpress: Hola, necesito ayuda con mi pedido.`
- Actualizaciones de estado:** El usuario de Botpress no recibirá automáticamente notificaciones o actualizaciones de estado relativas a la asignación de agentes (por ejemplo, "El agente Juan se ha unido al chat").
## Guía de Configuración
Para configurar la integración Botpress HITL, necesitará lo siguiente:
1. **Clave API de Brevo
- Puedes crear y gestionar tus claves API de Brevo siguiendo las instrucciones de su página de ayuda oficial: [Crea y gestiona tus claves API](https://help.brevo.com/hc/en-us/articles/209467485-Create-and-manage-your-API-keys)
2. **Desactivar bloqueo de IP:**
- Para una comunicación fluida entre Botpress y Brevo, es necesario desactivar el bloqueo de IP en tu cuenta de Brevo.
- Navega hasta [Brevo IP Authorisation](https://app.brevo.com/security/authorised_ips) y asegúrate de que el bloqueo de IP está desactivado para permitir peticiones desde tu entorno Botpress .
3. **ID del agente Brevo
- Debes especificar qué cuenta de agente Brevo utilizará la integración para enviar y recibir mensajes.
- Navega a la página de configuración de agentes Brevo: [Configuración de agentes Brevo](https://conversations-app.brevo.com/settings/agents)
- Identifique el agente que desea utilizar para la integración y copie su ID de agente.
## Configuración de Webhook (Obligatorio)
Para recibir eventos de Brevo en tu integración Botpress , debes configurar un webhook en Brevo:
1. Ve a **Integraciones > Webhooks** en tu panel de Brevo ([enlace directo](https://conversations-app.brevo.com/settings/integrations/webhooks)).
2. 2. Haz clic en **Añadir nuevo webhook(o edita uno existente).
3. 3. En el campo **URL**, introduce el punto final de tu webhook de integración Botpress Brevo. Ejemplo:
```
https://webhook.botpress.cloud/ff43meb9-a102-4201-b045-fc498dc1f52b
```
4. En **Tipos de eventos**, seleccione:
- `conversationStarted`
- conversaciónTranscripción
- Fragmento de conversación
5. Haga clic en **Guardar** para activar el webhook.
> **Nota:** Asegúrate de que la URL coincide con el endpoint de tu integración Botpress y que todos los tipos de eventos requeridos están marcados para una funcionalidad completa.
Una vez configurado esto, tu integración Botpress recibirá eventos en tiempo real de Brevo y podrá procesarlos en consecuencia.
Una vez que tengas estos detalles, puedes proceder a configurar la integración dentro de tu entorno Botpress de acuerdo con las instrucciones de configuración específicas de la integración.
