Brevo HITL

   https://webhook.botpress.cloud/ff43meb9-a102-4201-b045-fc498dc1f52b

  # 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 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 integração Botpress , é necessário 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 final 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.