> For the complete documentation index, see [llms.txt](https://docs.askyazi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.askyazi.com/reach-participants/send-history-and-statuses.md).

# Send history and statuses

Read Send History for broadcasts and reminders, understand each delivery and study status, and fix common failures.

After you send a broadcast or a reminder, Send History shows what happened to every message: who it reached, who read it, who started and who did not get it, and why. Use it to check a send, reconcile numbers for a client, or work out why someone says they never got an invite.

{% hint style="info" %}
**In short:** open **View broadcast history** on a study's **Share** tab, or the clock icon on **Scheduled Messages**. "Accepted by WhatsApp" means WhatsApp took the message, not that it reached the phone. Delivered and Read come later. Failed messages show a plain-English reason. A "Not delivered" warning means retrying will not help: share the link another way.
{% endhint %}

## Where to find it

* **For every broadcast in your organisation:** **Broadcast Messages**, then the **Send History** tab.
* **For a study:** **Share** tab, then **View broadcast history**. You see the funnel for all sends linked to the study, and each send and its batches below.
* **For a scheduled send or reminder schedule:** **Scheduled Messages**, then the clock icon in **Actions**.
* **For one person:** click the participant on the **Share** tab. Failed invites show the reason in plain English in their panel, and their transcript shows the broadcast exactly as WhatsApp displayed it.

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FUxjykTM5AgYebpBxAR9c%2Fbroadcast-history-stats.webp?alt=media&amp;token=d7c3ca0a-f3aa-4fb2-bde4-cc78f864feab" alt="Broadcast history for a study showing total sent, delivery rate and start rate per batch"><figcaption></figcaption></figure>

Right after you send, the results screen shows the send as **Accepted by WhatsApp**, with **Successful**, **Failed** and **Total** recipient lists you can search, sort and download as CSV.

## The Send History table

On **Broadcast Messages > Send History**, each row is one send, with the columns **Broadcast**, **Sent**, **Delivered**, **Read**, **Opted In**, **Opted Out**, **Started**, **Failed**, **Pending** and **Send Date**.

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FStdKaO2XDnEnsDoOZ2Ri%2Ffs-send-history.webp?alt=media&amp;token=5faa35d8-6eab-491e-b7d6-45469492f26b" alt="Broadcast Messages > Send History: sent, delivered, read, opted in, opted out, started, failed and pending for every send"><figcaption></figcaption></figure>

Click a row to open **Broadcast detail**. It shows the template name, date and batch; cards for **SENT**, **DELIVERED**, **READ**, **OPTED IN**, **STARTED** and **COMPLETED**; chips for **Opted out**, **Failed** and **Pending**; and a recipient table with **Phone Number**, **Latest Status**, **Failure Reason** and **Timestamp**. Use **Download CSV** to take the list away.

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FYBqMbgGFpeFRU0PC8GQX%2Fbroadcast-detail.webp?alt=media&amp;token=60bc2e01-7418-4253-97c9-a2ed1dfc0d4c" alt="Broadcast detail with sent, delivered, read, opted in, started and completed totals, and each recipient&#x27;s latest status and failure reason"><figcaption></figcaption></figure>

{% hint style="info" %}
**Why the cards and the table do not add up.** The cards count every recipient who ever reached a stage, so one person who was delivered, read and started counts in all three. The table shows each person once, with their current status only. Both are correct.
{% endhint %}

## Delivery statuses

These come from WhatsApp and describe the message itself.

| Status                          | What it means                                                                                                                                                    |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Accepted by WhatsApp** / Sent | WhatsApp accepted the message for delivery. It has not necessarily reached the phone yet. Yazi only counts a message as sent once WhatsApp has accepted it.      |
| **Pending** / **Awaiting**      | Queued, or sent and waiting for WhatsApp's delivery receipt.                                                                                                     |
| **Delivered**                   | The message reached the participant's phone.                                                                                                                     |
| **Read**                        | The participant opened it. People who switched off read receipts never show as Read, even if they read it.                                                       |
| **No receipt** / Unconfirmed    | WhatsApp accepted the message but never confirmed delivery or failure. After 24 hours Yazi stops waiting and marks it this way. The message very likely arrived. |
| **Failed**                      | WhatsApp refused or could not deliver the message. The reason is shown. You are not charged for it.                                                              |
| **Not delivered** warning       | WhatsApp will not deliver to this person. Retrying will not help. Share the study link through another channel instead.                                          |

## Study statuses

These come from the study and describe what the person did after receiving the message.

| Status        | What it means                                                                  |
| ------------- | ------------------------------------------------------------------------------ |
| **Opted in**  | They tapped the start button on the invite.                                    |
| **Started**   | They answered at least one question.                                           |
| **Completed** | They reached the end of the activity.                                          |
| **Opted out** | They tapped **Opt-out**. You can no longer broadcast to them from this number. |

Started and Completed only show for the whole study, not for a single batch, because a study-wide count against one batch's recipients would mislead.

For statuses on the Participants tab (In survey, Survey done, Screened out and so on), see [Participants tab](https://docs.askyazi.com/monitor-fieldwork/participants-tab.md).

## Common failure reasons and what to do

| Reason (as shown, roughly)                    | What it means                                                                                                                   | What to do                                                                                                                                            |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| This number is not registered on WhatsApp     | No WhatsApp account on that number, or the number is wrong                                                                      | Check the number and its country code. Ask for a WhatsApp number, or reach the person another way.                                                    |
| Message undeliverable / invalid number        | Badly formatted or non-existent number                                                                                          | Check for a missing country code or extra characters.                                                                                                 |
| Not delivered to maintain a healthy ecosystem | Meta chose not to deliver a marketing message, usually because the person gets many marketing messages or has opted out of them | Do not resend. Use a utility template if it qualifies, or share the link another way.                                                                 |
| Rate limit / throttled                        | Too many messages too fast, or over your daily limit                                                                            | Use smaller batches with gaps. Get your business verified to raise the limit.                                                                         |
| Billing or payment problem                    | Your Meta account has no valid payment method or is blocked for billing                                                         | Fix the payment method in Meta Business Manager. See [Meta payment method](https://docs.askyazi.com/set-up-whatsapp/add-a-payment-method-in-meta.md). |
| Template paused or not approved               | Meta paused the template for low quality, or it is not approved yet                                                             | Check the template status under **Broadcast Messages**. Create a new template if it was paused.                                                       |
| Recipient has blocked your number             | The person blocked you                                                                                                          | They cannot be reached from this number.                                                                                                              |
| Missing variable / empty parameter            | A variable in the template had no value for this person                                                                         | Check that every mapped column has a value, then resend to those people.                                                                              |

Exact wording comes from WhatsApp and can vary.

## Reading the numbers

* **A shortfall is normal.** Some numbers are not on WhatsApp, some people have opted out, and Meta limits marketing messages. When a list underperforms, look at two numbers: how many failed as not on WhatsApp, and how many were refused for your daily limit.
* **Delivered but not started** usually means the message did not persuade. Try a clearer reason to take part, a better time of day, or a reminder.
* **Started but not completed** is a drop-off inside the study. Use [Reminders](https://docs.askyazi.com/reach-participants/reminders.md).
* **"Some people got nothing".** Check each person's status before assuming a platform fault. Phones that are off show as delivered later. A single failure is usually about that number.

## Limits and things to know

* Failed messages are not resent automatically. Resending to a number that is not on WhatsApp or has blocked you fails again.
* Stats update as receipts arrive. On large sends, give it a few minutes and refresh.
* Send history for scheduled sends needs permission to export personal data. Organisations that hide phone numbers see participant IDs.
* Stats are per WhatsApp number. If you use several numbers, each number's sends are separate.

## Related

* [Send a broadcast](https://docs.askyazi.com/reach-participants/send-a-broadcast.md)
* [Scheduled Messages](https://docs.askyazi.com/reach-participants/scheduled-messages.md)
* [WhatsApp costs and the 24-hour window](https://docs.askyazi.com/reach-participants/whatsapp-costs-and-the-24-hour-window.md)
* [Number health and limits](https://docs.askyazi.com/set-up-whatsapp/number-health-and-limits.md)
* [Troubleshooting](https://docs.askyazi.com/help/troubleshooting.md)
