Braze – SEEN Documentation

In the following example, we will be sending users data to SEEN for video generation, and receiving a unique landing page link and a unique, personalised thumbnail back to Braze for distribution. This example uses a POST webhook in Braze to send data to SEEN, and data transformation to receive the data back to Braze.

If you have multiple video campaigns with SEEN, repeat the process to connect Braze with all video campaigns.

You can reach out to your Customer Success Manager at SEEN for assistance.

Send data to SEEN

Create a new Webhook Campaign in Braze.

Give your campaign a name, and follow these steps to compose your webhook:

Webhook URL

https://api.seen.io/v1/campaigns/{campaign_slug}/receivers/

You will receive your campaign_slug from SEEN to call the correct endpoint.

HTTP Method = POST

Request body = Raw Text

You can use the code below as a starting point. Use our documentation as a reference for the payload structure.

[
    {
    "first_name":"{{${first_name}}}",
    "last_name":"{{${last_name}}}",
    "email":"{{${email_address}}}",
    "customer_id":"{{${braze_id}}}"
    }
]

Remember to modify the payload depending on the personalisations in your film.

Request headers

Authorization → Token {token}

Content-Type → application/json

You will receive your Authentication Token from SEEN.

You can now test the webhook with a user by switching to the “Test” tab.

If everything works as intended, you can proceed to finish the webhook setup.

Receive data back from SEEN

Create new Custom Attribute fields for “landing_page_url” and “email_thumbnail_url”. These are the two attributes we will be using in this example.

Open “Data Transformation” tool under “Data Settings”, and click on “Create transformation”.

Give your transformation a name, and choose:

“Start from scratch”

Destination → POST: Track users

Share your Webhook URL with SEEN.

You can use the code below as the starting point for the transformation:

let brazecall = {
  "attributes": [
    {
      "braze_id": payload.customer_id,
      "_update_existing_only": true,
      "landing_page_url": payload.landing_page_url,
      "email_thumbnail_url": payload.email_thumbnail_url
    }
  ]
};
return brazecall;

If you want to include other data, make sure to include those as well. Remember to discuss with SEEN as well so that the callback payload includes all needed fields.

Send a test payload to the provided endpoint. If you want to use the payload defined in our documentation, you can send this yourself via Postman or another similar service:

{
        "customer_id": "101",
        "campaign_slug": "onboarding",
        "landing_page_url": "your.subdomain.com/v/12345",
        "video_url": "https://motions.seen.io/298abdcf-1f0f-46e7-9c26-a35b4c1e83cc/d3c1dffdf063986ad521a63e3e68fd7d1100c90a/output.m3u8",
        "thumbnail_url": "https://motions.seen.io/298abdcf-1f0f-46e7-9c26-a35b4c1e83cc/d3c1dffdf063986ad521a63e3e68fd7d1100c90a/thumbnail.jpg",
        "email_thumbnail_url": "https://motions.seen.io/298abdcf-1f0f-46e7-9c26-a35b4c1e83cc/d3c1dffdf063986ad521a63e3e68fd7d1100c90a/email_thumbnail.jpg"
       
}

Click “Validate” to make sure everything works as intended.

If everything worked as intended, click “Save” and “Activate”.