Intercom HITL

  # Integrazione HITL Intercom 

Questa integrazione consente a Botpress di utilizzare Intercom come provider HITL (Human in the Loop). I messaggi del bot appariranno in Intercom e le risposte degli agenti saranno inviate al bot.

## Caratteristiche

- Integrazione perfetta tra Botpress e Intercom

- Sincronizzazione dei messaggi in tempo reale
- Supporto per i messaggi di testo
- Gestione automatica della sessione di conversazione
- Gestione degli eventi Webhook
- Assegnazione degli agenti e gestione delle conversazioni

## Configurazione

L'integrazione richiede la seguente configurazione:

- `accessToken`: Il vostro token di accesso Intercom (necessario per l'autenticazione API).

## Configurazione dell'app Intercom per l'integrazione Botpress 

Questa guida illustra l'impostazione e la configurazione di Intercom per consentire l'integrazione con il chatbot Botpress .

### Istruzioni passo-passo

#### 1. Creare un'app Intercom 

* Navigare suintercomintercom
* Accedere al proprio account Intercom 
* Andare a **Apps** nell'hub
 degli sviluppatori hub

* Fare clic su **"Crea app "**.
* Inserire il nome dell'applicazione (ad esempio,Botpress IntegrazioneBotpress HITL").
* Fare clic su **"Crea app "**.

#### 2. Copiare il token di accesso

* Nella dashboard dell'applicazione, andare su **Autenticazione**.
* Copiare il **Token di accesso** mostrato nella sezione Token di accesso.
* Nella vostra **Configurazione dell'integrazione Botpress Intercom , incollate questo token di accesso.

#### 3. Configurare i webhook

##### a. Webhook
Eventi di conversazione Webhook

* Andare a **Webhooks** nella dashboard dell'applicazione.
* Fare clic su **"Aggiungi Webhook"**.
* Impostare il Webhook URL** con il vostro Botpress Intercom integration webhook URL**
* Sottoscrivete solo questi eventi:**
  * `conversazione.admin.assegnato`
  * `conversazione.admin.chiusa`
  * `conversazione.admin.risposto`
* Fare clic su **"Salva Webhook"**.

### Riepilogo della configurazione di Botpress richiesta

* **Token di accesso**: Dall'autenticazione dell'app Intercom 
* **Urbine del Webhook : Fornito da Botpress

## Utilizzo

1. Configurate l'integrazione con il vostro token di accesso Intercom 
2. Avviare una sessione di conversazione utilizzando l'azione `startHitl
3. I messaggi del bot appariranno nelle conversazioni Intercom 
4. Le risposte dell'agente nell'Intercom saranno inviate di nuovo al bot.
5. Lo stato delle conversazioni viene gestito automaticamente tra Botpress e Intercom
. Intercom

> Nota:** Quando si avvia una sessione HITL, se l'email dell'utente non esiste come contatto in Intercom, verrà creato automaticamente un nuovo contatto. Se l'email esiste già, il contatto esistente verrà utilizzato per il processo HITL.

## Supporto

Per il supporto, contattare il team di Botpress o consultare laIntercom Documentazione APIIntercom ]intercom.

## Risoluzione dei problemi

### Problemi comuni

1. **Il Webhook non riceve eventi**: Assicurarsi che l'URL del webhook sia pubblicamente accessibile e correttamente configurato.
2. **Errore di autenticazione**: Verificare che il token di accesso sia corretto e disponga dei permessi richiesti.
3. **Messaggi non sincronizzati**: Verificare che la conversazione sia stata creata correttamente e che il contatto esista in Intercom
. Intercom

### Modalità Debug

Abilitare la registrazione di debug nella configurazione di Botpress per risolvere i problemi di integrazione.