WhatsApp のメッセージと連絡先を Google スプレッドシートに自動保存
WhatsApp Business のメッセージを Google スプレッドシートに自動で保存するには、署名付きの HTTP POST を n8n、Make、Zapier などの自動化ツールに送り、そのツールの Google Sheets ステップでメッセージごとに 1 行追加します。行には、時刻、方向、電話番号、名前、テキスト、メッセージ ID を記録します。電話番号をキーにした 2 つ目のタブで、連絡先ごとに 1 行を保ち、再びメッセージが届くとその行を更新します。
easyCoexistence は、アプリで使っている WhatsApp Business の番号を、Coexistence を通じて Meta の Cloud API に接続します。
お使いの URL への配信が失敗した場合、転送された配信は約 1、5、30、120、360、1,440 分後に再試行されます。
転送された POST が 2xx のレスポンスを待つ時間。この時間を過ぎると、その配信は再試行されます。
Google Sheets API の書き込みリクエストには、1 分あたり、ユーザーごと、プロジェクトごとの上限があり、プロジェクト全体では 300 件です。
Apps Script のウェブアプリの出力は、script.googleusercontent.com の一度限りの URL にリダイレクトされます。
Apps Script の doPost イベントオブジェクトは、本文とパラメータを公開しますが、HTTP リクエストヘッダーは公開しません。
どのルートでシートを埋めますか?
easyCoexistence を経由してメッセージが届く番号には、2 つのルートがあり、それぞれ異なるニーズに応えます。Forward URL は番号ごとに一度設定すると、自動化が応答するかどうかにかかわらず、Meta の元のイベントを転送します。顧客からのメッセージ、WhatsApp Business アプリでチームが入力した返信、配信ステータスがそれに含まれます。メッセージのログを完全に残すためのルートです。自動化内の Call my webhook ステップは、その自動化が処理するメッセージだけで起動し、送信した返信を含む最近のチャットを渡します。1 つの自動化が扱うリード、注文、リクエストのシートに向いています。どちらも署名付きで、シークレットは異なります。
| Forward URL (per number) | Call my webhook step (per automation) | |
|---|---|---|
| Fires on | Any message event on the number, with or without automations | Only messages that automation is picked for |
| Carries | Meta's original value: messages, phone replies, statuses | The message, the contact and up to 10 recent messages |
| Automated replies | Delivery statuses only, without the text | In history, direction out |
| Retries | 7 attempts over about 33 hours | One attempt |
| Signed with | The number's forward secret, shown once | The automation's Signing secret |
| Set in | Number page, Where incoming messages go card | The automation editor, or create_automation |
どのフィールドが届き、シートにはどの列が必要ですか?
転送された POST は、Meta の変更 1 件を含みます。id(配信)、event(Meta のフィールド名。messages や smb_message_echoes など)、received_at、connection(番号の ID、phone、phone_number_id)、value が届き、value は Meta が送信したとおりの形式です。value の messages には顧客が書いたメッセージが、message_echoes には電話でチームが入力したメッセージが入ります。電話番号は国番号付きの数字で、プラス記号はありません。Sheets が数値に変換しないように、その列はプレーンテキストとして保存してください。WhatsApp のユーザー名を持つユーザーは、電話番号と並んで、あるいは電話番号の代わりに、ビジネス単位のユーザー ID と一緒に届くことがあるので、そのための列を用意してください。
n8n でメッセージログはどう作りますか?
ノードは 3 つです。HTTP Method が POST、Respond が Immediately に設定された Webhook ノードを作成し、その Production URL を番号の Forward URL として保存します。X-EC-Signature を転送用シークレットで検証し、イベントを行に変換する Code ノードを作成します。このとき配信ステータスは飛ばします。最後に Google Sheets ノードを作成します。操作は Append or Update Row、Column to match on は Message id に設定します。こうすると、再試行された配信は行を追加せず、同じ行を書き換えます。
転送用シークレットは、Forward URL を保存したときに一度だけ表示されます。紛失した場合は、New secret をクリックして新しいシークレットを貼り付けてください。n8n Cloud では Code ノードで crypto モジュールを使用できます。セルフホストの n8n では NODE_FUNCTION_ALLOW_BUILTIN=crypto が必要です。
const crypto = require('crypto');
const SECRET = 'whsec_...'; // the number's forward secret, shown once when you saved the Forward URL
const { headers, body } = $input.first().json;
const sig = /^t=(\d+),v1=([0-9a-f]{64})$/.exec(headers['x-ec-signature'] || '');
if (!sig || Math.abs(Date.now() / 1000 - Number(sig[1])) > 300) throw new Error('Bad or stale signature');
// n8n has parsed the body; it was sent as compact JSON, so JSON.stringify rebuilds the signed bytes.
const mac = crypto.createHmac('sha256', SECRET).update(sig[1] + '.' + JSON.stringify(body)).digest();
if (!crypto.timingSafeEqual(mac, Buffer.from(sig[2], 'hex'))) throw new Error('Bad signature');
const { event, connection, value } = body;
const names = Object.fromEntries((value.contacts || []).map((c) => [c.wa_id, c.profile?.name || '']));
const textOf = (m) => m.text?.body ?? m.button?.text ?? m.interactive?.button_reply?.title
?? m.interactive?.list_reply?.title ?? ('[' + m.type + '] ' + (m[m.type]?.caption || '')).trim();
const row = (m, direction, phone) => ({
time: new Date(Number(m.timestamp) * 1000).toISOString(), direction, phone,
user_id: m.from_user_id || '', name: names[phone] || '', text: textOf(m),
message_id: m.id, number: connection.phone,
});
let rows = [];
if (event === 'messages') rows = (value.messages || []).map((m) => row(m, 'in', m.from || '')); // statuses skipped
if (event === 'smb_message_echoes') rows = (value.message_echoes || []).map((m) => row(m, 'out', m.to || ''));
return rows.map((json) => ({ json }));連絡先ごとに 1 行を保つにはどうすればよいですか?
Contacts タブに 2 つ目の Google Sheets ノードを追加します。こちらも操作は Append or Update Row で、Phone で照合します。電話番号、プロフィール名、ユーザー ID、時刻、直近のメッセージのテキストをマップします。その番号からの最初のメッセージで行が作成され、以降のメッセージでは名前と最終連絡日の列が更新されます。こうすると、このタブは誰がいつ書き込んだかの一覧としても使えます。手書きのメモは、電話番号で検索できる別のタブに残しておけば、ワークフローが上書きすることはありません。
電話のアドレス帳に保存された連絡先は、この方法では届きません。Meta はそれらを最大 6 か月分のチャットとともに送信しますが、送信先は、番号を接続してから 24 時間以内に保存された直接の Webhook 送信先に限られます。
Apps Script でメッセージを直接受け取れますか?
きれいには受け取れないため、シートの前にワークフローツールを置いてください。Google は Apps Script のウェブアプリのレスポンスを、一度限りの script.googleusercontent.com の URL へのリダイレクトで返します。easyCoexistence はリダイレクトに従いません。302 は配信失敗として扱われ、転送は最大 7 回まで再試行されます。再試行のたびに doPost が再実行され、行が重複して書き込まれます。一方、Call my webhook ステップは失敗し、メールで通知します。さらに doPost はリクエストヘッダーを読めないため、そこでは X-EC-Signature の検証ができません。
Apps Script が適しているのは、逆方向、つまりシートの行から承認済みのテンプレートを送信する用途です。これは Google Sheets の連携ページでコードとともに説明しています。
代わりに Make や Zapier でシートを埋めることはできますか?
はい。Make では、シナリオを Webhooks > Custom webhook で開始し、Google Sheets > Add a Row を追加します。Zapier では、ヘッダーを保持する Webhooks by Zapier の Catch Raw Hook を使用し、その後に Google Sheets > Create Spreadsheet Row を続けます。どちらも POST に即座に 2xx で応答します。これは転送が 10 秒以内に必要とするものです。上記と同じフィールドを value.messages からマップし、value に messages ではなく statuses が含まれるイベントはフィルターで除外してください。
フックの URL はパスワードとして扱ってください。その URL を知っている人は誰でも行を投稿できるためです。お使いのプランにコードステップが含まれている場合は、そこで n8n ノードと同じ HMAC の手順を使い、X-EC-Signature を検証してください。
重複行や欠落行をどう防ぎますか?
重複は再試行から生じます。10 秒以内に 2xx を受け取れなかった転送は、同じ X-EC-Delivery ヘッダーと本文の同じ id で再送されます。その中のメッセージは wamid を保持するため、Message id で照合すれば再試行は無害です。Webhook ステップのルートでは、Try it からのテストは dry_run が true で届きます。テスト用のタブに振り分けるか、破棄してください。
欠落行は Google の書き込み上限から生じます。Sheets API は、ユーザーごと、プロジェクトごとに 1 分あたり 60 件の書き込みリクエストを許可しており、n8n の認証情報 1 件は 1 ユーザーとして扱われます。テンプレートキャンペーンの後に返信が一斉に届くと、この上限を超えて HTTP 429 が返されることがあります。Google Sheets ノードの設定で Retry On Fail をオンにするか、メッセージを数秒まとめて 1 回のリクエストで追加してください。
設定方法
- Check the number's modeOn the number's page, the card Where incoming messages go must show Through easyCoexistence. If it shows Straight to your system, choose Through easyCoexistence.
- Build the workflowWebhook node (POST, Respond Immediately), the Code node above, then Google Sheets with Append or Update Row matched on Message id. Activate it and copy the Production URL.
- Save the Forward URLPaste the Production URL into Forward URL (optional) and click Save forward URL. Copy the signing secret shown once into the Code node.
- Send a test messageFrom another phone, write to your number and reply to it from the WhatsApp Business app. Two rows should appear: one in, one out.
よくある間違い
- 転送を、自動化の Signing secret で検証してしまうこと、またはその逆です。Forward URL は番号の転送用シークレットで署名され、Call my webhook はその自動化自身のシークレットで署名されます。X-EC-Event ヘッダーでシークレットを選んでください。
- キーを設定せずに POST ごとに行を追加すること。応答が遅れて再試行された配信は、同じメッセージを 2 回書き込みます。Message id で照合する Append or Update Row を使ってください。
- 配信ステータスをメッセージとして書き込むこと。messages イベントには、value.statuses に sent、delivered、read のステータスも含まれます。これらにはテキストがなく、空の行を作ってしまいます。
- Apps Script のウェブアプリ URL を Forward URL として保存すること。そのリダイレクトは失敗として扱われ、7 回の試行ごとに doPost が再実行されて重複行が追加されます。
自動化を有効にすると、Forward URL が Meta の元のイベントをワークフローに転送します。このイベントはあなたしか持たないシークレットで署名され、URL が停止しているときには再試行されます。また、Call my webhook ステップは、自動化が処理した内容をその返信とともに送信します。どちらもプランに含まれています。料金は接続済みの番号 1 件あたり月額 US$ 9 から、番号を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。
よくある質問
チームが電話で入力したメッセージも、シートに記録されますか?
はい、Forward URL を通じて記録されます。WhatsApp Business アプリで入力された返信は smb_message_echoes イベントとして届き、to に顧客の番号が入ります。自動化が送った返信は配信ステータスとしてしか戻ってこないため、返信の後に置いた Call my webhook ステップから、その本文を記録してください。
既存のチャットをシートに読み込めますか?
easyCoexistence を経由してメッセージが届く番号では読み込めません。Meta が 1 対 1 の既存チャットを最大 6 か月分送信するのは、接続から 24 時間以内に保存された直接の Webhook 送信先に対してのみで、接続ごとに一度だけです。easyCoexistence を経由する番号は、Forward URL を保存した時点から記録を始めます。
easyCoexistence はメッセージのコピーを保存しますか?
一部のみ保存します。easyCoexistence を経由し、自動化を有効にした番号では、メッセージ本文はあなたが選んだ期間(30 日、90 日、365 日から選択、既定は 90 日)保持され、「会話」に表示されます。転送された配信は再試行のために最大 7 日間、実行ログは 30 日間保持されます。シートが、あなたの恒久的なコピーになります。
AI がシートを読んで顧客に答えることはできますか?
「Reply with AI」ステップからは読めません。このステップが読むのは、その Instructions とチャットだけです。AI エージェントはカスタム HTTP ツールを通じて情報を調べることができ、Call my webhook ステップまたは Call an API ステップから質問をワークフローに送り、そのワークフローがシートで答えを探して返信として返すようにできます。
続きを読む
始める準備はできましたか?
WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める確認日