Skip to main content

Updating Talon.One audiences via Braze

After you create an audience in Talon.One, you can add or update its members directly from Braze. To do this, create a webhook that calls the Update audiences in multiple customer profiles endpoint.

To create a webhook in Braze, you can use the Canvas feature, a workspace that allows you to set up multi-step user journeys.

Prerequisites

Setting up the integration

1

Create an API key in Talon.One

In the Campaign Manager, create a Braze-specific API key:

  1. In your Application, click Settings > Integration API Keys.

  2. Click Create API Key.

  3. In the Create API Key drawer, if you are asked for a key type, select Production.

  4. In Key name, type a name to identify the key.

  5. In Key expiration date, select a date.

  6. In Third-party integration, select Yes.

  7. From Platform, select Customer Data Platform.

  8. Click Create API Key.

  9. Click to copy the key for use.

  10. note

    You cannot view or copy the API key after closing the drawer.

We will use the API key in the Braze webhook.

2

Create a webhook in Braze

In Braze, you can create a webhook as a webhook campaign, API campaign, or Canvas component. Let's create the webhook as a Canvas component.

The webhook should call the Update audiences in multiple customer profiles endpoint in Talon.One.

To create the webhook:

  1. In Braze, create a new Canvas using the Canvas Flow editor.

  2. When you create a message, select Webhook with a blank template as the messaging channel.

  3. In Webhook URL, enter https://integration.talon.one/cdp/customer_profiles/audiences.

  4. In HTTP method, select PUT.

  5. In Request Body, select Raw Text and add the following text, where YOUR_AUDIENCE_ID is the ID of the audience in Talon.One to update.

    tip
    • Your audience ID is displayed on the Audience page of the Campaign Manager.
    • Ensure there are brackets around the audience ID. Example: [53].
    {
    "data": [
    {
    "adds": [YOUR_AUDIENCE_ID],
    "customerProfileId": "{{${user_id}}}"
    }
    ]
    }
  6. In Request headers, click Add New Header and add the following key-value pairs:

    • Authorization: ApiKey-v1 YOUR_API_KEY, where YOUR_API_KEY is the API key you created.
    • customer-data-platform-name: Braze
    • destination-hostname: The base URL of your Talon.One deployment, for example, mycompany.europe-west1.talon.one.
  7. Click the Test tab, select an existing user, and click Send test.
    The endpoint returns 204 No Content, and your audience in Talon.One is updated accordingly.

  8. Click Done.