> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Запланированные отправители

> Отправляйте любое сообщение позднее, раз в день, еженедельно или ежемесячно, и управляйте расписаниями через /send/Schedules.

![GOWA Обзор планировщика сообщений](https://mintcdn.com/gowa-docs/G0gUpNl3gUGyehVX/images/GOWA-Message-Scheduler-Overview.png?fit=max\&auto=format\&n=G0gUpNl3gUGyehVX\&q=85\&s=663bfdbb9e1c0bb451c0fa782380b139)

Любой запрос может быть запланирован вместо отправки немедленно. Добавьте `scheduled_at` и `timezone`; GOWA хранит запрос, а фоновый работник отправляет его в то время. Запланировать перезапуск и ожидание оффлайн устройства.

Расписание типов сообщений: текст, изображение, файл, видео, аудио, стикер, контакт, ссылка, местоположение, опрос и вперед (`/message/{id}/forward`). Наличие, ввод индикаторов и экспериментальная конечная точка `/send/interactive` не запланирована.

## Поля расписания

| Поле | Требуется | Описание |
| - | - | - |
| `scheduled_at` | да | RFC 3339 время первого отправления, например `2026-11-01T09:00:00+07:00`. Первое всегда происходит в данный момент. |
| `timezone` | да | Зона IANA (например `Asia/Jakarta`) используется для вычисления повторов, поэтому "09:00 каждый день" остается 09:00 на смену ДСТ. |
| `recurrence` | нет | `once` (по умолчанию), `daily`, `weekly` или `monthly`. |
| `weekdays` | еженедельно | Дней для отправки, `0` = Воскресенье … `6` = Суббота, например `[1, 3, 5]`. |
| `day_of_month` | ежемесячно | `1`–`31`; в последний день более коротких месяцев. |
| `end_at` | нет | Только повторение не отправляется после этого времени. |
| `occurrence_limit` | нет | Только повтор. Остановиться после этого много отправлений. |

Запрос без `scheduled_at` отправляется немедленно как обычно.

## Примеры

```bash theme={null}
# once, tomorrow morning
curl -u admin:changeme -X POST http://localhost:3000/send/message \
  -H "Content-Type: application/json" -H "X-Device-Id: my-device" \
  -d '{
    "phone": "628123456789",
    "message": "Reminder: meeting at 10:00",
    "scheduled_at": "2026-11-01T09:00:00+07:00",
    "timezone": "Asia/Jakarta"
  }'
```

```json theme={null}
{
  "code": "SUCCESS",
  "message": "Success",
  "results": {
    "schedule_id": "0b5c3a8e-7f5d-4d6f-9d1e-2f8c1a7b9e10",
    "scheduled_at": "2026-11-01T02:00:00Z",
    "next_run_at": "2026-11-01T02:00:00Z"
  }
}
```

Запланированные ответы имеют `schedule_id` вместо `message_id`.

```bash theme={null}
# every Monday, Wednesday and Friday at 08:30, 12 times
curl -u admin:changeme -X POST http://localhost:3000/send/message \
  -H "Content-Type: application/json" -H "X-Device-Id: my-device" \
  -d '{
    "phone": "120363025246125486@g.us",
    "message": "Standup in 30 minutes",
    "scheduled_at": "2026-11-02T08:30:00+07:00",
    "timezone": "Asia/Jakarta",
    "recurrence": "weekly",
    "weekdays": [1, 3, 5],
    "occurrence_limit": 12
  }'
```

```bash theme={null}
# monthly invoice on the 1st, with an uploaded file (multipart: repeat weekdays as separate fields if used)
curl -u admin:changeme -X POST http://localhost:3000/send/file \
  -H "X-Device-Id: my-device" \
  -F phone=628123456789 \
  -F file=@invoice.pdf \
  -F scheduled_at=2026-12-01T09:00:00+07:00 \
  -F timezone=Asia/Jakarta \
  -F recurrence=monthly \
  -F day_of_month=1 \
  -F end_at=2027-12-31T23:59:59+07:00
```

Загруженные файлы хранятся на сервере до окончания расписания. В нескольких частях тела отправляют `weekdays` как повторяющиеся поля (`-F weekdays=1 -F weekdays=3`).

## Управление расписаниями

Расписания принадлежат устройству, отправьте тот же самый `X-Device-Id`.

| Действие | Запросить |
| - | - |
| Список | `GET /send/schedules` с опцией `status`, `search` (получатель или текст), `message_type`, `limit`, `offset` |
| Получить | `GET /send/schedules/{schedule_id}` |
| Пауза | `POST /send/schedules/{schedule_id}/pause` |
| Возобновить | `POST /send/schedules/{schedule_id}/resume` |
| Отмена | `POST /send/schedules/{schedule_id}/cancel` |

```bash theme={null}
curl -u admin:changeme -H "X-Device-Id: my-device" \
  "http://localhost:3000/send/schedules?status=active&limit=25"
```

Список возвращает `results.data` и `results.pagination` (`limit`, default 25; `offset`; `total`).

### Statuses

| Статус | Значение |
| - | - |
| `active` | Ожидание следующего запуска. |
| `running` | Получено работником и отсылается. |
| `paused` | Состоялся до возобновления. |
| `completed` | Нет запусков. |
| `failed` | Сохраняется после извлечения, или сохраненный запрос был недействительным. |
| `cancelled` | Отменено вами. |

## Порядок доставки

* Работник проверяет соблюдение графика каждые 5 секунд.
* **Устройство в автономном режиме или не вошло:** запуск ждет и повторяет каждые 30 секунд. Ожидание не засчитывается как неудачная попытка, поэтому график переживает длинные перебои.
* **Ошибки отправки:** повторные попытки выполняются с увеличивающейся задержкой от 15 секунд до 5 минут, не более 10 попыток на каждое запланированное выполнение. После этого повторяющееся расписание переходит к следующему выполнению, а разовое получает статус `failed`.
* **Недействительный запрос** (например, неверный получатель): не удаётся сразу же без повторной попытки.
* **Поздний запуск:** событие с задержкой `end_at` не отправляется.
* **Вылет из строя и перезапускает:** уже не прекращает отправку. Перед первой попыткой GOWA упорствует идентификатор сообщения WhatsApp. По истечении 2-минутного срока действие прерывается с таким же идентификатором и учитывается в бюджете попытки. Опросы также сохраняют свой секретный ключ шифрования в процессе восстановления. Это сохраняет идентификацию сообщения после неоднозначного подтверждения, но не гарантирует точную доставку один раз.
* **Более ранние прерваны:** унаследованные попытки которого не известно, сохраняют консервативное выздоровление. Работник пропускает то, что происходит для повторяющегося графика или не выполняет одноразового графика, а не назначает новое сообщение идентичным.

## За MCP

Инструмент MCP `whatsapp_send` принимает те же поля расписания, а списки `whatsapp_schedule` получает, останавливает, возобновляет и отменяет расписания. Смотрите [MCP сервер](https://gowa-docs.mintlify.site/ru/integrations/mcp.md).

> [!NOTE]
>
> Проверьте, что `GET /app/info`: `results.scheduled_sends` является `true`, когда сервер принимает поля расписания и раскрывает `/send/schedules`.


## Related topics

- [Удалить сообщение](https://gowa-docs.mintlify.site/ru/api-reference/message/удалить-сообщение.md)
- [Пометить как прочитанное сообщение](https://gowa-docs.mintlify.site/ru/api-reference/message/пометить-как-прочитанное-сообщение.md)
- [Отправить статус присутствия](https://gowa-docs.mintlify.site/ru/api-reference/send/отправить-статус-присутствия.md)
- [Отправить реакцию на сообщение](https://gowa-docs.mintlify.site/ru/api-reference/message/отправить-реакцию-на-сообщение.md)
- [Пометить звуковое сообщение как прослушанное](https://gowa-docs.mintlify.site/ru/api-reference/message/пометить-звуковое-сообщение-как-прослушанное.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.