Intercom HITL

  Intercom # Intégration HITL

Cette intégration permet à Botpress d'utiliser Intercom comme fournisseur HITL (Human in the Loop). Les messages du bot apparaîtront dans Intercom, et les réponses de l'agent seront envoyées au bot.

## Caractéristiques

- Intégration transparente entre Botpress et Intercom

- Synchronisation des messages en temps réel
- Support pour les messages texte
- Gestion automatique des sessions de conversation
- Gestion des événements Webhook
- Affectation des agents et gestion des conversations

## Configuration

L'intégration nécessite la configuration suivante :

- `accessToken` : Votre jeton d'accès Intercom (requis pour l'authentification de l'API)

## Configuration de l'application Intercom pour l'intégration de Botpress 

Ce guide vous guide à travers l'installation et la configuration d'Intercom pour permettre l'intégration avec votre chatbot Botpress .

### Instructions pas à pas

#### 1. Créer une application Intercom 

* Naviguez versintercomintercom
* Connectez-vous à votre compte Intercom 
* Allez dans **Apps** dans le hub
 développeur
* Cliquez sur **"Create App "** (Créer une application)
* Entrez le nom de votre application (par exemple,Botpress HITL Integration")
* Cliquez sur **"Créer une application "**

#### 2. Copier le Token d'accès

* Dans le tableau de bord de votre application, allez dans **Authentication**
* Copiez le **jeton d'accès** indiqué dans la section Jeton d'accès.
* Dans votre **configuration de l'intégration de Botpress Intercom , collez ce jeton d'accès.

#### 3. Configurer les Webhooks

##### a. Webhook
des événements de conversation Webhook

* Allez dans **Webhooks** dans le tableau de bord de votre application
* Cliquez sur **"Add Webhook"**.
* Définissez l'URL du Webhook  webhook comme étant l'URL webhook 'intégration de Botpress Intercom .
* **S'abonner uniquement à ces événements:**
  * `conversation.admin.assigned`
  * `conversation.admin.closed` (fermé)
  * `conversation.admin.replied`
* Cliquez sur **"Save Webhook"**

### Résumé de la configuration requise pour Botpress 

**Token d'accès** : De l'authentification de l'application Intercom 
* Webhook URL** : Fourni par Botpress

## Utilisation

1. Configurez l'intégration avec votre Token d'accès Intercom 
2. Démarrez une session de conversation en utilisant l'action `startHitl`.
3. Les messages du bot apparaîtront dans les conversations Intercom .
4. Les réponses de l'agent dans Intercom seront renvoyées au robot.
5. L'état de la conversation est géré automatiquement entre Botpress et Intercom
. Intercom

**Note:** Lors du démarrage d'une session HITL, si l'email de l'utilisateur n'existe pas en tant que contact dans Intercom, un nouveau contact sera créé automatiquement. Si l'email existe déjà, le contact existant sera utilisé pour le processus HITL.

## Support

Pour le support, veuillez contacter l'équipe de Botpress ou vous référer à laIntercom documentation de l'APIIntercom ]intercom.

## Dépannage

### Problèmes courants

1. Webhook ne reçoit pas d'événements** : Assurez-vous que l'URL de votre webhook est publiquement accessible et correctement configurée.
2. **Erreurs d'authentification** : Vérifiez que votre jeton d'accès est correct et qu'il dispose des autorisations requises.
3. **Les messages ne sont pas synchronisés** : Vérifiez que la conversation a été correctement créée et que le contact existe dans Intercom
. Intercom

### Mode de débogage

Activez la journalisation de débogage dans votre configuration Botpress pour résoudre les problèmes d'intégration.