# Integração Botpress HITL
Esta integração permite-lhe ligar o seu bot Botpress à plataforma de conversações da Brevo, permitindo uma configuração Human-in-the-Loop (HITL). Isso significa que seu bot Botpress pode lidar com as interações iniciais do usuário e encaminhar conversas para agentes humanos no Brevo quando necessário.
## Como funciona
Quando um usuário interage com seu bot Botpress , a conversa pode ser transferida para um agente humano no Brevo. O agente pode então assumir a conversa e fornecer suporte personalizado. As mensagens do utilizador Botpress serão retransmitidas para o agente do Brevo e vice-versa.
## Principais limitações
Por favor, esteja ciente das seguintes limitações ao usar esta integração:
- **Atribuição de mensagens:** As mensagens enviadas pelo utilizador Botpress para o agente Brevo aparecerão como se estivessem a ser enviadas pela conta do agente Brevo que está configurada com a integração. No entanto, para distinguir estas mensagens, elas serão precedidas deBotpress User:". Por exemplo: Botpress do Botpress: Olá, preciso de ajuda com meu pedido.
- **Actualizações de estado:** O utilizador Botpress não receberá automaticamente notificações ou actualizações de estado relativas à atribuição de agentes (por exemplo, "O agente João juntou-se ao chat").
## Guia de Configuração
Para configurar a integração Botpress HITL, é necessário o seguinte:
1. **Chave da API do Brevo:**
- Podes criar e gerir as tuas chaves de API Brevo seguindo as instruções na página de ajuda oficial: [Criar e gerir as suas chaves API](https://help.brevo.com/hc/en-us/articles/209467485-Create-and-manage-your-API-keys)
2. **Desativar o bloqueio de IP:**
- Para uma comunicação perfeita entre Botpress e o Brevo, é necessário desativar o bloqueio de IP na tua conta Brevo.
- Navegue até [Brevo IP Authorisation](https://app.brevo.com/security/authorised_ips) e certifique-se de que o bloqueio de IP está desativado para permitir pedidos do seu ambiente Botpress .
3. **ID do agente Brevo:**
- É necessário especificar qual a conta de agente Brevo que será utilizada pela integração para enviar e receber mensagens.
- Navegue até à página de definições dos agentes Brevo: [Definições de agentes Brevo](https://conversations-app.brevo.com/settings/agents)
- Identifique o agente que pretende utilizar para a integração e copie o respetivo ID de agente.
## Configuração Webhook (obrigatório)
Para receber eventos do Brevo na sua integração Botpress , deve configurar um webhook no Brevo:
1. Vá para **Integrações > Webhooks** no seu painel do Brevo ([link direto](https://conversations-app.brevo.com/settings/integrations/webhooks)).
2. Clique em **Adicionar novo webhook(ou edite um já existente).
3. No campo **URL**, introduza o ponto de extremidade webhook integração Botpress Brevo. Exemplo:
```
https://webhook.botpress.cloud/ff43meb9-a102-4201-b045-fc498dc1f52b
```
4. Em **Tipos de evento**, selecionar:
- `conversationStarted`
- `conversationTranscript`
- `conversationFragment`
5. Clique em **Salvar** para ativar o webhook.
**Nota:** Certifique-se de que o URL corresponde ao ponto final da integração do Botpress e que todos os tipos de eventos necessários são verificados para uma funcionalidade completa.
Uma vez configurado, a sua integração Botpress receberá eventos em tempo real do Brevo e poderá processá-los em conformidade.
Assim que tiver estes detalhes, pode prosseguir com a configuração da integração no seu ambiente Botpress de acordo com as instruções de configuração específicas da integração.
