Segment

  ## Cos'è

Questa integrazione consente di collegare il bot Botpress con Segment Analytics, permettendo di aggiornare i profili degli utenti, tracciare le visualizzazioni dei nodi e gli eventi personalizzati direttamente nei flussi del bot.

## Come funziona

L'integrazione funziona utilizzando le azioni per interagire con Segment Analytics. Ecco una breve panoramica delle azioni:

1. **Aggiornamento del profilo utente**: Aggiorna il profilo di un utente con informazioni identificative come l'e-mail e il nome.
2. **Traccia nodo**: Traccia quando viene attivato un nodo specifico all'interno del bot.
3. **Traccia evento**: Traccia gli eventi personalizzati con proprietà opzionali definite nel payload.

Queste azioni sono supportate dall'API di Segment Analytics, che utilizza una chiave di scrittura per autenticare le richieste.

## Caratteristiche dell'integrazione

### Azioni

- **Aggiornamento del profilo dell'utente**
  - Aggiorna le informazioni di identificazione del profilo di un utente in Segment Analytics.
  - Ingressi: ID utente, Profilo utente (stringa JSON opzionale di metadati dell'utente)

- **Traccia il nodo**
  - Traccia quando un nodo è stato attivato all'interno del bot.
  - Ingressi: ID utente, ID nodo

- Traccia evento**
  - Traccia un evento personalizzato e le proprietà associate in Segment Analytics.
  - Ingressi: ID utente, Nome evento, Payload dell'evento (stringa JSON opzionale delle proprietà dell'evento).

### Configurazione

- Chiave di scrittura**: La chiave di scrittura è necessaria per autenticare le richieste a Segment Analytics. Dopo aver creato una sorgente, è possibile generare una chiave di scrittura andando in Sorgenti -> Chiavi API -> Impostazioni -> Chiave di scrittura.

## Istruzioni per l'installazione

#### Segment Impostazione di Analytics

1. Accedere alla dashboard di Segment Analytics.
2. Creare una nuova fonte per ricevere gli eventi di Botpress .
3. Generare una nuova chiave di scrittura seguendo le istruzioni precedenti. 

#### Botpress Impostazione

1. Fare clic su `Install` in alto a destra e selezionare il bot.
2. Seguire le istruzioni a comparsa per configurare l'integrazione.
3. Inserire la chiave di scrittura di Segment Analytics dalla configurazione di Segment Analytics nel campo `Write Key`.
4. Attivare l'integrazione per salvare le impostazioni.