> ## Documentation Index
> Fetch the complete documentation index at: https://help.chatarmin.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Chatarmin × Braze Integration

> Verbinde Braze und synchronisiere WhatsApp-Einwilligungen, Kontaktdaten, Tags, Segmente und Flow-Aktivitäten.

Die Braze-Integration hält WhatsApp-Kundendaten in Chatarmin mit Profilen, Segmenten und Kampagnen in Braze synchron. Chatarmin übernimmt die WhatsApp-Kommunikation, während Braze dein kanalübergreifendes Customer Engagement unterstützt.

## Braze verbinden

<Steps>
  <Step title="Braze REST API Key erstellen">
    Öffne in Braze **Settings → APIs and Identifiers** und erstelle einen REST API Key mit diesen Berechtigungen:

    * `users.track`
    * `users.export.ids`
    * `users.identify`
    * `users.export.segment`
    * `segments.list`
    * `custom_attributes.get`
  </Step>

  <Step title="Zugangsdaten in Chatarmin eingeben">
    Öffne in Chatarmin **Integrationen → Braze → Verbinden**. Gib den REST API Key und deinen Braze REST Endpoint ein. Ein EU-Endpoint kann zum Beispiel `https://rest.fra-02.braze.eu` sein.

    <Frame>
      <img src="https://mintcdn.com/chatarmin-help-center/_nGviOAG-8nfZQo8/images/integrations/braze-connect.png?fit=max&auto=format&n=_nGviOAG-8nfZQo8&q=85&s=bea68fc08a4d749c8c133dc97a3c8451" alt="Braze-Verbindungsseite mit Feldern für den REST Endpoint und REST API Key" width="1024" height="510" data-path="images/integrations/braze-connect.png" />
    </Frame>
  </Step>

  <Step title="Einwilligungssynchronisierung konfigurieren">
    Nachdem Chatarmin die Verbindung geprüft und deine Braze-Segmente geladen hat, kannst du die automatische Synchronisierung der WhatsApp-Einwilligung aktivieren. Das standardmäßig verwendete Braze-Attribut ist `chatarmin_whatsapp` und kann geändert werden.
  </Step>
</Steps>

Du kannst die Einwilligungseinstellung später ändern oder Braze auf derselben Integrationsseite trennen.

<Frame>
  <img src="https://mintcdn.com/chatarmin-help-center/_nGviOAG-8nfZQo8/images/integrations/braze-consent-sync.png?fit=max&auto=format&n=_nGviOAG-8nfZQo8&q=85&s=a5891fac088bbd2cc5554f28d5bc8049" alt="Verbundene Braze-Integration mit aktivierter Einwilligungssynchronisierung für das Attribut chatarmin_whatsapp" width="1024" height="510" data-path="images/integrations/braze-consent-sync.png" />
</Frame>

## Kontakte synchronisieren

Wenn sich ein Kontakt in Chatarmin ändert, kann die Integration das passende Braze-Profil aktualisieren. Die Zuordnung erfolgt über Telefonnummer, E-Mail-Adresse oder die externe Kontakt-ID.

Folgende Daten werden synchronisiert:

* WhatsApp-Einwilligung in dein konfiguriertes Attribut, zum Beispiel `chatarmin_whatsapp`
* Chatarmin-Tags in `Chatarmin_Tags` und die Anzahl in `Chatarmin_Tag_Count`
* Benutzerdefinierte Kontakteigenschaften mit dem Präfix `chatarmin_`
* Geburtstag in `chatarmin_birthday`
* Vorname, Nachname, E-Mail-Adresse und Telefonnummer in die Standardfelder von Braze

Wenn Braze einen Namen oder eine E-Mail-Adresse enthält, die in Chatarmin fehlt, kann Chatarmin diese Information bei der Zuordnung und Synchronisierung verwenden.

<Tip>
  Verwende pro Chatarmin-Kontakt nur ein Braze-Profil. Führe alte oder durch Tests entstandene Duplikate in Braze zusammen, um falsche Zuordnungen zu vermeiden.
</Tip>

## Braze-Segmente für Zielgruppen verwenden

Öffne in Chatarmin **Zielgruppe → Segmente** und füge einen Filter für **Braze-Segment** hinzu. Du kannst Kontakte auswählen, die:

* in mindestens einem ausgewählten Braze-Segment sind
* in allen ausgewählten Braze-Segmenten sind
* in keinem ausgewählten Braze-Segment sind
* nicht in allen ausgewählten Braze-Segmenten sind

Chatarmin lädt die verfügbaren Segmente direkt aus deinem Braze-Konto.

<Frame>
  <img src="https://mintcdn.com/chatarmin-help-center/_nGviOAG-8nfZQo8/images/integrations/braze-audience-segment.png?fit=max&auto=format&n=_nGviOAG-8nfZQo8&q=85&s=ad38fb59300f826fafe7e11a42427086" alt="Chatarmin-Segment-Builder mit einem Filter für die Braze-Segmentzugehörigkeit" width="1024" height="510" data-path="images/integrations/braze-audience-segment.png" />
</Frame>

Die Berechnung der Segmentzugehörigkeit kann einige Minuten dauern. Bei längeren Berechnungen siehst du einen Verarbeitungsstatus. Dauert die Berechnung länger als 20 Sekunden, sendet Chatarmin nach Abschluss eine E-Mail.

## Braze in Flows verwenden

### Braze-Eigenschaften aktualisieren

Füge die Aktion **Update Braze Properties** hinzu, um benutzerdefinierte Attribute im Braze-Profil zu aktualisieren. So kannst du zum Beispiel Sportpräferenzen, Geburtstage oder andere im Flow erfasste Daten speichern.

<Frame>
  <img src="https://mintcdn.com/chatarmin-help-center/_nGviOAG-8nfZQo8/images/integrations/braze-update-properties.png?fit=max&auto=format&n=_nGviOAG-8nfZQo8&q=85&s=06c453502cfca31f971b08425fa9d98b" alt="Flow-Aktion Update Braze Properties, die das Attribut channel auf WhatsApp setzt" width="1024" height="360" data-path="images/integrations/braze-update-properties.png" />
</Frame>

### Mit Braze-Daten verzweigen

Verwende einen If/Else-Schritt mit:

* **Braze Properties**, um anhand eines Attributs wie `chatarmin_whatsapp` zu verzweigen
* **Braze Segments**, um zu prüfen, ob ein Kontakt in einem ausgewählten Segment ist

<Frame>
  <img src="https://mintcdn.com/chatarmin-help-center/_nGviOAG-8nfZQo8/images/integrations/braze-flow-property-condition.png?fit=max&auto=format&n=_nGviOAG-8nfZQo8&q=85&s=047638cd3f199e46db27bc9ab5590bed" alt="Chatarmin If/Else-Schritt mit einer Bedingung für eine Braze-Profileigenschaft" width="1024" height="422" data-path="images/integrations/braze-flow-property-condition.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/chatarmin-help-center/_nGviOAG-8nfZQo8/images/integrations/braze-flow-segment-condition.png?fit=max&auto=format&n=_nGviOAG-8nfZQo8&q=85&s=db6b083436a16841327f9997b8170cc5" alt="Chatarmin If/Else-Schritt zur Prüfung der Braze-Segmentzugehörigkeit" width="1024" height="430" data-path="images/integrations/braze-flow-segment-condition.png" />
</Frame>

Chatarmin lädt verfügbare Attribute und Segmente aus deinem Braze-Konto. Wenn Attribute nicht geladen werden können, stehen weiterhin die Chatarmin-Standardattribute zur Verfügung.

### Chatarmin-Aktivitäten in Braze verfolgen

Chatarmin sendet diese Events an das Braze-Benutzerprofil:

* `Chatarmin - Flow enrolled`, wenn ein Kontakt einen Chatarmin-Flow startet
* `Chatarmin - Updated Profile`, wenn Chatarmin das Profil synchronisiert oder aktualisiert

Du kannst diese Events in Braze für Reports, Analysen, Segmente und Kampagnen verwenden.

## Beispielablauf

1. Verbinde Braze mit deinem REST API Key und Endpoint.
2. Ein Kontakt erteilt in Chatarmin seine WhatsApp-Einwilligung. Der Status wird mit Braze synchronisiert.
3. Chatarmin-Tags erscheinen in Braze als `Chatarmin_Tags`.
4. Erstelle in Chatarmin eine Zielgruppe aus dem Braze-Segment **Lapsed Users** und Kontakten mit WhatsApp-Einwilligung.
5. Sende eine WhatsApp-Kampagne oder starte einen Flow für diese Zielgruppe.
6. Verzweige den Flow anhand eines Braze-Segments oder -Attributs.
7. Aktualisiere ein benutzerdefiniertes Braze-Attribut aus dem Flow.
8. Prüfe Flow-Events und aktualisierte Attribute im Braze-Profil.

## Häufig gestellte Fragen

### Brauche ich einen Entwickler für die Einrichtung?

Normalerweise nicht. Du brauchst einen Braze REST API Key mit den erforderlichen Berechtigungen. Eventuell muss dein Braze-Administrator oder IT-Team den Key erstellen.

### Erfolgt die Synchronisierung sofort?

Kontaktänderungen werden kurz nach der Änderung in Chatarmin synchronisiert. Die Berechnung von Braze-Segmenten kann einige Minuten dauern.

### Kann ich WhatsApp-Nachrichten an ein Braze-Segment senden?

Ja. Erstelle in Chatarmin ein Segment mit einem Braze-Segmentfilter und verwende es anschließend in einer Kampagne oder einem Flow.

### Zeigt Braze WhatsApp-Aktivitäten an?

Ja. Braze erhält Events für Flow-Starts und Profilaktualisierungen sowie die synchronisierten Profilattribute.

### Funktioniert die Integration mit Braze EU?

Ja. Verwende den REST Endpoint deiner Braze-Instanz, zum Beispiel `https://rest.fra-02.braze.eu`.