WhatsApp のメッセージを Airtable に記録し、ベースから送信する

Airtable で WhatsApp の Webhook を直接受け取れないのはなぜですか？

Meta は、メッセージを配信する前に送信先を確認するためです。チャレンジ値を付けた GET リクエストを送り、同じ値がレスポンスボディとして返ることを求めます。Airtable の「When webhook received」トリガーは POST リクエストしか受け付けず、固定の JSON を返すため、この確認は通らず、Meta は配信を開始しません。

解決策は、間に 1 つ手順を挟むことです。n8n の Webhook ノードが認証を処理して各メッセージを受信し、n8n の Airtable ノードが 1 行を追加します。記録する内容は、送信者、プロフィール名、本文、メッセージ ID、タイムスタンプ、受信側の電話番号 ID です。Make や Zapier でも同じ構成で動きます。

間に挟む手順には、もう 1 つ利点があります。Airtable の Webhook トリガーは 1 秒あたり 5 リクエストまでですが、ワークフローツールならバーストをキューに溜められるため、拒否されるはずだったリクエストも処理できます。

Airtable のベースから WhatsApp テンプレートを送信するには？

アクションに Run a script を指定したオートメーションを使います。トリガーには、レコードがビューに入ったとき、フィールドが変更されたとき、ボタンがクリックされたときのいずれかを選べます。スクリプトは input.config() でレコードの電話番号とフィールドを読み取り、fetch で Cloud API の messages エンドポイントを呼び出します。Airtable のオートメーションスクリプトはサーバー側で実行されるため、ブラウザの制約は受けません。

アクセストークンはコードに書かず、スクリプトエディタのシークレットとして保存してください。Airtable はコンソール出力からシークレットを伏せ字にし、スクリプトのすべてのシークレットにアクセスできるユーザーだけが編集できます。

お客様から直近 24 時間以内にメッセージがない場合は、必ずテンプレートを使ってください。フリーテキストが届くのは、この 24 時間の枠内だけです。スクリプトから返されたメッセージ ID をレコードに書き戻せば、送信と行を結び付けられます。

const { phone, name } = input.config();
const token = input.secret("WHATSAPP_TOKEN");
const res = await fetch(
  "https://graph.facebook.com/v23.0/<PHONE_NUMBER_ID>/messages",
  {
    method: "POST",
    headers: { Authorization: "Bearer " + token, "Content-Type": "application/json" },
    body: JSON.stringify({
      messaging_product: "whatsapp",
      to: phone,
      type: "template",
      template: {
        name: "order_ready",
        language: { code: "en" },
        components: [{ type: "body", parameters: [{ type: "text", text: name }] }],
      },
    }),
  },
);
output.set("result", await res.json());

メッセージ用のテーブルはどう設計すればよいですか？

メッセージ 1 件につき 1 行とし、WhatsApp のメッセージ ID を主フィールドにします。Meta は失敗したと判断した配信を再試行しますが、追加の前に ID を検索するワークフローなら、同じメッセージを二重に書き込むことはありません。

方向を示すフィールドを用意し、inbound と outbound を記録します。Coexistence の番号では、チームが WhatsApp Business アプリで入力した返信も、smb_message_echoes イベントとして同じ Webhook に届きます。これを outbound の行として記録すれば、ベースには片側だけでなく会話の全体が残ります。

各メッセージは、数字のみの電話番号をキーにした Contacts テーブルにリンクします。これは Meta が送ってくる形式です。ロールアップを使えば連絡先ごとの最終受信時刻が分かり、オートメーションがフリーテキストとテンプレートのどちらを使うかを判断するには、このフィールド 1 つで足ります。

よくある間違い

• Airtable の Webhook URL を番号の送信先に設定する。POST しか受け付けないため Meta の認証用 GET が失敗し、何も配信されません。
• アクセストークンをスクリプト本体に貼り付ける。スクリプトのシークレットとして保存すれば、コードにもログにも残りません。
• 24 時間以内に連絡のない相手へ、レコードのオートメーションからフリーテキストを送る。届くのは承認済みのテンプレートだけです。

よくある質問

続きを読む