Coexistence の番号での WhatsApp グループと API

WhatsApp には Groups API がありますか？

はい、あります。Meta の Groups API を使うと、企業は Cloud API の番号でグループの作成、一覧取得、更新を行い、テキスト、メディア、メッセージテンプレートをグループに送信できます。招待リンクの管理、参加リクエストの承認と拒否、参加者の削除にも対応しています。

機能はあえて小さく作られています。グループは招待制で、企業が送るリンクから参加します。Meta の上限を見ると、コミュニティというよりプロジェクトルームに近い規模です。

• 1 グループあたり最大 8 人まで参加できます。
• 1 つの企業の番号につき最大 10,000 グループまで作成できます。
• 1 グループにつき Cloud API の企業は 1 社です。
• テキスト、メディア、テキスト形式のメッセージテンプレート、メディア形式のメッセージテンプレートを送れます。

Coexistence の番号でも使えますか？

いいえ、使えません。Groups API のページには、WhatsApp Business アプリの電話番号では利用できないと記載されています。この表現は、WhatsApp Business アプリのユーザーをオンボーディングするための Meta 自身のガイドにリンクしており、それがまさに Coexistence です。また利用条件は公式ビジネスアカウントであることですが、Meta の公式ビジネスアカウントのページによれば、WhatsApp Business アプリの電話番号にはこのステータスが付与されません。

つまりこの除外は、すべてのプロバイダーに対して Meta が定めたものです。アプリと API で共有している番号では、API からグループを作成することも、グループに送信することもできず、グループのイベントも届きません。

アプリにある既存のグループはどうなりますか？

アプリに残り、これまでどおり使えます。Meta の Coexistence のドキュメントでは、番号のオンボーディング時に同期されないものとしてグループチャットが挙げられています。そのため、履歴も新しいグループメッセージも API には届きません。

スマートフォンを使うチームは、これまでと同じようにグループを作成し、投稿し、読めます。ソフトウェアからはそのやり取りが見えないだけです。スタッフ同士の配送の調整など、グループに依存する業務はアプリ内で続けられます。その周辺の自動化は、1 対 1 の会話をもとに組み立てる必要があります。

API 経由のグループの代わりに何を使えばよいですか？

1 対 1 の会話です。このプラットフォームはそれを前提に作られています。グループ宛てに送るはずだったメッセージは、お客様一人ひとりに個別に送ります。24 時間のカスタマーサービスウィンドウ内ならフリーテキストで、ウィンドウ外なら承認済みのメッセージテンプレートで送信します。

API で管理するグループがどうしても必要な場合、Groups API には、Cloud API のみに登録され、公式ビジネスアカウントを持つ番号が必要です。つまりその番号は Coexistence をやめることになります。これは回線の構成に関わる判断であり、設定では切り替えられません。そして回線からアプリがなくなります。

よくある間違い

• Groups API が存在すると知って、Coexistence の番号にも使えると思い込むこと。Meta は WhatsApp Business アプリの番号を除外しています。
• オンボーディング後にグループの履歴が API に表示されると期待すること。グループチャットは同期されません。
• 参加者 8 人という上限に合うかを確かめないまま、グループ前提の業務フローを計画すること。

よくある質問

続きを読む