> ## 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" はDST の変更に対して 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"
  }
}
```

スケジュールされた応答には `message_id` の代わりに `schedule_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メッセージIDを保持します。 2分間の請求の有効期限が切れた後、中断された発生はその同じIDで要求され、試みの予算にカウントされます。 Pollsは再試行に渡って暗号化の秘密を保持します。これは曖昧な承認の後にメッセージの身元を保持しますが、完全に一度の配信を保証するものではありません。
* **古い中断試行:** 結果が不明なレガシー試行は保守的な回復を保持します。 ワーカーは、定期的なスケジュールの発生をスキップしたり、新しいメッセージIDを割り当てるのではなく、ワンオフのスケジュールに失敗したりします。

## MCP 以上

MCP ツール `whatsapp_send` は同じスケジュール項目を受け付け、`whatsapp_schedule` リスト、取得、一時停止、再開、キャンセルします。[MCP server](https://gowa-docs.mintlify.site/ja/integrations/mcp.md) を参照してください。

> [!NOTE]
>
> `GET /app/info`: `results.scheduled_sends` は、サーバがスケジュールフィールドを受け取り、 `/send/schedules` を公開するときに `true` になります。


## Related topics

- [スケジュールされた送信の一覧](https://gowa-docs.mintlify.site/ja/api-reference/send/スケジュールされた送信の一覧.md)
- [スケジュールされた送信を取得](https://gowa-docs.mintlify.site/ja/api-reference/send/スケジュールされた送信を取得.md)
- [スケジュールされた送信を一時停止](https://gowa-docs.mintlify.site/ja/api-reference/send/スケジュールされた送信を一時停止.md)
- [スケジュールされた送信をキャンセル](https://gowa-docs.mintlify.site/ja/api-reference/send/スケジュールされた送信をキャンセル.md)
- [一時停止された送信を再開](https://gowa-docs.mintlify.site/ja/api-reference/send/一時停止された送信を再開.md)


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