Coexistence 番号で WhatsApp を Activepieces に接続する
Activepieces には WhatsApp Business ピースがあり、アクセストークンと WhatsApp Business アカウント ID で接続します。この 2 つは Coexistence 番号から取得できます。New Incoming Message トリガーは Meta の認証に自ら応答するため、その URL を番号の Webhook 送信先にそのまま使えます。ピースの任意項目であるアプリシークレットは空のままにしてください。フローはすべてのメッセージで実行され、チームはこれまでどおりスマートフォンで対応を続けられます。
Activepieces の WhatsApp Business ピースのアクションには、テキスト、メディア、メッセージテンプレート、インタラクティブメッセージの送信が含まれ、トリガーは 4 種類あります。
ピースのトリガーはこのクエリパラメーターを検出し、その値をプレーンテキストで返すことで、Meta の認証を完了させます。
ピースのアプリシークレット欄です。入力すると、X-Hub-Signature-256 が一致しない配信は無視されます。
Coexistence 番号を Activepieces に接続するには？
Activepieces で WhatsApp Business の接続を作成し、アクセストークンと WhatsApp Business アカウント ID の 2 つを入力します。どちらも EasyCoexistence のダッシュボードで確認でき、アシスタントからは get_api_credentials で取得できます。ピースの案内には Meta アプリとシステムユーザーの作成手順がありますが、これはどちらも持っていない場合を想定したものです。この番号はすでに接続済みなので、値を貼り付けるだけで済みます。
次に、New Incoming Message トリガーから始まるフローを作り、任意の検証トークンを設定して、フローを公開します。トリガーの Webhook URL を、EasyCoexistence の番号の Webhook 送信先に、同じ検証トークンとともに設定してください。Meta が認証リクエストを送り、トリガーが応答すると、その番号へのメッセージごとにフローが実行されます。
アプリシークレットを空にしておくのはなぜですか？
これらの配信に署名するシークレットは、お客様が貼り付けられるものではないからです。Meta はサブスクリプションを持つアプリのアプリシークレットで Webhook に署名します。EasyCoexistence 経由で接続した番号では、それは EasyCoexistence アプリであり、そのシークレットが共有されることはありません。
ピースではこの欄は任意です。空のままなら、トリガーは届いた配信をそのまま受け付けます。他のアプリのシークレットを入れると、すべての配信が X-Hub-Signature-256 の検証に失敗して黙って無視され、メッセージが届かないのと全く同じ状態に見えます。
検証トークンは、第三者がハンドシェイクに入り込むのを防ぐものです。長いランダムな値を選び、フローを起動するアドレスであるトリガー URL は非公開にしてください。
メッセージが届いたあと、フローでは何ができますか？
トリガーは、送信者、プロフィール名、メッセージ ID、種類、テキスト、メディア ID、ボタンやリストの返答、受信した電話番号 ID を平坦化した形でフローに渡します。そこから先は通常の Activepieces のフローで、CRM、スプレッドシート、AI ステップなど他のピースと組み合わせられます。
返信にも同じピースを使います。Send Message はフリーテキストを送りますが、お客様の最後のメッセージから 24 時間以内にしか届きません。Send Template Message は承認済みのメッセージテンプレートを送り、この時間枠を過ぎたあとに届けられるのはこれだけです。インタラクティブボタン、リスト、メディア、位置情報、リアクションは、それぞれ独立したアクションです。
Activepieces の案内にもあるとおり、Meta はアプリごとにコールバック URL を 1 つしか受け付けません。番号ごとの送信先でも上限は番号あたり 1 つの URL なので、複数の種類のイベントを扱うフローは、1 つのフロー内で分岐させてください。
スマートフォンで入力した返信はフローに届きますか？
Webhook には届きますが、このトリガーでは受け取れません。Coexistence 番号では、WhatsApp Business アプリで入力した返信のエコーを、Meta が smb_message_echoes フィールドで同じ送信先に送ります。ピースの New Incoming Message トリガーは messages フィールドだけを読み取り、それ以外は破棄します。
スマートフォンからの返信をフローで扱いたい場合は、代わりに Activepieces の汎用 Webhook ピースでフローを開始してください。このピースは任意の HTTP メソッドを受け付けます。認証の GET には、同期 URL 上の Return Response ステップで応答します。その場合、生のペイロードは自分で解析することになり、両方のフィールドが含まれます。
ほとんどのフローでは、ピースのトリガーのほうが簡単です。お客様からのメッセージに反応し、チームの返信はスマートフォンのアプリで引き続き確認できます。
よくある間違い
- アプリシークレットを WhatsApp の接続に貼り付けてしまう。配信は EasyCoexistence アプリのシークレットで署名されるため、すべて無視されます。
- フローを公開する前に送信先を設定してしまう。Meta は即座に認証を行い、未公開のフローは応答できません。
- New Incoming Message トリガーで、スマートフォンで入力した返信も受け取れると思い込む。このトリガーが読むのは messages フィールドだけで、smb_message_echoes は対象外です。
easycoexistence.com で番号を接続し、そのトークンと WABA ID を Activepieces に貼り付け、Webhook の送信先にトリガー URL を設定します。料金は接続済みの番号 1 件あたり月額 US$ 9 から、番号を追加するほど US$ 1 まで。最初の 3 日間は無料です。
よくある質問
セルフホストの Activepieces でも使えますか？
はい。ピースはオープンソースで、Activepieces のクラウドでもセルフホストでも動作します。ただし、インスタンスがインターネットから HTTPS で到達できることが条件です。
フローはどの電話番号から送信しますか？
アクションの電話番号欄で選んだ番号です。この欄には、接続先の WhatsApp Business アカウントにある番号が一覧表示されます。
同じ番号で n8n や Make も使えますか？
同時には使えません。Meta は 1 つの番号の Webhook を 1 つの送信先にしか送らないため、受信するツールを 1 つ選ぶか、そこから他方へ転送してください。
EasyCoexistence はメッセージを保存しますか？
いいえ。Meta が各 Webhook を Activepieces のトリガーに直接届けるため、EasyCoexistence が会話の内容を保存することはありません。
続きを読む
始める準備はできましたか？
WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める確認日