Segment

  ## Was es ist

Diese Integration ermöglicht es Ihnen, Ihren Botpress Bot mit Segment Analytics zu verbinden. So können Sie Benutzerprofile aktualisieren, Knotenansichten und benutzerdefinierte Ereignisse direkt in den Abläufen Ihres Bots verfolgen.

## Wie es funktioniert

Die Integration funktioniert durch die Verwendung von Aktionen zur Interaktion mit Segment Analytics. Hier ist ein kurzer Überblick über die Aktionen:

1. **Benutzerprofil aktualisieren**: Aktualisiert das Profil eines Benutzers mit identifizierenden Informationen wie E-Mail und Name.
2. **Knoten verfolgen**: Verfolgt, wann ein bestimmter Knoten innerhalb Ihres Bots ausgelöst wird.
3. **Ereignis verfolgen**: Verfolgt benutzerdefinierte Ereignisse mit optionalen Eigenschaften, die in der Nutzlast definiert sind.

Diese Aktionen werden von der Segment Analytics API unterstützt, die einen Schreibschlüssel zur Authentifizierung von Anfragen verwendet.

## Integrationsmerkmale

### Aktionen

- **Benutzerprofil aktualisieren**
  - Aktualisiert identifizierende Informationen eines Benutzerprofils in Segment Analytics.
  - Eingaben: Benutzer-ID, Benutzerprofil (optionaler JSON-String mit Benutzer-Metadaten)

- **Knoten verfolgen**
  - Verfolgt, wann ein Knoten innerhalb des Bots ausgelöst wurde.
  - Eingaben: Benutzer-ID, Knoten-ID

- **Ereignis verfolgen**
  - Verfolgt ein benutzerdefiniertes Ereignis und die damit verbundenen Eigenschaften in Segment Analytics.
  - Eingaben: Benutzer-ID, Ereignisname, Ereignis-Payload (optionale JSON-Zeichenkette mit Ereigniseigenschaften)

### Konfiguration

- **Schreibschlüssel**: Der Schreibschlüssel ist für die Authentifizierung von Anfragen an Segment Analytics erforderlich. Nachdem Sie eine Quelle erstellt haben, können Sie einen Schreibschlüssel generieren, indem Sie zu Quellen -> API-Schlüssel -> Einstellungen -> Schreibschlüssel gehen.

## Anweisungen zur Einrichtung

#### Segment Analytics-Einrichtung

1. Melden Sie sich bei Ihrem Segment Analytics Dashboard an.
2. Erstellen Sie eine neue Quelle, um Ihre Botpress Ereignisse zu empfangen.
3. Generieren Sie einen neuen Schreibschlüssel anhand der obigen Anweisungen. 

#### Botpress Einrichtung

1. Klicken Sie oben rechts auf `Installieren` und wählen Sie Ihren Bot aus.
2. Folgen Sie den Popup-Anweisungen, um Ihre Integration zu konfigurieren.
3. Geben Sie Ihren Segment Analytics-Schreibschlüssel aus dem Segment Analytics Setup in das Feld "Schreibschlüssel" ein.
4. Aktivieren Sie die Integration, um Ihre Einstellungen zu speichern.