Brevo HITL

  # Integrazione Botpress HITL

Questa integrazione consente di collegare il bot Botpress alla piattaforma di conversazioni Brevo, consentendo una configurazione Human-in-the-Loop (HITL). Ciò significa che il bot Botpress può gestire le interazioni iniziali con gli utenti e, quando necessario, affidare le conversazioni ad agenti umani di Brevo.

## Come funziona

Quando un utente interagisce con il bot Botpress , la conversazione può essere trasferita a un agente umano in Brevo. L'agente può quindi prendere in carico la conversazione e fornire un'assistenza personalizzata. I messaggi dell'utente Botpress vengono trasmessi all'agente Brevo e viceversa.

## Limitazioni principali

Quando si utilizza questa integrazione, tenere presente le seguenti limitazioni:

- I messaggi inviati dall'utente Botpress all'agente Brevo appariranno come se fossero stati inviati dall'account dell'agente Brevo configurato con l'integrazione. Tuttavia, per distinguere questi messaggi, essi saranno preceduti daBotpress UtenteBotpress :". Ad esempio: Botpress Botpress: Salve, ho bisogno di aiuto per il mio ordine.`
- L'utente Botpress non riceverà automaticamente notifiche o aggiornamenti di stato relativi all'assegnazione dell'agente (ad esempio, "L'agente John si è unito alla chat").

## Guida all'installazione

Per configurare l'integrazione Botpress HITL, è necessario quanto segue:

1.  **Chiave API Brevo:**
    - È possibile creare e gestire le chiavi API di Brevo seguendo le istruzioni riportate nella pagina di aiuto ufficiale: [Creare e gestire le chiavi API](https://help.brevo.com/hc/en-us/articles/209467485-Create-and-manage-your-API-keys)
2.  **Disattivare il blocco IP
    - Per una comunicazione perfetta tra Botpress e Brevo, è necessario disattivare il blocco IP nel proprio account Brevo.
    - Andare su [Autorizzazione IP Brevo](https://app.brevo.com/security/authorised_ips) e assicurarsi che il blocco IP sia disattivato per consentire le richieste dal proprio ambiente Botpress .
3.  **ID agente Brevo
    - È necessario specificare quale account di agente Brevo sarà utilizzato dall'integrazione per inviare e ricevere messaggi.
    - Andare alla pagina delle impostazioni degli agenti Brevo: [Impostazioni agenti Brevo](https://conversations-app.brevo.com/settings/agents).
    - Identificare l'agente che si desidera utilizzare per l'integrazione e copiare il suo ID agente.

## Impostazione dei Webhook (obbligatorio)

Per ricevere eventi da Brevo nell'integrazione Botpress , è necessario impostare un webhook in Brevo:

1. Andare su **Integrazioni > Webhooks** nel cruscotto di Brevo ([link diretto](https://conversations-app.brevo.com/settings/integrations/webhooks)).
2. Fare clic su **Aggiungi un nuovo webhook(o modificarne uno esistente).
3. Nel campo **URL**, inserire l'endpoint del webhook dell'integrazione Botpress Brevo. Esempio:
   ```
   https://webhook.botpress.cloud/ff43meb9-a102-4201-b045-fc498dc1f52b
   ```
4. In **Tipi di evento**, selezionare:
   - `conversazioneiniziata`
   - `conversazioneTrascritta`
   - `conversazioneFrammento`
5. Fare clic su **Salva** per attivare il webhook.

> Nota:** Assicurarsi che l'URL corrisponda all'endpoint dell'integrazione Botpress e che tutti i tipi di evento richiesti siano controllati per una piena funzionalità.

Una volta configurata, l'integrazione Botpress riceverà gli eventi in tempo reale da Brevo e potrà elaborarli di conseguenza.

Una volta ottenute queste informazioni, si può procedere alla configurazione dell'integrazione nell'ambiente Botpress secondo le istruzioni di configurazione specifiche dell'integrazione.