Coexistence リファレンス

概要

Meta の公式モードで、1 つの電話番号上で WhatsApp Business アプリと Cloud API を同時に実行できます。別の API ではありません。同じ Cloud API を、オンボーディング後もその番号でアプリが動作するように設定します。

チームが利用する理由

ほぼすべての接続は、次の 4 つの理由で説明できます。

• 車両、領収書、Web サイトにすでに掲載している番号を維持できます。
• 新しいツールへ移行せずに、API 送信、Webhook、テンプレートを追加できます。
• 会話をプロバイダーの共有インボックスの外に保てます。
• 代理店が多数の顧客番号を、それぞれ顧客自身のポートフォリオに保持できます。

通信の仕組み

両方の画面で同じスレッドを確認できます。API から送信した内容はアプリに表示されます。チームがアプリで入力した内容は smb_message_echoes イベントとしてソフトウェアに届くため、人が返信した後に自動化が返信するのを防げます。

料金の仕組み

Meta はメッセージではなく会話に料金を設定し、ユーザー自身の WhatsApp Business Account の支払い方法に請求します。24 時間のカスタマーサービスウィンドウ内の返信は無料です。ウィンドウ外で会話を開始するにはテンプレートが必要で、料金が発生します。

リンク済みデバイス

Coexistence はリンク済みデバイスではなく、それを使用しません。リンク済みデバイスは別の場所でサインインしたコンシューマークライアントで、非公式ツールが自動化に使い、WhatsApp の規約で禁止されている仕組みです。ここでは、この仕組みを一切使用しません。

機能上の制限

Meta によって固定されており、すべてのプロバイダーで同じです。

• グループチャットは API では利用できません。
• テンプレートは電話アプリから送信できず、API 経由でのみ送信できます。
• 送信スループットは、品質やティアに応じて拡大せず固定されています。
• チャット履歴の共有は、オンボーディング中に一度だけ決定されます。

利用条件

接続するには、番号が事前に次の条件をすべて満たしている必要があります。

• コンシューマーアプリではなく、すでに WhatsApp Business アプリで有効になっていること。
• アクセス権のある Business Portfolio に含まれていること。
• 別のプロバイダーのアプリにすでに接続されていないこと。

運用上の注意

接続後に適用され、見落としやすい事項です。

• アプリを定期的に開かないと、Meta が API 側を切断します。
• 切断すると、アプリとともに Webhook のオーバーライドもアンインストールされます。
• 品質評価はプッシュ通知ではなくポーリングで取得するため、低下しても通知されません。
• 2 つ目の認証情報がない場合、失効したトークンは削除された番号と同じように見えます。

アカウント選択に関する注意

Embedded Signup では、Business Portfolio と WhatsApp Business Account を別々の手順で選択します。誤ったアカウントを選ぶと、意図しない場所に番号が関連付けられます。その後に移動するには、切断して最初からフローをやり直す必要があります。

一度きりの決定

既存のチャット履歴を共有するかどうかは一度だけ尋ねられ、後から変更できません。また、同期はオンボーディングから 24 時間以内に開始する必要があり、一度しか実行できません。どちらも、期限を逃すと警告ではなく、分かりにくいエラーが表示されます。

切断または元に戻す方法

番号は、ダッシュボードまたはコネクターからいつでも切断できます。WhatsApp Business アプリは、会話と履歴を保持したまま、以前とまったく同じように動作します。接続したことによって、番号自体が恒久的に変更されることはありません。

よくある間違い

• Coexistence を別の API として扱うこと。実際には、オンボーディング方法が異なる Cloud API です。
• グループチャットを中心に設計すること。すべてのプロバイダーで対象外です。
• 再接続すれば Webhook の送信先が復元されると考えること。復元されません。

よくある質問

続きを読む