Coexistence 番号の WhatsApp 会話を Salesforce に送る

n8n のワークフローはどのような構成ですか？

4 つのノードを一列に並べ、Meta のすべての Webhook に必要な認証ブランチを加えた構成です。

まず Webhook ノードが、メッセージごとに Meta から送られる POST を受け取ります。次に Salesforce ノードが、phone が送信者と一致するリードまたは取引先責任者を SOQL クエリで検索します。IF ノードで結果の有無を分岐し、見つかった場合はレコード ID をそのまま次へ渡します。見つからない場合は、ペイロードのプロフィール名でリードを作成する Salesforce ノードに進みます。最後の Salesforce ノードが、そのレコードに ToDo を作成します。説明欄にメッセージ本文を入れ、件名には WhatsApp メッセージであることを記します。

認証ブランチは、Meta の GET リクエストに対して hub.challenge の値をそのまま本文として返します。これがないと Meta は配信を開始せず、残りのワークフローは動きません。

メッセージは ToDo とメモのどちらに記録すべきですか？

多くのチームには ToDo をお勧めします。営業担当者がすでに見ている活動タイムラインに表示され、レポートにも使えるためです。状況を完了にしておけば未完了の ToDo として表示されません。件名にチャネル名を入れておけば、WhatsApp の活動を絞り込む条件は 1 つで済みます。

n8n ノードの「Add note」操作は、別の用途に向いています。メッセージごとではなく要約を残したい場合です。1 日分のメッセージを連絡先ごとにまとめ、夜に 1 件のメモとして書き込むワークフローもあります。お客様が短い文を 20 通送ってきても、タイムラインが読みやすいままです。

どちらを選ぶ場合も、WhatsApp のメッセージ ID をレコードに書き込んでください。Meta は配信を再試行するため、書き込む前に既存の ID を確認すれば、同じメッセージを二重に記録することはありません。

電話からの返信は引き続き可能ですか。また Salesforce に反映されますか？

どちらも可能です。Coexistence では同じ番号で WhatsApp Business アプリが使い続けられるため、これまでお客様に返信していた担当者はそのまま対応できます。アプリから返信すると、Meta は送信メッセージのエコーを同じ Webhook の宛先に、smb_message_echoes フィールドとして送ります。

ワークフローにこのエコー用の 2 つ目の経路を追加し、送信側の ToDo として記録します。リードを開いた担当者には、お客様の質問と店舗側の回答が順番に表示され、チャットを手作業でコピーする必要はありません。

ワークフロー自身が Cloud API に対して HTTP Request ノードで送る返信は、送信した時点で記録してください。その時点で、本文とレコード ID はすでにワークフローの手元にあります。

リードの重複を防����にはどうすればよいですか？

入力されたままの項目ではなく、正規化した電話番号で照合します。Meta は送信者を、国番号を含みプラス記号のない数字だけで送ってきます。一方、Salesforce の電話項目には、レコードを作成した人が入力した内容がそのまま入っており、スペースやかっこ、ハイフンが含まれます。

確実なのは、数字だけの番号を保持するカスタムのテキスト項目を用意する方法です。ワークフローがリードを作成するときにその項目を埋め、既存のレコードにはバックフィルで値を入れます。SOQL クエリはこの項目を完全一致で比較するため、高速かつ正確です。

リードだけでなく取引先責任者も検索してください。すでに成約したお客様は取引先責任者になっています。リードしか検索しないワークフローでは、既存のお客様が連絡してくるたびに新しいリードが作られてしまいます。

よくある間違い

• Lead オブジェクトだけを検索している。既存のお客様は取引先責任者なので、連絡のたびに重複したリードが作られます。
• メッセージを未完了の ToDo として記録している。お客様の発言ごとに担当者へ ToDo が発生するので、作成時に状況を完了にしてください。
• ワークフローで認証用の GET ブランチを省略している。Meta が宛先を確認できず、メッセージは一切配信されません。

よくある質問

続きを読む