ログイン無料トライアルを開始
Meta Tech Provider

WhatsApp のメッセージと連絡先を Google スプレッドシートに自動保存

WhatsApp Business のメッセージを Google スプレッドシートに自動で保存するには、署名付きの HTTP POST を n8n、Make、Zapier などの自動化ツールに送り、そのツールの Google Sheets ステップでメッセージごとに 1 行追加します。行には、時刻、方向、電話番号、名前、テキスト、メッセージ ID を記録します。電話番号をキーにした 2 つ目のタブで、連絡先ごとに 1 行を保ち、再びメッセージが届くとその行を更新します。

easyCoexistence は、アプリで使っている WhatsApp Business の番号を、Coexistence を通じて Meta の Cloud API に接続します。

7 attempts

お使いの URL への配信が失敗した場合、転送された配信は約 1、5、30、120、360、1,440 分後に再試行されます。

10 s

転送された POST が 2xx のレスポンスを待つ時間。この時間を過ぎると、その配信は再試行されます。

60 / min

Google Sheets API の書き込みリクエストには、1 分あたり、ユーザーごと、プロジェクトごとの上限があり、プロジェクト全体では 300 件です。

Redirect

Apps Script のウェブアプリの出力は、script.googleusercontent.com の一度限りの URL にリダイレクトされます。

No headers

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 onAny message event on the number, with or without automationsOnly messages that automation is picked for
CarriesMeta's original value: messages, phone replies, statusesThe message, the contact and up to 10 recent messages
Automated repliesDelivery statuses only, without the textIn history, direction out
Retries7 attempts over about 33 hoursOne attempt
Signed withThe number's forward secret, shown onceThe automation's Signing secret
Set inNumber page, Where incoming messages go cardThe 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 と一緒に届くことがあるので、そのための列を用意してください。

Timemessages[].timestamp, Unix seconds, converted to a date
Directionin for messages, out for smb_message_echoes
Phonemessages[].from, or message_echoes[].to for your replies
User IDmessages[].from_user_id, the BSUID, when Meta sends it
Namecontacts[].profile.name, the customer's WhatsApp profile name
Texttext.body, a button's text, or [image] with its caption
Message idmessages[].id, the wamid: the key that stops duplicates
Your numberconnection.phone, to tell several numbers apart

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 が必要です。

n8n Code node (Run Once for All Items): verify a forward and return rows
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 回のリクエストで追加してください。

設定方法

  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.
  2. 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.
  3. 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.
  4. 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 が再実行されて重複行が追加されます。
EasyCoexistence で実現する

自動化を有効にすると、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 の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。

無料トライアルを始める

確認日