ソーシャルメディア Webhook:コメント、メンション、メッセージを 1 つのエンドポイントへ
easyCoexistence は、Instagram と Facebook のコメント、メンション、DM、および TikTok のコメントを、発生のたびにお使いの HTTPS エンドポイントへ転送します。各イベントは 1 つのエンベロープで届き、ネットワーク側のイベントは変更されずにその中に含まれます。アカウントごとに X-EC-Signature で署名されます。Claude または ChatGPT から set_social_webhook_destination を実行するか、Partner API を使えば、アカウント単位で有効にできます。WhatsApp 番号のメッセージもサーバーに届きます。
- コメント、メンション、DM を発生時に受信
- 1 つのエンベロープ、アカウントごとに署名
- Claude、ChatGPT、Partner API から設定
3 日間は料金なし。いつでもキャンセルできます。
easyCoexistence が転送する各ソーシャルイベントの送信回数です。コピーを保持しないため、後から再送されることはありません。
TikTok の comment.update Webhook が、所有アカウントの公開動画に対するコメントの作成、削除、公開状態の変更を報告するまでの時間です。
Instagram Login のアプリが @mentions を受け取る場所です。独自のフィールドではなく、コメント Webhook 通知の内部に含まれます。
YouTube のプッシュ通知がチャンネルについて報告する内容です。新しいアップロード、新しいタイトル、新しい説明文のいずれかです。
サーバーが受け付けなかった WhatsApp Webhook を、Meta が再試行し続ける期間です。重複して届くことがあります。
各ネットワークはどのイベントを送信しますか?
Instagram、Facebook、TikTok はイベントを easyCoexistence に送信し、easyCoexistence がアカウントごとに設定された URL へ渡します。Instagram は新しいコメントと DM を送信します。@mentions はコメント通知の中に含まれて届きます。Facebook ページはフィードのアクティビティを送信します。これには新しいコメントが含まれ、さらに Messenger のメッセージとページへのメンションも送信されます。TikTok は comment.update を送信します。コメントが作成、削除、または公開範囲を変更されたときに発火します。
YouTube と LinkedIn は、コメントやメッセージのイベントを easyCoexistence に送信しません。そのためエージェントは必要に応じてコメントを読み取ります。WhatsApp 番号は独自の経路で動作します。Meta がメッセージをサーバーへ直接配信するか、番号がマネージドモードで動作している場合は、easyCoexistence が署名付きで転送します。
| What arrives | Sent by | |
|---|---|---|
| Comments, mentions and DMs | easyCoexistence, signed per account | |
| Feed activity, Messenger and mentions | easyCoexistence, signed per account | |
| TikTok | comment.update events | easyCoexistence, signed per account |
| Messages and echoes from the app | Meta directly, or easyCoexistence in managed mode | |
| YouTube | No comment events | Read with list_youtube_comments |
| No comment events | Read with list_linkedin_comments |
転送されたイベントはどのような形式ですか?
どのネットワークでも同じ JSON エンベロープで、Content-Type application/json を指定して POST されます。含まれるフィールドは次のとおりです。platform はネットワーク、account_id は MCP ツールと Partner API が使う ID、external_id はネットワーク上のアカウント ID、entry はネットワークから届いたイベントそのものです。Instagram と Facebook の entry は Meta の Webhook entry で、コメントとメンションは changes に、DM は messaging に入ります。TikTok では comment.update イベントが入り、comment_id、video_id、parent_comment_id は文字列として届くため、64 ビットの ID が丸められることはありません。Messenger のメッセージは次のように届きます:
{
"platform": "facebook",
"account_id": "<ACCOUNT_ID>",
"external_id": "<PAGE_ID>",
"entry": {
"id": "<PAGE_ID>",
"time": 1793318400512,
"messaging": [
{
"sender": { "id": "<PAGE_SCOPED_ID>" },
"recipient": { "id": "<PAGE_ID>" },
"timestamp": 1793318399870,
"message": { "mid": "<MESSAGE_ID>", "text": "Are you open on Sunday?" }
}
]
}
}X-EC-Signature はどのように検証しますか?
エンドポイントを設定したときに返される署名シークレットを使います。このシークレットはアカウントごとに固有で、一度だけ表示されます。ヘッダーは t=<unix>,v1=<hex> の形式です。v1 は、タイムスタンプ、ドット、生のリクエストボディを連結したものに対する HMAC-SHA256 で、そのシークレットを鍵として計算します。解析する前にボディをバイト列として読み取り、現在時刻から 5 分以上ずれたタイムスタンプは拒否してください。イベントの account_id でシークレットを検索し、2 つのダイジェストを定数時間で比較します。その後、2xx を返して処理をキューに入れます。PHP では数行で実装できます:
<?php
// POST /hooks/social: one endpoint for the events of each account
$raw = file_get_contents('php://input'); // the exact bytes that were signed
parse_str(str_replace(',', '&', $_SERVER['HTTP_X_EC_SIGNATURE'] ?? ''), $sig);
$event = json_decode($raw, true); // platform, account_id, external_id, entry
$secret = secret_for($event['account_id'] ?? ''); // the signing_secret stored for that account
$fresh = ctype_digit($sig['t'] ?? '') && abs(time() - (int) $sig['t']) <= 300;
$expected = hash_hmac('sha256', ($sig['t'] ?? '') . '.' . $raw, (string) $secret);
if (!$secret || !$fresh || !hash_equals($expected, $sig['v1'] ?? '')) {
http_response_code(401);
exit;
}
http_response_code(204);
enqueue($event); // keep this quick: the forward waits 8 seconds and is never resentアカウントの転送はどのように有効にしますか?
アシスタントから、またはバックエンドから行います。Claude または ChatGPT に、アカウントと HTTPS の URL を指定して set_social_webhook_destination を実行するよう依頼するか、ec_live_ キーを付けて、url を含むボディとともに Partner API の PUT /api/v1/channels/:id/webhook を呼び出します。どちらの方法でも、アカウントの signing_secret が一度だけ返されるため、その時点で account_id と紐づけて保存してください。どちらかを再度呼び出すと新しいシークレットが発行され、url に null を指定すると転送が無効になります。
URL は公開ホスト上の HTTPS である必要があります。プライベートアドレスは、設定時と配信時の両方で拒否されます。各イベントには account_id が含まれるため、1 つのエンドポイントで複数のアカウントを処理できます。WhatsApp 番号の場合、set_webhook_destination は Meta の配信をお使いのサーバーへ振り分けます。set_inbound_mode に forward_url を指定すると、代わりに署名付きで転送されます。
エンドポイントが遅い、またはダウンしている場合はどうなりますか?
イベントは再送されません。easyCoexistence は 1 回だけ送信し、応答を最大 8 秒待ち、リダイレクトには従わず、コピーも保持しません。再試行すると、お客様のコメントやメッセージを保存することになるためです。署名が検証できたらすぐに 2xx を返し、時間のかかる処理はキューから実行してください。また、同じイベントが 2 回届く場合に備えて、コメント ID やメッセージの mid などネットワーク固有の ID で重複を排除してください。
WhatsApp は異なります。ダイレクトモードでは、サーバーが受け付けなかった配信を Meta が最大 7 日間再試行します。マネージドモードでは、easyCoexistence が転送先 URL 宛のメッセージをキューに入れ、バックオフを伴って再試行します。接続が切れるなどのパートナーステータスイベントは、約 33 時間にわたって再試行されます。
YouTube と LinkedIn のコメントはエージェントにどのように届きますか?
スケジュールに従って読み取ることで届きます。YouTube のプッシュ通知が報告するのは、新しいアップロード、新しいタイトル、新しい説明文であり、コメントではありません。また easyCoexistence は LinkedIn からコメントのイベントを受け取らないため、どちらも何も転送しません。そこでエージェントが自ら確認します。list_youtube_comments は、動画のスレッドまたはチャンネル全体のスレッドを返します。審査待ちのものも含まれます。list_linkedin_comments は、投稿へのコメント、または特定のコメントへの返信を返します。n8n、Make、Zapier では、スケジュールトリガーが確認を開始します。独自のコードの場合は、cron ジョブでチャンネルの認証情報を取得し、YouTube の commentThreads または LinkedIn のコメントエンドポイントを直接呼び出します。
設定方法
- Set the destinationRun set_social_webhook_destination with the account and an HTTPS URL, or call PUT /api/v1/channels/:id/webhook with your ec_live_ key.
- Store the secretSave the signing_secret from the response against that account_id, since it is shown only once.
- Verify each deliveryCheck that the timestamp is fresh and that v1 matches an HMAC-SHA256 of the timestamp, a dot and the raw body.
- Acknowledge, then workAnswer 2xx straight away and hand the event to a queue, because easyCoexistence sends it only once.
よくある間違い
- 解析済みの JSON に対して HMAC を検証すること。署名は生のボディをバイト単位で対象にしているため、解析されたオブジェクトを再度シリアライズするとそのバイト列が変わってしまいます。解析する前に検証してください。
- すべてのアカウントで 1 つのシークレットを使うこと。アカウントごとに独自のシークレットで署名するため、v1 を比較する前に、イベントの account_id でシークレットを検索してください。
- エンドポイントを更新せずに転送先を再設定すること。呼び出すたびに新しいシークレットが発行され、古いシークレットは即座に署名に使われなくなるため、新しいシークレットをすぐに保存してください。
- リダイレクトする URL を指定すること。転送はリダイレクトに従わないため、新しいパスやホストに移動するとイベントは失われます。最終的なアドレスを設定してください。
easyCoexistence は、Instagram と Facebook のコメント、メンション、DM、そして TikTok のコメントを発生時にエンドポイントへ送信し、アカウントごとに署名します。さらに WhatsApp のメッセージをサーバーへ届けるため、AI エージェントは各ネットワークの公式 API を通じて顧客の声を受け取れます。すべての接続は 24 時間体制で監視されます。接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。
よくある質問
WhatsApp 番号のメッセージは、どのようにエンドポイントに届きますか?
2 つの方法があります。set_webhook_destination を使うと、Meta がサーバーへ直接配信します。set_inbound_mode に forward_url を指定すると、easyCoexistence が X-EC-Signature 付きで転送し、バックオフを伴って再試行します。
同じイベントが 2 回届くことはありますか?
あります。そのため、コメント ID やメッセージの mid などネットワーク固有の ID で重複を排除してください。サーバーが受け付けなかった WhatsApp の配信を Meta が最大 7 日間再試行するため、重複が生じることもあります。
1 つのエンドポイントで複数のアカウントのイベントを受け取れますか?
はい。各イベントには platform と account_id が含まれるため、1 つの URL で複数のアカウントを処理できます。ただし、各署名はそのアカウント自身のシークレットで検証してください。
ソーシャルメディア Webhook には、easyCoexistence の料金はいくらかかりますか?
接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。どのネットワークでも同額です。転送、MCP サーバー、Partner API が含まれ、最初の 3 日間は無料トライアルです。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日