> 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/scheduled-messages.md).

# Scheduled Messages

Manage scheduled broadcasts, reminder schedules and event-triggered sends on the Scheduled Messages page.

**Scheduled Messages** (in the left navigation) lists every broadcast that sends later or on a repeat: scheduled invites, reminder schedules and sends fired by your own systems through the API. Use it to check progress, pause or edit a schedule, and see exactly who was messaged.

{% hint style="info" %}
**In short:** there are three schedule types: **Reminder**, **Event Triggered** and **CSV Upload Broadcast**. Each row shows its linked study and progress, including failures. The clock icon in **Actions** opens its Send history. A schedule that cannot work is refused when you save it.
{% endhint %}

## The three schedule types

Click **Add New Schedule** and pick a type.

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FVrwUSM7NHvhKCBXZWdHu%2Fschedule-types.webp?alt=media&amp;token=b60ce4c6-9ad4-40b1-9bb9-de54399114a3" alt="New Schedule: choose Reminder, Event Triggered or CSV Upload Broadcast"><figcaption></figcaption></figure>

| Type                     | What it does                                                                                     | Typical use                                          |
| ------------------------ | ------------------------------------------------------------------------------------------------ | ---------------------------------------------------- |
| **CSV Upload Broadcast** | Sends a template to the numbers in a file you upload, on the days, times and batch sizes you set | A large invite spread over several days              |
| **Reminder**             | Repeatedly messages people in a study who have not finished, on a frequency you set              | Reminding on a fixed repeat; see the note below      |
| **Event Triggered**      | Waits for your system to call the Yazi API, then sends the template to that person               | Invite a customer after a purchase or a support call |

{% hint style="info" %}
For reminding participants in a study, use **Reminders** on the study's **Share** tab. It targets people by how far they got, resumes them at the exact question and shows who will get a message before you switch it on. See [Reminders](https://docs.askyazi.com/reach-participants/reminders.md).
{% endhint %}

### CSV Upload Broadcast

You upload the list, choose the template, map its variables to your columns and choose the study the start button opens. Then set the start date, the days it may send, the sending window, the batch size and the gap between batches.

The study on the start button is only where people land when they tap it. It is normally empty before the send, and that is fine.

### Reminder schedule

Choose the study, the template, how often it repeats and when. Optional controls: a start date, which days of the week it may send, and a sending window (for example 09:00 to 17:00 so nobody is messaged late at night). A reminder pointed at a study with nobody in it sends nothing, and the form warns you.

### Event Triggered

The schedule summary shows a **Configuration ID** and **Organisation ID** to copy into your integration. Your system then calls the Yazi API with the person's number and any variables. See [Event triggers API](https://docs.askyazi.com/integrations-and-api/event-triggers-api.md).

## The table

* **Linked Campaign / Study:** which study the messages point to.
* **Progress:** messages sent against the total, with a red "N failed" beside the count when some failed.
* **Actions:** the clock icon for Send history, next to the other actions for that schedule.

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2F9kAb52XH9rDExNonxvym%2Ffs-scheduled-messages.webp?alt=media&amp;token=3743a31d-7fda-4073-ba29-0a0f07b826fb" alt="Scheduled Messages: reminders, scheduled CSV broadcasts and event-triggered sends, with status, cadence and progress"><figcaption></figcaption></figure>

Use the search box and **Add Filter** to find a schedule. Click a row to edit it. If you close a schedule form with unsaved changes, Yazi asks before discarding them.

## Send history for a schedule

The clock icon in **Actions** opens Send history for that schedule:

* counts for sent, delivered, read and failed messages, and those still waiting. Click a count to see only those people.
* one bar showing the whole send at a glance, and a small chart of batches with failures in red
* failure reasons in plain English, grouped, with the people each affected
* a searchable recipient list (25 a page) with each person's status and reason, and a CSV download

You need permission to export personal data to see it. If your organisation hides phone numbers, you see participant IDs. What each status means is on [Send history and statuses](https://docs.askyazi.com/reach-participants/send-history-and-statuses.md).

## Safety checks

* **Refused at save.** A schedule that cannot work (for example, its variables do not match the template) is refused when you save it, with a message saying what is wrong.
* **Short WhatsApp holds.** If Meta holds sends for a few minutes, the schedule pauses for about ten minutes and carries on.
* **Stuck schedules switch off.** A schedule that keeps making no progress switches itself off and shows the reason, instead of failing quietly.
* **Changed lists are checked.** If you swap the uploaded file, Yazi checks the new file has the columns the message needs and asks you to re-pick any variable whose column is gone.

## Limits and things to know

* There is no "send now" button on a schedule. To send immediately, use **Send broadcast** on the study.
* A scheduled message is still a template message, so Meta's daily limit and per-message fees apply.
* Scheduled study activities can take up to about five minutes after their set time to go out.

## Related

* [Send a broadcast](https://docs.askyazi.com/reach-participants/send-a-broadcast.md)
* [Reminders](https://docs.askyazi.com/reach-participants/reminders.md)
* [Send history and statuses](https://docs.askyazi.com/reach-participants/send-history-and-statuses.md)
* [Event triggers API](https://docs.askyazi.com/integrations-and-api/event-triggers-api.md)
