Embedded Signup と Coexistence で SaaS に WhatsApp を追加する方法
SaaS は、Embedded Signup と Coexistence を通じて顧客ごとの既存の番号を接続することで WhatsApp を追加します。これにより、番号は WhatsApp Business アプリでも引き続き使えます。easyCoexistence の Partner API を使うと、顧客ごとに 1 件の接続セッションで、ホスト型ページ上でこの流れを実行できます。Meta は番号宛てのメッセージを webhook_url に届け、バックエンドは顧客自身のトークンを使って Cloud API から返信します。
WhatsApp Business アプリと Cloud API の両方で使われている番号の固定スループットです。
Coexistence で顧客の番号を接続できる、WhatsApp Business アプリの最も古いバージョンです。
オンボーディング時に Meta が共有できるチャット履歴の遡れる期間です。24 時間以内に同期しなければなりません。
ユーザーのメッセージや通話の後に開く、WhatsApp のカスタマーサービスウィンドウです。新しいメッセージのたびにリセットされます。
Meta が Embedded Signup v2 と v3 を非推奨にした日付です。連携は v4 に移行しています。
WhatsApp 連携は何で構成されていますか?
5 つあり、easyCoexistence は最初と最後を担当します。会話のロジック、受信トレイ、モデルや顧客のスタッフが書いた内容は、お使いの製品が担当します。番号とサーバーの間のメッセージは、Meta が運びます:
Coexistence は顧客に何をもたらしますか?
顧客は番号と電話をそのまま使えます。WhatsApp Business アプリは Cloud API と並行して動き続けるため、スタッフは電話で返信し、お使いの製品は API 経由で返信します。アプリから送った内容は smb_message_echoes として Webhook に届きます。これには 3 つの制限が伴います:番号は毎秒 20 メッセージの固定速度で送信されます。テンプレートを送れるのは API だけです。電話が約 14 日間使われないと、Meta は番号の接続を切断します。
お使いの製品での接続ステップはどのようになりますか?
バックエンドから POST /connect-sessions を呼び出す「接続する」ボタンを用意します。リクエストには redirect_url を含め、顧客の ID を external_ref として渡し、webhook_url と webhook_verify_token も含めます。これにより、接続の最初の 1 分から Meta が番号をお使いの製品に振り分けるようになります。顧客はホスト型ページで短いチェックリストを確認し、Meta のポップアップを実行し、WhatsApp Business アプリで QR コードを読み取ります。その後、connection_id を持って製品に戻ります。代わりに自社の Tech Provider アプリから Embedded Signup を実行するかどうかは、Embedded Signup ガイドで検討できます。
メッセージはバックエンドにどう届きますか?
Meta から webhook_url に直接届きます。easyCoexistence を経由することも、コピーを保存することもありません。messages フィールドには顧客が送った内容と、お使いの製品が送信したメッセージのステータスが含まれます。smb_message_echoes には、スタッフがアプリから送った内容が含まれます。Meta は各配信に easyCoexistence のアプリシークレットで署名します。このシークレットは共有されないため、URL パスに入れた長くランダムなシークレットで認証します。1 つの WhatsApp Business Account に含まれる 2 つの番号は送信先を共有します:value.metadata.phone_number_id でルーティングしてください。
バックエンドはどのように返信とテンプレート送信を行いますか?
Meta の Graph API と、GET /connections/{id}?credentials=1 から取得する顧客のトークンを使います。このレスポンスには send_endpoint も含まれます。フリーテキストは、相手からの最後のメッセージから 24 時間以内に送れます。それ以降は、Meta が承認済みのテンプレートだけを送信できます:
- 返信:ウィンドウ内で、type を text にして POST /<
PHONE_NUMBER_ID>/messages を呼び出します。 - テンプレート:同じ呼び出しで、type を template にし、テンプレート名と言語コードを指定します。
- テンプレートの作成:POST /<
WABA_ID>/message_templatesを呼び出してから、ステータスをポーリングします。審査結果はwebhook_urlに届かないためです。 - メディア:POST /<
PHONE_NUMBER_ID>/media でアップロードします。受信したメディアは ID として届くため、同じトークンで取得します。
curl -X POST "$SEND_ENDPOINT" \
-H "Authorization: Bearer $CUSTOMER_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "5511987654321",
"type": "text",
"text": { "body": "Your table for 4 is booked for 8 pm." }
}'お使いの製品で顧客の既存のチャットを取り込めますか?
接続時に 1 回だけ可能です。セッションに webhook_url を設定すると、easyCoexistence は Meta に番号の連絡先と、顧客がアプリで同意した場合は最大 180 日分のチャットを送るよう依頼します。これらは smb_app_state_sync と history の Webhook として届きます。Meta は接続から 24 時間以内に限り許可するため、リンクを送る前にエンドポイントが応答している状態にしてください。ペイロードの詳細は、チャット履歴のガイドで解説しています。
Meta への料金は誰が支払いますか?
顧客です。お使いのバックエンドが API 経由で送るメッセージの料金は、顧客自身の WhatsApp Business Account に請求されます。支払い方法は顧客がそのアカウントに追加します。支払い方法がない企業は、マーケティングテンプレートを送信できません。easyCoexistence は、接続済みの番号ごとにお使いのアカウントに課金します。メッセージ料金を請求することも、Meta の料金に上乗せすることもありません。
番号が切断されたときはどうなりますか?
お使いのイベント URL に connection.disconnected が届き、判明している場合は Meta の理由が含まれます。PRIMARY_INACTIVITY は 14 日間ルールによるものです。その顧客で新しい接続セッションを作成すると、同じ番号が戻ります。connection.token_missing は、番号が顧客のトークンなしで接続されたことを意味します。その場合、番号はメッセージを受信できますが、新しいセッションで再接続されるまで送信できません。
よくある間違い
- Webhook エンドポイントが応答する前に接続リンクを送ることです。履歴の取り込みは接続から 24 時間以内に 1 回だけ実行され、URL が機能する前に送られた内容は失われます。
- ウィンドウが閉じた後にフリーテキストで返信することです。相手の最後のメッセージから 24 時間が経過すると、承認済みのテンプレートだけが届きます。
- 1 つの番号から全速力でキャンペーンを配信することです。Coexistence の番号は毎秒 20 メッセージで送信するため、番号ごとの送信はその速度でキューに入れてください。
- スタッフが電話からテンプレートを送ると期待することです。Coexistence では API だけがテンプレートを送信できるため、テンプレート送信は製品側に組み込んでください。
easyCoexistence は、お使いの名前が表示されるホスト型ページで、Meta の Embedded Signup と Coexistence を使い SaaS に WhatsApp を追加します。顧客は番号と WhatsApp Business アプリをそのまま使え、Meta はメッセージをサーバーに届け、切断の通知も署名付きイベントとして届きます。同じ API で Instagram、Facebook、TikTok、YouTube、LinkedIn などのチャネルも接続できます。接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。
よくある質問
別の WhatsApp API プロバイダーに登録されている番号を、顧客は接続できますか?
そのプロバイダーに登録されたままでは接続できません。ホスト型のチェックリストでは、他の API プロバイダーや自動化ツールが設定されていない番号を求めています。そのため、顧客はまずそのプロバイダーで番号を切断します。
お使いの SaaS は、その顧客のために WhatsApp テンプレートを送信できますか?
はい。各顧客のトークンを使い、Cloud API 経由で送信できます。顧客の WhatsApp Business Account でテンプレートを作成し、Meta の審査を待ってから送信します。
easyCoexistence は、顧客の WhatsApp メッセージを読み取りますか?
いいえ。Meta は番号のメッセージを、お使いが設定した webhook_url に直接届けます。webhook_url のない番号は easyCoexistence のコールバックにフォールバックし、そこではメッセージは保存されずに破棄されます。
easyCoexistence は WhatsApp の番号 1 件あたりいくらですか?
番号 1 件あたり月額 US$ 9 から US$ 0.75 までで、お使いの接続総数による料金帯で決まります。最初の 3 日間は無料トライアルです。Meta のメッセージ料金は、それぞれの顧客の WhatsApp Business Account に請求されます。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日