アカウントと連携

外部システムやアシスタントを接続する

Pro または Agency で権限を限定したキーを作成し、最新のコンテンツを投稿したり、アシスタントを接続したりできます。

始める前に

Webhook は WhatsApp サービスから受信通知を受ける宛先です。サーバー設定は連携の管理者が行い、利用者が変える必要はありません。MCP はアシスタントがツールを要求する接続です。

操作手順

受信連携では「設定」で「Webhook URL」を探します。
「コピー」で、この環境の正確なアドレスを取得します。
そのアドレスで対象デバイスの受信イベントを設定するよう管理者に依頼します。
準備完了の確認後、自分の番号から受信テストを行います。
一致する自動返信や、ログを有効にしたグループの新規記録など、想定した結果を確認します。
アシスタントの連携では MCP クライアントが開く認証画面からログインします。
許可する前に、表示されたアプリケーションとアカウントを確認します。
外部から送信するには、設定 → 外部連携を開きます。接続済みのアカウント1つと、明示的に選択したグループ用の名前付きキーを作成します。表示は一度だけなので、その場でキーを保存してください。API ベース URL をコピーします。
例：America/Sao_Paulo のタイムゾーンで、毎日8回の投稿時刻ごとに最新のコンテンツを生成するよう Abacus.AI を設定します。投稿ごとに新しい Idempotency-Key を使い、許可された3つのグループに送信リクエストを出します。同じキーを再利用するのは、完全に同じリクエストを再試行する場合だけです。
scheduled_at を省略するとすぐにキューに入ります。予約する場合は、最大30日先までの -03:00 または Z (UTC) 付きの絶対タイムスタンプを指定します。処理は毎分確認されます。scheduled_at は処理可能になる最も早い時刻であり、秒単位での正確な配信は保証しません。
再試行する前にジョブの状態とグループごとの結果を確認してください。まだ送出されていない送信だけをキャンセルします。漏えいしたキーは設定で失効させ、代わりのキーを作成して保存してください。新しいキーで以前のジョブが再開されることはありません。

記入例

プレースホルダーを含むリクエストです。送信前に ID を置き換え、将来の日付を指定してください。これらのリクエストは実際にメッセージを投稿します。 curl '<API_BASE_URL>/v1/groups' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-0900' -H 'Content-Type: application/json' --data '{"type":"text","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"text":"Updated publication","scheduled_at":"2026-10-16T09:00:00-03:00"}' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-1200' -F 'payload={"type":"image","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"caption":"Updated caption"}' -F 'image=@publication.png;type=image/png' curl '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X DELETE '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>'

結果の確認

ジョブの受付とグループごとの受付済み結果は、ゲートウェイによる受付を確認するものです。配信や既読は確認しません。アクセス権、キー、アカウント、グループの権限が変わると、予約済みの処理がブロックされる場合があります。

知っておくこと

アシスタントは公開された記録を読み、依頼されたときにテキストを送れます。送信を依頼する前にツールのガイドを確認してください。
MCP にない編集操作はダッシュボードで行ってください。
API は Pro と Agency の月額・年額プランに含まれます。Starter ではアップグレードが必要です。キーで利用できるのは選択したアカウントとグループだけです。WhatsApp アカウントを置き換えると送信がブロックされます。サーバーの認証情報は絶対に共有しないでください。
テキストは4,096文字、キャプションは1,024文字まで対応します。最大5 MiB の JPEG、PNG、WebP を multipart の payload と image フィールドでアップロードします。外部の画像 URL は使用できません。
新しいジョブは HTTP 202 を返します。同じ Idempotency-Key で同じリクエストを再試行すると、元のジョブが HTTP 200 で返されます。同じキーで内容が異なる場合は409を返します。送出後のタイムアウトは結果が未確認となることがあります。別のキーで自動的に再送しないでください。

よくある問題

表示される状況: テスト後に返信や新しい記録がありません。
対処方法: 接続とルールやログを確認し、受信設定の確認を管理者に依頼してください。
期待される結果: 正しく設定された機能が新しい一致イベントを処理できます。

表示される状況: アシスタントが認証できないか、違うアカウントを表示します。
対処方法: ログインに戻って目的のアカウントを選び、繰り返すエラーは管理者に伝えてください。
期待される結果: 認証画面と返される記録が目的のアカウントに属します。

さらにサポートを受ける

機能名と表示エラーを管理者に伝えてください。サーバーの認証情報をアシスタントとの会話に入れないでください。

この機能を開く