すべての送信リクエストはすぐに送信する代わりにスケジュールすることができます。 scheduled_atとtimezoneを追加します。GOWAはリクエストを保存し、その時にバックグラウンドワーカーが送信します。 スケジュールは再起動後も生き残り、オフラインデバイスを待ちます。
スケジュールされたメッセージタイプ:テキスト、画像、ファイル、ビデオ、オーディオ、ステッカー、連絡先、リンク、ロケーション、投票と転送 (/message/{id}/forward) 存在、入力インジケーター、および実験的な /send/interactive エンドポイントはスケジュールできません。
スケジュールフィールド
scheduled_at がなければ、リクエストは通常通りすぐに送信されます。
例
スケジュールされた応答には message_id の代わりに schedule_id があります。
アップロードしたファイルは、スケジュールが完了するまでサーバーに保持されます。マルチパートの本文では、weekdays を繰り返しフィールドとして送信してください(-F weekdays=1 -F weekdays=3)。
スケジュールの管理
スケジュールはデバイスに属します。同じ X-Device-Id を送信します。
リストは results.data と results.pagination (limit, default 25; offset; total) を返します。
Statuses
配送の動作
- 労働者は5秒ごとに期日をチェックします。
- デバイスがオフラインまたはログインしていない: ランは30秒ごとに待ち、再試行されます。 待っていることは、失敗した試みとして数えられないので、スケジュールは長い停電を生き残ります。
- 送信エラー: 15 秒から始まり最大 5 分まで延びるバックオフで、実行回ごとに最大 10 回再試行します。その後、繰り返しスケジュールは次の実行回に進み、単発のスケジュールは
failed になります。
- 無効なリクエスト (例えば悪い受信者など): 直ちに再試行せずに失敗します。
- 遅延実行:
end_at以前の遅延発生は送信されません。
- クラッシュと再起動: シャットダウンはすでに飛行中の送信を中断しません。最初の試みの前に、GOWAは発生のためのWhatsAppメッセージIDを保持します。 2分間の請求の有効期限が切れた後、中断された発生はその同じIDで要求され、試みの予算にカウントされます。 Pollsは再試行に渡って暗号化の秘密を保持します。これは曖昧な承認の後にメッセージの身元を保持しますが、完全に一度の配信を保証するものではありません。
- 古い中断試行: 結果が不明なレガシー試行は保守的な回復を保持します。 ワーカーは、定期的なスケジュールの発生をスキップしたり、新しいメッセージIDを割り当てるのではなく、ワンオフのスケジュールに失敗したりします。
MCP 以上
MCP ツール whatsapp_send は同じスケジュール項目を受け付け、whatsapp_schedule リスト、取得、一時停止、再開、キャンセルします。MCP server を参照してください。
GET /app/info: results.scheduled_sends は、サーバがスケジュールフィールドを受け取り、 /send/schedules を公開するときに true になります。