Braze
How to integrate Braze with SEEN
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
- 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.
- Request headers
- Authorization → Token {token}
- Content-Type → application/json
https://api.seen.io/v1/campaigns/{campaign_slug}/receivers/
You will receive your campaign_slug from SEEN to call the correct endpoint.
[ { "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.
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”.
Did this answer your question?
😞
😐
🤩
Last updated on September 18, 2024