> ## 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

> Connect Braze to sync WhatsApp consent, contact data, tags, segments, and Flow activity.

The Braze integration keeps WhatsApp customer data in Chatarmin aligned with profiles, segments, and campaigns in Braze. Chatarmin handles WhatsApp communication while Braze supports your broader customer engagement.

## Connect Braze

<Steps>
  <Step title="Create a Braze REST API key">
    In Braze, open **Settings → APIs and Identifiers** and create a REST API key with these permissions:

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

  <Step title="Enter your credentials in Chatarmin">
    In Chatarmin, open **Integrations → Braze → Connect**. Enter the REST API key and your Braze REST endpoint. For example, an EU endpoint can be `https://rest.fra-02.braze.eu`.

    <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 connection page with fields for the REST endpoint and REST API key" width="1024" height="510" data-path="images/integrations/braze-connect.png" />
    </Frame>
  </Step>

  <Step title="Configure consent sync">
    After Chatarmin verifies the connection and loads your Braze segments, choose whether to sync WhatsApp consent automatically. You can change the Braze custom attribute used for consent; the default is `chatarmin_whatsapp`.
  </Step>
</Steps>

You can update the consent setting or disconnect Braze from the same integration page.

<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="Connected Braze integration with automatic consent sync enabled for the chatarmin_whatsapp attribute" width="1024" height="510" data-path="images/integrations/braze-consent-sync.png" />
</Frame>

## Contact sync

When a contact changes in Chatarmin, the integration can update the matching Braze profile. Chatarmin matches profiles using phone number, email address, or the contact's external ID.

The following data is synchronized:

* WhatsApp consent to your configured attribute, such as `chatarmin_whatsapp`
* Chatarmin tags to `Chatarmin_Tags` and the tag count to `Chatarmin_Tag_Count`
* Custom contact properties with the `chatarmin_` prefix
* Birthday to `chatarmin_birthday`
* First name, last name, email address, and phone number to standard Braze profile fields

If Braze has a name or email address that is missing in Chatarmin, Chatarmin can use that information when matching and synchronizing the contact.

<Tip>
  Keep one Braze profile per Chatarmin contact. Merge old or test duplicates in Braze to avoid ambiguous matches.
</Tip>

## Use Braze segments in audiences

In Chatarmin, open **Audience → Segments** and add a **Braze segment** filter. You can select contacts who are:

* in any selected Braze segment
* in all selected Braze segments
* not in any selected Braze segment
* not in all selected Braze segments

Chatarmin loads the available segment list from your Braze account.

<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 filtering contacts by Braze segment membership" width="1024" height="510" data-path="images/integrations/braze-audience-segment.png" />
</Frame>

Segment membership can take a few minutes to calculate. Long-running calculations show a processing status, and Chatarmin sends an email when a calculation taking longer than 20 seconds finishes.

## Use Braze in Flows

### Update Braze properties

Add the **Update Braze Properties** action to update custom attributes on a contact's Braze profile. For example, save a sport preference, birthday, or another custom field collected in the Flow.

<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="Update Braze Properties Flow action setting the channel attribute to WhatsApp" width="1024" height="360" data-path="images/integrations/braze-update-properties.png" />
</Frame>

### Branch with Braze data

Use an If/Else step with:

* **Braze Properties** to branch on a custom attribute, such as `chatarmin_whatsapp`
* **Braze Segments** to check whether the contact is or is not in a selected segment

<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 step branching on a Braze profile property" 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 step checking whether a contact belongs to a Braze segment" width="1024" height="430" data-path="images/integrations/braze-flow-segment-condition.png" />
</Frame>

Chatarmin loads available custom attributes and segments from your Braze account. If attributes cannot be loaded, Chatarmin still provides its default attributes.

### Track Chatarmin activity in Braze

Chatarmin sends these events to the Braze user profile:

* `Chatarmin - Flow enrolled` when a contact enters a Chatarmin Flow
* `Chatarmin - Updated Profile` when Chatarmin synchronizes or updates the profile

Use these events in Braze reporting, analytics, segments, and campaigns.

## Example journey

1. Connect Braze with your REST API key and endpoint.
2. A contact opts in to WhatsApp in Chatarmin, and consent syncs to Braze.
3. Chatarmin tags appear in Braze as `Chatarmin_Tags`.
4. Create a Chatarmin audience using the Braze segment **Lapsed Users** and WhatsApp consent.
5. Send a WhatsApp campaign or enroll the audience in a Flow.
6. Branch the Flow using a Braze segment or property.
7. Update a Braze custom attribute from the Flow.
8. Review Flow enrollment events and updated attributes on the Braze profile.

## Frequently asked questions

### Do I need a developer to connect Braze?

Usually not. You need a Braze REST API key with the required permissions. Your Braze administrator or IT team may need to create it.

### Is synchronization instant?

Contact updates synchronize shortly after they change in Chatarmin. Braze segment membership can take a few minutes to process.

### Can I send WhatsApp messages to a Braze segment?

Yes. Create a Chatarmin segment filtered by Braze segment membership, then use it in a campaign or Flow.

### Does Braze show WhatsApp activity?

Yes. Braze receives Flow enrollment and profile update events as well as the synchronized profile attributes.

### Does this work with Braze EU?

Yes. Enter the REST endpoint for your Braze instance, such as `https://rest.fra-02.braze.eu`.
