WhatsApp の自動化を安全に保つ:キー、Webhook、署名
WhatsApp の自動化は四か所で守ります。AI キーは暗号化して保存し、AI 返信にのみ使用します。自動化が呼び出す Webhook は、リクエストを信頼する前に HMAC 署名を検証する必要があります。受信メッセージの転送は、再発行可能なシークレットで署名します。アクセスできる人とアシスタントは、必要な範囲に絞ります。
easyCoexistence は AI キーを暗号化して保存し、再表示しません。
保存された AI キー、署名シークレット、番号の Meta アクセストークンは、保存時に暗号化されます。
保存済みの AI キーは、「ending in 1234」の形で末尾 4 文字だけ表示されます。
各署名シークレットは whsec_ に続けて、24 バイトの乱数で構成されます。自動化ごとに 1 つ、転送用の番号ごとに 1 つ発行されます。
Webhook と転送 URL は公開 HTTPS である必要があり、プライベートアドレスと内部アドレスは保存時と送信前の両方で拒否されます。
署名の t の値の有効期限を設定し、リプレイされたリクエストを拒否することが推奨されます。
WhatsApp の自動化設定で保護すべきものは何ですか?
漏えいしたときに、それぞれ個別の場所と個別の対処が必要な 5 種類の認証情報があります。このうち 2 つは自動化そのものに属します。AI キーと、「Call my webhook」の署名シークレットです。転送シークレットは番号に、アクセストークンとアシスタントのサインインはアカウントに属します。どれがどれかを把握しておくと、問題が起きたときに何を再発行すべきかがわかります。
AI キーはどのように保存され、使われますか?
使えるのはダッシュボードからだけです。自動化ページの「AI keys」ボタンを開き、「Test and save」を実行します。キーはまず、プロバイダーの無料エンドポイントで確認されます。これはトークンを消費しません。プロバイダーが拒否したキーは、保存されずに破棄されます。有効なキーは AES-256-GCM で保存時に暗号化され、AI ステップとエージェントでプロバイダーを呼び出すとき、および OpenAI または OpenRouter のキーで音声メッセージを文字に起こすときだけ復号されます。保存後は「ending in 1234」の形で末尾だけが表示されます。どの MCP ツールもキーを受け付けたり返したりしないため、アシスタントとのチャットを経由することはありません。
アカウントでは、プロバイダーごとに 1 つのキーを保持します。新しいキーを保存すると、古いキーは置き換えられます。自動化専用のキーをプロバイダー側で作成し、提供されていれば利用上限を設定してください。そうすれば、他のアプリを壊さずに取り消せます。プロバイダーがキーを拒否した場合、そのキーを使う自動化は「Paused」と表示され、メールが 1 通届きます。動作するキーを保存すると、自動化は自動的に再開されます。
Call my webhook のリクエストが正規のものか、どのように検証しますか?
何よりも先に署名を確認してください。各リクエストには X-EC-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>"> が付いています。これは、その自動化の署名シークレットでキー付けされています。シークレットは、保存後にエディタの該当ステップからコピーできます。生のバイト列に対して HMAC を再計算し、定数時間で比較してください。また、t がご自身の時計から 5 分以上離れているリクエストは拒否してください。
本文からは、対応すべき情報が 2 つ得られます。dry_run は、リクエストが「Try it」から来た場合に true になります。そのため、注文の作成など元に戻せない処理はスキップしてください。run_id は実行ごとに一意です。処理済みの run_id を保存しておき、リプレイされたリクエストは拒否してください。20 秒以内に応答してください。{"reply": "..."} は書かれたままお客様に送信されるため、お客様のテキストを検証せずに渡さないでください。
POST /hooks/whatsapp HTTP/1.1
Content-Type: application/json
User-Agent: easyCoexistence-automations/1
X-EC-Event: automation.step
X-EC-Signature: t=1794405732,v1=<64 hex characters>
{
"event": "automation.step",
"dry_run": false,
"automation": { "id": "a7d0c3e2-5b1f-4c8e-9a6d-2f4e8b1c7d90", "name": "Order status" },
"run_id": "e41b9f07-3c2a-4d6e-8f15-7a9c0b2d4e68",
"channel": { "type": "whatsapp", "connection_id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f", "phone": "+1 631-555-0142", "phone_number_id": "106540352242922" },
"connection": { "id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f", "phone": "+1 631-555-0142", "phone_number_id": "106540352242922" },
"contact": { "id": "5511987654321", "wa_id": "5511987654321", "name": "Ana Souza" },
"message": { "id": "wamid.HBgNNTUxMTk4NzY1NDMyMRUCABIYFjNFQjBDNzE4RjQ2QjI5RDkxQTNFAA==", "type": "text", "text": "Where is my order #1042?", "at": "2026-11-11T14:02:11.000Z" },
"history": [
{ "direction": "in", "text": "Hi!", "at": "2026-11-11T14:01:40.120Z" },
{ "direction": "in", "text": "Where is my order #1042?", "at": "2026-11-11T14:02:11.310Z" }
]
}
// Your answer, within 20 seconds (or {} to send nothing):
{ "reply": "Your order #1042 left the shop at 2:20 p.m." }転送シークレットはどう機能し、どのように再発行しますか?
「Through easyCoexistence」に設定した番号は、受信メッセージを自分のシステムに転送できます。転送 URL を初めて保存すると、シークレットが生成され、「Your signing secret, shown once. Copy it now:」の下に一度だけ表示されます。このシークレットは、転送される各 POST を同じ X-EC-Signature 方式で署名します。番号のページで「New secret」を実行するか、set_inbound_mode で rotate_secret を true にすると、置き換えのシークレットが発行されます。これも一度だけ表示されます。それ以降は、古い配信の再送を含め、すべてが新しいシークレットで署名されます。24 文字以上の独自のシークレットを入力することもでき、その場合は保存され、二度と表示されません。転送を停止するとシークレットは削除されるため、後で URL を保存すると新しいシークレットから始まります。
次の場合は再発行してください。チームメンバーがアクセス権を失ったとき、シークレットがリポジトリ、チケット、ログに漏えいしたとき、ホスティングを変更するときです。Call my webhook のシークレットは自動化に属し、アカウントのオーナーだけが見られます。「Your system calls a URL」トリガーの下でエディタに「New secret」が表示される場合は、そのボタンでシークレットを置き換えられ、古いシークレットはすぐに使えなくなります。そのボタンがない自動化では、自動化を作り直し、受信側を新しいシークレットに向けてから、古い自動化を削除してください。
自動化はどのアドレスを呼び出せますか?
公開 HTTPS のアドレスだけです。「Call my webhook」の URL または転送 URL が http:// で始まる場合、localhost を指す場合、プライベートネットワーク範囲、.internal または .local の名前、クラウドのメタデータアドレスを指す場合は、保存時に拒否されます。さらに、DNS 解決の後、各リクエストの前にも再確認されます。そのため、公開名を後からプライベートネットワーク内に向けることはできません。リダイレクトは追従されません。301 や 302 はステップの失敗になるため、最終的なアドレスを保存してください。
シークレットは URL 自体に含めないでください。list_automations は、各自動化のステップ(Webhook URL を含む)を、アカウントに接続されたどのアシスタントにも返します。そのため、クエリ文字列のトークンはそこから読み取れます。代わりに、証明は署名に担わせてください。
アクセス権を最小限に保つには?
各人と各ツールには、その業務に必要なアクセスだけを与え、もう使わないものは削除してください。サインイン、確認、ブロックされたツールを含むコネクター側の設定は、「AI で WhatsApp に安全に接続する」ページで扱っています。自動化側では、特に次の習慣が重要です:
get_api_credentialsは、非公開のチャットでのみ依頼してください。番号のアクセストークンがそのやり取りに残るためです。- 第三者ツールにトークンを渡すより、Call my webhook か転送 URL を優先してください。
- 使わなくなった自動化は削除してください。その署名シークレットも同時に無効になります。
- 実行ログには、30 日間お客様のメッセージと返信が保存され、Conversations にはチャットが保持期間(30 日、90 日、または 365 日)の間保存されることを覚えておいてください。どちらもダッシュボードと接続済みのアシスタントから閲覧できます。
- 「Straight to your system」に設定した番号では、コールバック URL のパスに長いランダムなシークレットを含めてください。そこでは Meta の署名を検証できないためです。
よくある間違い
- フレームワークが再シリアライズした JSON に対して署名を検証すること。多くのパーサーは空白、エスケープ、キーの順序を変えます。スタックが公開している場所では、必ず生のリクエストバイト列に対して HMAC を計算してください。
- テスト呼び出しで副作用を実行すること。「Try it」は dry_run を true にして Webhook を呼び出します。その際に作成された注文、返金、CRM への書き込みは実際のものになります。
- 時間を節約するために AI キーをアシスタントとのチャットに貼り付けること。どのツールもキーを受け付けず、チャットに残ります。AI キーはダッシュボードで使ってください。
- 転送の確認に Call my webhook のシークレットを使う、またはその逆。これらは別のシークレットです。転送は番号ごと、Webhook 呼び出しは自動化ごとに 1 つです。
Call my webhook のすべてのリクエストと、転送されるすべてのメッセージを、あなただけが保持するシークレットを使って X-EC-Signature で署名します。公開 HTTPS でない Webhook アドレスは拒否します。番号は Coexistence を通じて Meta の公式 Cloud API に接続されたままで、24/7 で監視されます。料金は、番号 1 件あたり月額 US$ 9 から、番号を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。
よくある質問
easyCoexistence のスタッフやサポートは、私の AI キーを見られますか?
キーは保存後、ダッシュボードにも MCP の結果にも、サポートアシスタントが参照する情報にも表示されません。復号されるのはシステムだけで、AI 返信のためにプロバイダーを呼び出すその瞬間だけです。
自動化の実行ログは誰が読めますか?
easyCoexistence アカウントにサインインしている人は、招待した人も含め、「Runs」タブで誰でも読めます。さらに、アカウントに接続されたアシスタントも、list_automation_runs と get_automation_run を通じて読めます。ログにはお客様のメッセージと返信が含まれ、30 日後に削除されます。
AI キーを安全に削除するには?
まず、そのキーを使っている自動化と、そのキーで動くエージェントを「Switch Off」で停止してください。次に「AI keys」の下の「Remove」を選び、プロバイダー側でキーを取り消します。自動化がまだ使っている状態で削除すると、次の AI 返信時に自動化が一時停止され、メールが届きます。
「Try it」は私の Webhook にお客様のデータを送りますか?
送るのは、入力したサンプルテキストだけです。dry_run は true に設定され、履歴は空です。実際の実行では、受信メッセージとチャットの最近のメッセージ(最大 10 件)が送られます。そのため、エンドポイントはお客様のデータを扱うものとして扱ってください。
続きを読む
始める準備はできましたか?
WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める確認日