# Broadcast Records

Broadcast Records let you track which users have received from your broadcasts, including the receipt status for every single user who has received it.

<figure><img src="/files/HKYjFJQLk2vmMSQXFMsU" alt=""><figcaption><p>Broadcast Records Dashboard</p></figcaption></figure>

Every time you publish a broadcast, BotDistrikt tracks a **receipt** - also known as a Broadcast Record, for each user. For each record, BotDistrikt tracks

* The identity of the user who received it
* The date and time that the user received it
* The status of the receipt, whether it was **completed** or an **error**
* If the broadcast status is **error**
  * The accompanying error message explaining why there was an error
* Latency - the difference between the time the broadcast was scheduled and the time the user received it

### Receipt of what a user received

<figure><img src="/files/kb7KawuZpE9epSyxDoK0" alt=""><figcaption><p>Broadcast Records Dashboard</p></figcaption></figure>

Hover over a record to see what a user received during the broadcast. Each user receives a unique personalized message based on the variables you use in the message.

Use the Broadcast Records page to:

* Filter Broadcast Records
* Export to CSV

### Filtering Broadcast Records

Use the Filters on the top of the page to filter records based on several fields. Each field has a specific filter use case.

<figure><img src="/files/0EiMz5NsorSUsfrSIYgm" alt=""><figcaption><p>Broadcast Tab Filter Options</p></figcaption></figure>

<table><thead><tr><th width="177.7379404721177">Field</th><th>Use Case</th></tr></thead><tbody><tr><td>ID</td><td>Finds all records from a specific ID</td></tr><tr><td>Broadcast ID</td><td>Find all records a specific broadcast ID</td></tr><tr><td>User ID</td><td>Finds all records from a specific user ID</td></tr><tr><td>Story ID</td><td>Find all records publishing a broadcast of a specific story ID</td></tr><tr><td>Story Name</td><td>Find all records publishing a broadcast of a specific story, filterable by the story's name</td></tr><tr><td>User Name</td><td>Find all broadcast sent to a specific user, filterable by the user's name </td></tr><tr><td>Status</td><td>Find all broadcast records of a status <strong>completed</strong> or <strong>error</strong></td></tr><tr><td>Message</td><td>Find all broadcast records of status <strong>error</strong> with a specific of filterable error message</td></tr><tr><td>Recorded At</td><td>Find all records received before or after a specific date and time</td></tr><tr><td>Number of Responses</td><td><p>Sometimes when a broadcast publishes a story that uses only 1 webhook to get a dynamically generated response, the webhook might return no responses for a specific user. </p><p>Filter by Number of Responses greater than 0, to filter only those users who received a message</p></td></tr></tbody></table>

### Exporting  as CSV

Filter broadcast records by clicking on add filter and selecting the appropriate attribute and function for the search parameter. To export filtered records, click on Select Action and Export rows to CSV.

<figure><img src="/files/g3eMGFy8Cy89ImTnno6D" alt=""><figcaption><p>Example of Exporting Broadcast</p></figcaption></figure>

**Export to CSV** will generate a .csv file with the following fields:

<table><thead><tr><th width="260">Field</th><th>Description</th></tr></thead><tbody><tr><td>ID</td><td>An identifier based on the unique Broadcast ID.</td></tr><tr><td>User ID</td><td>A unique identifier assigned to the user.</td></tr><tr><td>User</td><td>The display name or alias of the user.</td></tr><tr><td>Received Broadcast ID</td><td>The unique identifier of the broadcast received by the user.</td></tr><tr><td>Broadcast Time</td><td>The timestamp of when the broadcast was sent.</td></tr><tr><td>Story ID</td><td>A unique identifier for the story associated with the interaction.</td></tr><tr><td>Story Name</td><td>The name or title of the story.</td></tr><tr><td>Status</td><td>Indicates the current state of the interaction.</td></tr><tr><td>Message</td><td>The content of the message exchanged during the interaction.</td></tr><tr><td>Created At</td><td>The timestamp of the interaction.</td></tr></tbody></table>

{% hint style="warning" %}
BotDistrikt's broadcast functionality has a default push configuration of

* 5 Maximum Retries
* 0.1s Backoff

View up to 5 Broadcast Records with errors for the same user because the platform attempted to retry a failed broadcast to the user 5 times&#x20;
{% endhint %}

{% hint style="info" %}
For **Enterprise** customers, the push configuration is customizable.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.botdistrikt.com/features/inbox/broadcast-records.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
