Segment

  ## Ce que c'est

Cette intégration vous permet de connecter votre bot Botpress à Segment Analytics, ce qui vous permet de mettre à jour les profils des utilisateurs, de suivre les vues des nœuds et les événements personnalisés directement dans les flux de votre bot.

## Comment ça marche

L'intégration fonctionne en utilisant des actions pour interagir avec Segment Analytics. Voici un bref aperçu des actions :

1. **Mettre à jour le profil de l'utilisateur** : Met à jour le profil d'un utilisateur avec des informations d'identification telles que l'adresse électronique et le nom.
2. **Track Node** : Permet de suivre le déclenchement d'un nœud spécifique au sein de votre robot.
3. **Track Event** : Permet de suivre des événements personnalisés avec des propriétés optionnelles définies dans la charge utile.

Ces actions sont soutenues par l'API Segment Analytics, qui utilise une clé d'écriture pour authentifier les demandes.

## Fonctionnalités d'intégration

### Actions

- **Mise à jour du profil de l'utilisateur**
  - Met à jour les informations d'identification du profil d'un utilisateur dans Segment Analytics.
  - Entrées : ID de l'utilisateur, profil de l'utilisateur (chaîne JSON facultative de métadonnées sur l'utilisateur)

- **Track Node** (Suivi du nœud)
  - Permet de savoir quand un nœud a été déclenché dans le bot.
  - Données d'entrée : ID de l'utilisateur, ID du nœud

- **Track Event** (Suivi d'un événement)
  - Suivi d'un événement personnalisé et des propriétés associées dans Segment Analytics.
  - Entrées : ID utilisateur, nom de l'événement, charge utile de l'événement (chaîne JSON facultative contenant les propriétés de l'événement).

### Configuration

- Clé d'écriture** : La clé d'écriture est nécessaire pour authentifier les demandes adressées à Segment Analytics. Après avoir créé une source, vous pouvez générer une clé d'écriture en allant dans Sources -> API Keys -> Settings -> Write Key.

## Instructions de configuration

#### Segment Configuration de l'analyse

1. Connectez-vous à votre tableau de bord Segment Analytics.
2. Créez une nouvelle source pour recevoir vos événements Botpress .
3. Générez une nouvelle clé d'écriture en suivant les instructions ci-dessus. 

#### Botpress Configuration

1. Cliquez sur `Install` en haut à droite et sélectionnez votre bot.
2. Suivez les instructions pour configurer votre intégration.
3. Entrez votre clé d'écriture Segment Analytics depuis Segment Analytics Setup dans le champ `Write Key`.
4. Activez l'intégration pour sauvegarder vos paramètres.