yanola/DocsOpen dashboard
Browse documentation

Scheduler

Schedule a one-time WhatsApp message

Choose contacts, Sender, content, media or approved template, future time, and review estimated cost.

Business usersMarketing teamsBeginnerAvailable

What this guide covers

  • The Scheduler queues one future message for selected contacts and tracks pending, processing, completed, failed, or cancelled state.
  • Prerequisites: An active Sender.
  • Result: The item appears as pending and later becomes completed or failed; cancelled items remain identifiable until deleted.
  • Limit: One-time schedules cannot be paused or edited. No recurring, start-date range, or end-date range control exists on the Scheduler page. The UI exposes cancellation only for pending items and deletion only for cancelled, completed, or failed items.

What this is and when to use it

The Scheduler queues one future message for selected contacts and tracks pending, processing, completed, failed, or cancelled state.

When to use Schedule a one-time WhatsApp message
Use it whenExpected outcome
You want to send one message at a specific future time.The item appears as pending and later becomes completed or failed; cancelled items remain identifiable until deleted.

Before you begin

  1. An active Sender.
  2. At least one saved, non-opted-out contact.
  3. Approved template if template type is selected.
  4. Media within limits or a usable URL.
  5. Enough Balance for the displayed estimate.

Complete the task

  1. Open Agent Project → Scheduler and create a schedule.
  2. Select the Sender and one or more eligible contacts.
  3. Choose text, image, video, document, audio, or template.
  4. Complete content and media/template fields.
  5. Select a future date and time and verify the browser-derived timezone.
  6. Review recipients and cost estimate, then create the schedule.
  7. Cancel while pending if it should not send.

Confirm it worked

  1. The item appears as pending and later becomes completed or failed; cancelled items remain identifiable until deleted.

Common problems

Schedule a one-time WhatsApp message troubleshooting
SymptomWhat to check
Contact is unavailableOpted-out contacts are excluded; confirm the contact and selected business number.
Insufficient balanceTop up the shared Yanola Balance and recreate or retry as the UI permits.
Template missingSync approved templates for the selected Sender.

Current limitations

One-time schedules cannot be paused or edited. No recurring, start-date range, or end-date range control exists on the Scheduler page. The UI exposes cancellation only for pending items and deletion only for cancelled, completed, or failed items.

Where to go next

Related documentation

ContactsCreate, search, filter, update, and delete the saved people used by the Scheduler and workflows.WhatsApp message templatesDraft a Meta template payload, submit it for approval, sync approved templates, and use them in Scheduler or workflows.Yanola Balance, top-ups, and auto-top-upFund billable activity and investigate low-balance or insufficient-balance failures.