メインコンテンツへスキップ
Webhookウェイクは、ウェイクラダーの2段目です。オーナーがWhatsAppで書き込み、エージェントが聞いていないとき、zapbipはエージェントを起動するリンクを呼び出します。対応しているクライアントでは、インストールの流れがこれを設定します。このページでは、zapbipが何を送るかと、手動で設定する方法を説明します。 その後、エージェントは check_inbox または get_messages でメッセージを読み、答えます。リンクは set_wake で保存します。 この呼び出しにあなたのテキストは含まれません。本文は常に {"event":"inbox_has_messages"} です。続けて届いたメッセージは、最初の1通の数秒後に送られる1回のウェイクを共有します。

Grok Botのルーティン

Webhookトリガー付きのルーティンを作成し、保存します。
zapbipは Authorization: Bearer <token> を送ります。

claude.aiのスケジュールタスク

APIトリガー付きのスケジュールタスクを作成し、保存します。
zapbipは Authorization: Bearer <token> とルーティンのヘッダーを送ります。

自前のサービス

公開されている https のホストならどれでも使えます。トークンは署名キーで、32文字以上が必要であり、送信されることはありません。各リクエストには X-Zapbip-Timestamp(Unix秒)と X-Zapbip-Signature が付きます。後者は sha256= に続けて、<timestamp>.<body> のHMAC-SHA256の16進文字列です。300 秒より古いタイムスタンプは拒否してください。

ウェイクが失敗したとき

  • 408、425、429、5xx、タイムアウト、ネットワークエラーは最大5回まで再試行します。待ち時間は5 秒、10 秒、20 秒、40 秒で、429 と 503 では Retry-After を尊重し、最長60 秒です。
  • リダイレクトやその他の 4xx の応答は、ただちに拒否され、再試行されません。
  • ウェイクが拒否された、またはあきらめた場合、メッセージが受信トレイで待っているという通知がWhatsAppに1つ届き、接続は failing と記録されます。もう一度 set_wake を呼んで宛先を直してください。次に配信されたウェイクで active に戻ります。
  • ウェイクが発火する前にエージェントがメッセージを読んだ場合、リクエストは送られません。