Skip to content

Message archiving

Message archiving lets you save a copy of messages sent to users for archival or compliance purposes to your AWS S3 bucket, Azure Blob Storage container or Google Cloud Storage bucket.

Message archiving is available as an add-on feature. To get started with message archiving, reach out to your Braze customer success manager.

Overview

When this feature is turned on, if you have connected a cloud storage bucket to Braze and marked it as the default data export destination, Braze will write a gzipped JSON file to your cloud storage bucket for each message sent to a user through your selected channels (email, SMS, or push).

This file will contain the fields defined under File references and reflect the final templated messages sent to the user. Any templated values defined in your campaign (for example, {{${first_name}}}) will show the final value that the user received based on their profile information. This will allow you to retain a copy of the message sent to satisfy compliance, audit, or customer support requirements.

If you setup credentials for multiple cloud storage providers, Message Archiving will only export to the one explicitly marked as the default data export destination. If no explicit default is provided and an AWS S3 bucket is connected, Message Archiving will upload to that bucket.

The JSON will be saved in your storage bucket using the following key structure:

sent_messages/channel/(one of: md5, e164 phone number, email, or push token)/(campaign_id OR canvas_step_id)/DispatchId.json.gz

An example file may look like this:

sent_messages/email/819baa08d8d7e77e19d4666f5fc6050b/ee965cb2-8934-4b0a-acf1-91c899c2f915/651fd10b282850b39e1169c13975234b.json.gz

Setting up message archiving

This section describes how to set up message archiving for your workspace. Before proceeding, confirm that your company has purchased and turned on message archiving.

Step 1: Connect a cloud storage bucket

If you haven’t done so already, connect a cloud storage bucket to Braze. For steps, refer to our partner documentation on Amazon S3, Azure Blob Storage or Google Cloud Storage.

Step 2: Select channels for message archiving

The Message Archiving settings page controls which channels will save a copy of sent messages to your cloud storage bucket.

To select channels:

  1. Go to Settings > Message Archiving.
  2. Select your channels.
  3. Click Save changes.

The Message Archiving page has three channels to select: Email, Push, and SMS.

File references

The following are references of the JSON payload delivered to your cloud storage bucket each time a message is sent. Refer to our code example repository for message archive sample files.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
{
  "version" : 1 //numerical version of the json structure
  "to": PhoneNumber, ("+15555555555"),
  "body": Body ("Hi there!"),
  "subscription_group": SubscriptionGroupExternalId,
  "provider": StringOfProviderName,
  "media_urls": ArrayOfString,
  "sent_at": UnixTimestamp,
  "dispatch_id": DispatchIdFromBraze,
  "campaign_id": CampaignApiKey, // may not be available
  "canvas_id": CanvasApiKey, // may not be available
  "canvas_step_id": CanvasStepID, // may not be available
  "canvas_variation_id" : CanvasVariationId, // may not be available
  "message_variation_id": MessagVariationId, // may not be available
  "user_id": String,
  "campaign_name": String, // will only be available if the message is from a campaign
  "canvas_name": String, // will only be available if the message is a from Canvas
  "canvas_step_name": String, // will only be available if the message is from a Canvas
  "external_id": String
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
  "version" : 1, //numerical version of the json structure
  "to": PushToken,
  "payload": JsonOfEntirePushPayload,
  "platform": ios/android/web/kindle,
  "app_id": ApiKeyOfApp,
  "sent_at": UnixTimestamp,
  "dispatch_id": DispatchIdFromBraze,
  "campaign_id": CampaignApiKey, // may not be available
  "canvas_id": CanvasApiKey, // may not be available
  "canvas_step_id": CanvasStepID, // may not be available
  "canvas_variation_id" : CanvasVariationId, // may not be available
  "message_variation_id": MessagVariationId, // may not be available
  "user_id": String,
  "campaign_name": String, // will only be available if the message is from a campaign
  "canvas_name": String, // will only be available if the message is a from Canvas
  "canvas_step_name": String, // will only be available if the message is from a Canvas
  "external_id": String
}

Frequently asked questions

What templating is not included in the payload?

Modifications done after the message leaves Braze will not be reflected in the file saved to your cloud storage bucket. This will include modifications our mail delivery partners make, like wrapping links for click tracking and inserting tracking pixels.

What are messages under the “unassociated” value in the campaign path?

When a message is sent outside of a campaign or Canvas, the campaign ID in the file name will be “unassociated”. This will happen when you send test messages from the dashboard, when Braze sends SMS auto-responses, or when messages sent through the API do not specify a campaign ID.

How do I find more information about this send?

You can use either the external_id or dispatch_id in conjunction with the user_id to cross-reference the templated message with our Currents data to find more information like the timestamp it was delivered, whether or not the user opened or clicked the message, and more.

How are retries handled?

Should your cloud storage bucket be unreachable, Braze will retry up to three times with a backoff jitter. AWS S3 rate limit retries are automatically handled by Braze.

What happens if my credentials are invalid?

If your cloud storage credentials become invalid at any point, Braze will not be able to save any messages to your cloud storage bucket, and those messages will be lost. We recommend configuring the AWS credentials errors notification preference to ensure you receive alerts for any credentials issues.

Why does my archive file’s “sent_at” timestamp differ slightly from the sent timestamp in Currents?

The rendered copy is uploaded immediately before sending the message to the end user. Because of cloud storage upload times, there may be a delay of a few seconds between the “sent_at” timestamp in the rendered copy versus the actual time the send occurs.

HOW HELPFUL WAS THIS PAGE?
New Stuff!