Your AI Connector Docs

WhatsApp Business API

公式のWhatsApp Business APIを通じて、ビジネスをWhatsAppに接続します。このチャネルは、事前承認済みのメッセージテンプレートや配信追跡機能を備えた、信頼性の高い大量のWhatsAppメッセージングを必要とするビジネスに推奨される選択肢です。

Twilioアカウントを別途作成する必要はありません。 Twilioは、WhatsAppメッセージを裏側で配信する電話およびメッセージングサービスです。このプラットフォームは、内部で管理されたTwilioアカウントを自動的に作成するため、ユーザー自身でTwilioに登録したり、Metaと手動で連携させたりする必要はありません。電話番号の購入や既存の番号の接続は、すべてアプリ内で行われます。独自のTwilioアカウントを使用する必要がある場合(例:すでにウォームアップ済みの番号や承認済みのテンプレートがある場合)、チャネルページのTwilioアカウントカードを開いて独自のアカウントに切り替え、既存の送信元を接続してください。両方の手順については、SMSプロバイダー(独自のTwilioを使用)を参照してください。ほとんどのユーザーは、管理されたセットアップのまま利用することをお勧めします。


前提条件

開始する前に、以下のものを用意してください。

  • Metaビジネスアカウント (business.facebook.com) — ビジネス認証は任意です。未認証のビジネスでも、電話番号の有効化、テンプレートの承認、ブロードキャストの送信が可能で、24時間あたり250件のユニークコンタクトという制限から開始されます(以下のメッセージング制限を参照)。**「当社による管理 (Managed by us)」**の場合もこれが必要です。そのオプションでは電話番号の提供とメッセージの配信を行いますが、電話番号自体は引き続きお客様自身のWhatsApp Businessアカウントに属するため、Metaのポップアップ画面で設定を完了させる必要があります。Metaアカウントを一切使用せずにWhatsAppを接続する唯一の方法はWhatsApp Webです。
  • 十分なクレジットがあるアカウント
  • WhatsApp(個人用またはBusinessアプリ)にまだ登録されておらず、他のアカウントのTwilio番号でもない電話番号

最初にビジネス名と住所を追加してください。 最初の電話番号を購入する前に、設定 → ビジネス(ワークスペースグループ)でビジネス名と住所を入力してください。通信事業者がこの住所を検証するため、正確かつ完全に入力してください。設定されるまで購入は失敗します。一部の国では、その国内の住所のみを受け付けます。番号の国で住所が求められる場合、住所の国はその国に固定されます(例:ルクセンブルクの番号にはルクセンブルクの住所が必要です)。ご自身の住所を使用したい場合は、ご自身の国の番号を選択してください。

注: WhatsApp Business APIで使用する電話番号は、通常のWhatsAppアプリと同時に使用することはできません。個人のWhatsAppを引き続き使用したい場合は、代わりにプラットフォームを通じて新しい番号を購入するか、WhatsApp Webを使用してください。WhatsApp Webでは、通常のアプリから電話番号を削除することなく、ペアリングによって既存の番号を接続できます。これらは2つの異なる経路です。ここで購入する番号は背後に電話機が存在しない仮想番号であるため、Business APIでのみ使用可能であり、WhatsApp Webとペアリングすることはできません。


ステップ 1: 電話番号の購入

  1. 左側のサイドバーで、下部付近にある Settings をクリックします。
  2. Settings の左側メニューの Channels の下にある Channels をクリックします。
  3. WhatsApp Business API カードを見つけて、緑色の Connect WhatsApp ボタンをクリックします。
  4. Get a new number from us を選択し、次に Managed by us を選択します。
  1. Buy phone numberポップアップが開きます。国を選択します(その国の番号と現在の価格が通信事業者から直接取得されます)。必要に応じて、Contains digitsでフィルタリングすることもできます。
  1. 表示された 利用可能な番号 のリストを参照します。各番号の横には、初回購入費用と月額費用が表示されています。
  1. 番号をクリックし、表示名(WhatsAppでユーザーに表示されるビジネス名)を入力します。これには文字を含める必要があり、ビジネス名またはブランド名である必要があります。WhatsAppは、電話番号のみの名称や「WhatsApp」という単語を含む名称を拒否します。その後、表示された料金を確認し、購入を完了してください。

ここで購入した番号はWhatsApp用であり、SMS用ではありません。 プラットフォームを通じて購入された番号は、WhatsApp Businessで使用されます。これらはSMS番号ではなく、通話用番号でもありません。着信通話は自動応答装置に接続されます(セットアップ中にWhatsAppの確認電話に応答するため)。ボイスメールの受信トレイはなく、その番号から発信することもできません。SMSはお客様ご自身のTwilioアカウントで実行されます。詳細はSMSを参照してください。購入した番号が両方に対応しているとは顧客に伝えないでください。対応していません。

購入時にアカウントからクレジットが差し引かれます。各番号には、アクティブな状態を維持するための月額利用料が発生します。月額最低50クレジットが必要で、プレミアム番号は通信事業者の料金設定に合わせてそれ以上の費用がかかります。番号のカード(設定 → チャネル)には常に正確な月額料金が表示されており、購入ダイアログでも確定前に確認できます。

この利用料が番号にかかる唯一の月額料金です。WhatsApp接続料も含まれているため、WhatsAppで番号を維持するために追加料金を支払う必要はありません。すでにここで番号をレンタルされている場合、次回の請求サイクルからこの料金が適用されます。電話番号を参照してください。

ヒント: 顧客の大多数と同じ国の番号を選択してください。これにより信頼性が高まり、メッセージングコストを削減できる可能性があります。

メキシコおよびアルゼンチン: これらの国では携帯電話番号のみが提供されます。WhatsAppはこれらの国の番号を携帯電話番号として扱い、WhatsAppの認証コードを受信できるのは携帯電話番号のみです。固定電話形式の番号は受信できないため、リストには含まれません。また、市外局番がお客様の居住地域の市外局番と異なる場合がありますが、WhatsAppの動作には影響しません。


ステップ 2: 番号をMetaに接続する

購入した番号は、送受信を行う前にMetaでアクティベートする必要があります:

  1. Channels ページで、WhatsApp Business APIカードのリストに新しい番号が表示されます。
  2. その番号の接続アクション(Finish setup)をクリックします。Metaのポップアップが開き、Metaの指示に従って、WhatsApp Businessアカウントを所有するMetaアカウントとの接続を完了させます。
  3. Metaが接続を確認すると、番号は自動的に有効になります。別途「公開」する手順はありません。接続がオンラインになると、ステータスは自動的に Active に切り替わります。

Meta Businessアカウントへのログインを求められ、プラットフォームがユーザーに代わってWhatsAppメッセージを送受信することを許可するよう求められます。

アクティベーションは通常自動的に行われます。 数分かかりますが、ほとんどの場合、確認の電話やコードは必要ありません。Metaが番号を「保留中(Pending)」のままにしたり、所有権の確認が完了しているにもかかわらずMetaのウィンドウが「WhatsAppの接続が完了しませんでした(WhatsApp Connection Didn’t Complete)」で終了したりすることがあります。その番号はそのままにしておいてください。10分ごとに再チェックが行われ、所有権の確認後に停止した登録は、通常15分以内に自動的に再登録されます。その間に番号を削除したり、「セットアップを完了(Finish setup)」を再度開始したりしないでください。番号の登録が繰り返し失敗する場合、WhatsAppによって一時的にレート制限がかけられている可能性があります。24時間待ってから再試行するか、1時間経過しても「保留中」のままの場合はサポートにお問い合わせください。唯一の例外は、MetaによってロックされたWhatsApp Businessアカウントです。以下のMetaによるロックを参照してください。

すでに独自のMeta Cloud API番号をお持ちですか?

プラットフォーム経由で購入する必要はありません。WhatsApp Business APIカードで Connect WhatsApp をクリックし、Use a number you already have を選択してから Managed by us を選択すると、Connect WhatsApp Business API モーダルが開きます:

  1. 国際形式(例: +1 555 123 4567)で電話番号を入力します。
  2. 必要に応じて、表示名(WhatsAppでメッセージを送る相手に表示される名前)を入力します。
  3. WhatsAppへ進むをクリックして、Metaのウィンドウで接続を完了します。

現在使用中の個人のWhatsApp Business番号を接続することは強く推奨しません。ここに接続すると、既存のWhatsAppアプリの動作に支障をきたす可能性があります。新しい番号を使用してください。

Metaのウィンドウで、独自の番号を追加して認証してください。 Metaの無料テスト番号(+1 555で始まるもの)は選択しないでください。これは手動で追加した少数のテスト連絡先にしかメッセージを送れないため、実際の顧客に届くことはありません。Metaのテスト番号を入力または選択した場合、接続は拒否されます。

現在WhatsAppアプリで使用中の番号を移行する

WhatsAppまたはWhatsApp Businessアプリで現在アクティブに登録されている番号は、APIに接続できません。先にアプリからその番号を解放する必要があります。以下の順序で実行してください。

  1. 必要なデータはあらかじめ保存してください。 チャット履歴はAPIに引き継がれず、アカウントの削除は元に戻せません。作業を進める前に、重要な会話をエクスポートまたはバックアップしてください。
  2. アプリ内の2段階認証をオフにします(設定 → アカウント → 2段階認証)。これにより、古いPINがAPI登録の妨げになるのを防ぎます。
  3. アプリでアカウントを削除します(設定 → アカウント → アカウントを削除)。これで番号が解放されます。番号はアプリまたはAPIのどちらか一方にしか存在できず、両方に同時に存在することはできません。
  4. 解放が反映されるまで数分待ってから、上記の接続手順に従って番号を接続してください。

警告: アカウントを削除すると、その番号のチャット、グループ、および電話上のバックアップがすべて削除されます。今後その番号をAPIで運用することが確実な場合にのみ実行してください。引き続きアプリでその番号を使用したい場合は、代わりにWhatsApp Web経由で接続するか、API用に別の新しい番号を購入してください。

開発者向けの設定なしで独自のWhatsApp Businessアカウントを利用したいですか?

Through our Meta app は、Connect WhatsApp ボタンの2つ目の質問に対するもう1つの回答です。お客様自身のWhatsApp Businessアカウントを維持したまま、Metaの開発者サイトで何も作成することなく、当社のMetaアプリを使用できます。Metaは会話費用を直接お客様のWhatsApp Businessアカウントに請求します。 ご自身の番号を持ち込む場合: 接続に対して月額50クレジットが当社から請求されます。ここで番号をレンタルする場合: 番号のレンタル料に接続費用が含まれているため、追加料金は発生しません。Connect Through Our Meta App を参照してください。

独自のMetaアプリでWhatsAppを実行しますか?

技術者や代理店向けには、さらに別の選択肢があります。Metaの開発者サイトで独自のアプリを作成し、直接接続する方法です。Metaが独自の料金体系で請求を行い、当社からのメッセージごとの料金は発生しません。また、クライアントには常にお客様のビジネス名のみが表示されます。詳細な手順は独自のMetaアプリを接続に記載されています。

メッセージ料金の支払い者は、番号の接続方法によって異なります。 お客様ご自身の番号が弊社管理の場合、弊社のメッセージングアカウント経由で送信されるため、レンタル番号と同様に、メッセージ料金はお客様のクレジットから差し引かれます。Metaアプリ経由およびお客様独自のMetaアプリの場合、MetaはWhatsApp Businessアカウントに登録されている支払い方法に対してメッセージ料金を請求します。有効な支払い方法が登録されていない場合、登録されるまでMetaはブロードキャストメッセージやテンプレートメッセージをブロックします。初回送信の前にWhatsAppのコストと2026年10月の変更をお読みください。これには2026年10月1日に予定されている価格変更についても記載されています。


接続時の注意点

Meta接続フローにおいて、多くの新規ユーザーが陥りやすい問題がいくつかあります。アクティベーションを開始する前に、これらをお読みください。

Metaのテスト番号ではなく、自分の番号を選択する

Metaの接続フロー中に、Metaは独自の番号を持ち込むオプションとともに、テスト用電話番号(+1 555範囲のサンプル番号)を提示します。必ず独自の番号を持ち込んでください。 Metaのテスト用番号はメッセージを受信することはできますが、Meta内で手動で追加した少数の番号にしか送信できないため、実際の顧客にメッセージを送ることはできません。すべての返信は送信に失敗します。アプリはこの動作をブロックします。Metaのテスト用番号を入力または選択した場合、接続は拒否され、代わりに実際の番号を使用するように求められます。

電話番号がWhatsApp Businessアカウント内に登録されている必要があります

これは、最後のステップで接続が失敗する最も一般的な理由です。Metaのテスト用番号を選択したり、電話番号のステップをスキップしたりすると、選択したWhatsApp Businessアカウントに番号が登録されないため、接続する対象がなくなってしまいます。

Metaのウィンドウの電話番号ステップで、以下を行ってください。

  1. 新しい番号を追加することを選択します。
  2. 番号を入力します。
  3. MetaからSMSまたは通話で送信されるコードを使用して認証します。

正しく完了すると、そのアカウントのWhatsApp Manager内の電話番号の下に、認証済みとして番号が表示されます。接続が失敗した場合、アプリはどのステップで問題が発生したかを正確に通知します。

失敗した場合でも、削除して作り直さないでください

接続が失敗したときに、WhatsApp Businessアカウントを削除してやり直したくなるかもしれませんが、削除しないでください。 番号が紐付いているアカウントを削除すると、通常は問題の解決が困難になります。また、接続を繰り返すと、WhatsAppによって番号が一時的にブロックされる可能性があり、それが恒久的なものになる恐れがあります。エラーメッセージを読んでください。そこには具体的な問題と次のステップが記載されています。それでも接続できない場合は、電話番号とエラー内容を添えてサポートにお問い合わせください。

各アカウントには独自のWhatsApp Businessアカウントが必要です

WhatsApp Businessアカウントは一度に1つのメッセージングアカウントにしかリンクできないため、ここから異なるアカウントを使用して同じWhatsApp Businessアカウント経由で2つ目の番号を接続することはできません。これは、代理店とそのサブアカウントの1つ、あるいは2つのサブアカウントがすべて同じビジネスアカウントを指している場合によく発生します。番号は実際にそのビジネスアカウントで検証され有効になっているため、Meta上では接続が成功したように表示されますが、アクティベーションはここで停止し、すでにその番号を使用しているアカウント名が表示されます。

解決策は2つあります。

  • そのWhatsApp Businessアカウントを既に使用しているアカウントで番号を接続する。 そこに番号を追加することは通常通り可能です。
  • このアカウントに独自のWhatsApp Businessアカウントを持たせる。 接続をやり直し、既存のアカウントを選択する代わりに、新しいWhatsApp Businessアカウントを作成するを選択してください。番号は1つのビジネスアカウントにしか属せないため、まずMeta Business Managerで古いビジネスアカウントからその番号を削除してください。

既存のWhatsApp Businessアカウントを削除して解放しないでください。そのアカウントで既に稼働している番号が動作しなくなります。

他のBSPに既にリンクされているWhatsApp Businessアカウントを再利用しない

WhatsApp Businessアカウント(WABA)がすでに別のBSP(Business Service Provider:以前に接続した別のプラットフォーム)にリンクされている場合、ここでの接続は失敗し、再試行しても解決できません。アクティベーションは、ビジネスアカウントがすでに他の場所でリンクされているというメッセージとともに停止します。これを回避するには、他の場所で接続済みのものを再利用するのではなく、この接続のためにMeta Business Managerで新しいWhatsApp Businessアカウントを作成してください。

Metaビジネス設定内のTwilio

当社が管理する番号を接続すると、MetaはあなたのMetaビジネスにパートナーとしてTwilioを追加します。これはMetaビジネス設定にTwilioとして表示されます。TwilioはWhatsAppとYour AI Connectorの間でWhatsAppメッセージを転送するサービスであるため、そこに残しておく必要があります。

Twilioを削除しないでください。 削除されると、その番号では送受信が一切行われなくなります。顧客からのメッセージは届かず、返信も失敗します。Your AI Connectorはこれを検知し、設定 → チャネルでその番号をオフラインとマークしてメールで通知します。修正するには、設定 → チャネルで番号を再接続してください。これによりTwilioが再度追加されます。


ステップ3:WhatsAppビジネスプロフィールの設定

WhatsApp Businessプロフィールは、顧客があなたのビジネスとやり取りする際に表示されるものです。

  1. チャネルページで、WhatsAppが有効な番号を見つけ、そのプロフィールエディターを開きます。
  2. 以下を入力します。
フィールド 説明
プロフィール写真 ビジネスのロゴまたは写真(推奨:正方形、少なくとも640x640px)
カテゴリ ビジネスを最もよく表すカテゴリ(例:レストラン、小売、ヘルスケア) — 必須
説明 ビジネスの説明
基本情報 ビジネスに関する短い紹介文
メールアドレス ビジネスの連絡先メールアドレス
ウェブサイト ビジネスのウェブサイトURL
住所 ビジネスの所在地
  1. 保存してプロフィールを更新します。

ヒント: プロフィールのすべての項目を入力してください。プロフェッショナルで完全に記入されたプロフィールを持つビジネスは、顧客が関心を持ちやすくなります。


番号ごとに1つのAIエージェント

アカウントに複数のWhatsApp Business API番号がある場合、それぞれ異なるAIエージェントが対応するように設定できます。AIエージェントページの「新規会話の対応者」パネルには、WhatsAppの「番号ごと」のブロックが表示され、接続されている番号ごとに選択ツールが用意されています。「WhatsAppと同じ」を選択するとチャネルのエージェントに従い、別のエージェント(または「誰も対応しない」)を選択すると、その番号のみに設定が適用されます。返信は常に顧客がメッセージを送った番号から送信されます。番号の接続方法(管理対象の番号、当社のMetaアプリ上の番号、お客様自身のMetaアプリ上の番号など)に関わらず、これらは1つのアカウント内で併用でき、新しい番号にはその番号で開始された会話のみが引き継がれます。詳細については、エントリーポイント → WhatsApp番号ごとに1つのエージェントを参照してください。お客様のMetaビジネスには含まれているものの、このアカウントには接続されていないWhatsApp番号に顧客からメッセージが届いた場合、他の番号から返信することはできません(WhatsAppによって拒否されます)。その場合、メッセージに理由が表示され、その番号を接続することで返信が可能になります。テンプレートメッセージは引き続き送信されます。

プライマリ番号

連絡先がどの番号にもメッセージを送信したことがない場合、その連絡先への返信はプライマリ番号から送信されます。番号を変更するには、設定 → チャネルを開き、WhatsApp Business APIカードで該当する番号を見つけてプライマリに設定をクリックします。WhatsAppへの接続が完了した番号のみが送信可能です。セットアップ未完了と表示されている番号はメッセージを送信できず、アプリは代わりに接続済みの番号を使用します。その他の番号はセカンダリ番号としてアカウントに残ります。購入した番号は、セットアップが完了しているかどうかにかかわらず毎月課金されるため、セットアップを完了させるか、不要な場合は削除してください。

メッセージ送信制限について

WhatsAppでは、スパムからユーザーを保護するためにメッセージ送信制限を設けています。この制限により、24時間のローリングウィンドウ内でメッセージを送信できるユニークな連絡先の数が決まります。

注: 2025年10月以降、メッセージング制限は電話番号ごとではなく、ビジネスポートフォリオレベルで適用されます。ポートフォリオ内のすべての電話番号は、同じ制限を共有します。

ティアシステム

ティア 24時間あたりのユニークな連絡先数 到達方法
未認証 250 新規の未認証ビジネスのデフォルト
認証済み 2,000 ビジネス認証を完了する
ティア2 10,000 高品質なメッセージングを維持する
ティア3 100,000 大規模で継続的な高品質を維持する
無制限 制限なし 卓越した品質の実績

送信制限を引き上げる方法

  • Metaビジネススイートでビジネス認証を行い、初期の250件の連絡先制限を2,000件に引き上げます。
  • 高いメッセージ品質を維持し、受信者から報告されたりブロックされたりしないようにします。
  • 一貫してメッセージを送信します。WhatsAppは、良好な品質評価を維持しながら現在の制限の約半分に達すると、通常6時間以内に自動的にティアを引き上げます。

重要: これらの制限は、ビジネス主導の会話(テンプレートメッセージ)にのみ適用されます。顧客が最初にメッセージを送る顧客主導の会話は、制限の対象にはなりません。


メッセージの種類

セッションメッセージ(自由形式)

アクティブな会話ウィンドウ内で送信できる、通常のテキスト、画像、動画、ドキュメント、その他のメディアです。

  • あらゆるコンテンツを含めることができます
  • 24時間のメッセージングウィンドウ内でのみ送信可能です(下記参照)
  • 事前承認は不要です

共有された位置情報

連絡先が位置情報を共有した場合(WhatsAppのクリップアイコン → 位置情報、ピン、または保存された場所)、AIは会話内のテキストとしてそれを受け取ります。WhatsAppが送信する場所の名前と住所に加え、[THE CONTACT SHARED A LOCATION] Playa Delfines, Cancún (21.1619, -86.8515)の形式で座標も含まれます。エージェントは住所を引用して返信したり、指示に基づいて判断したり(「連絡先が配送エリア外の場合はその旨を伝える」など)、会話の一部として緯度と経度をカスタム関数やWebhookに渡すことができます。この形式は、番号がデフォルトの方法(弊社提供の番号)、弊社のMetaアプリ経由、お客様自身のMetaアプリ経由、またはWhatsApp Webのいずれで接続されているかに関わらず共通です。ライブ(リアルタイム)位置情報は、共有された瞬間の位置として一度だけ送信されます。アプリが移動するピンを追跡することはありません。

チャットでは、テキストの行ではなくカードとして表示されます。場所の名前と住所が記載されたピンと、その場所を新しいタブで正確に開くGoogle マップで開くリンクが表示されます。連絡先が入力したキャプションは、その下に表示されます。チャットリストには、最新のメッセージとしてピンと場所の名前が表示されます。

テンプレートメッセージ

24時間のウィンドウ外で顧客との会話を開始できる、事前承認済みのメッセージ形式です。

  • 使用前にMetaによる承認が必要です
  • パーソナライズ(顧客名、注文番号など)のための変数をサポートしています
  • 新しい会話を開始する場合や、24時間経過後に再エンゲージメントを行う場合に必要です
  • 複数の言語で利用可能です

テンプレートは専用ページに移動しました。詳細な手順についてはWhatsAppメッセージテンプレートを参照してください。

注: テンプレートの承認には通常数分から数時間かかりますが、場合によっては最大24時間かかることがあります。


24時間のメッセージングウィンドウ

WhatsAppはユーザーを保護するため、24時間の会話ウィンドウを設けています:

  • 顧客からメッセージが届くと、24時間のウィンドウが開きます。この期間中は、あらゆる種類のメッセージ(セッションメッセージ)を自由に送信できます。
  • 24時間操作がない場合(顧客からのメッセージがない場合)、ウィンドウは閉じます。再エンゲージメントには、承認済みのテンプレートメッセージのみを使用できます。
  • テンプレートメッセージを送信し、顧客が応答すると、新しい24時間のウィンドウが開きます。
シナリオ 送信可能なメッセージ
顧客からメッセージを受信した直後(24時間以内) あらゆるメッセージタイプ(テキスト、画像、ドキュメントなど)
顧客の最後のメッセージから24時間以上経過 承認済みのテンプレートメッセージのみ
顧客がテンプレートに返信した あらゆるメッセージタイプ(新しい24時間ウィンドウが開きます)

ヒント: このチャネルを処理するAIエージェントは、24時間ウィンドウ内で自動的に返信します。ウィンドウ終了後の再エンゲージメントについては、ブロードキャストまたはエージェントの設定でフォローアップテンプレートを設定してください。詳細はAIエージェントを参照してください。

このウィンドウ内での返信は、2026年10月1日より有料となります。 Metaは同日より、ビジネスが24時間ウィンドウ内で送信する自由形式の返信に対し、メッセージごとに各市場の料金(ユーティリティテンプレートや認証テンプレートですでに適用されている料金と同額)を課金すると発表しました。これらは2024年11月以降無料となっていました。各電話番号につき月間1,000件のサービスメッセージが最初に無料で付与され、1,001件目以降から課金対象となります。料金はMetaの料金表に記載されている各市場のユーティリティ料金が適用されます。これがお客様にとって何を意味するのか、またそれまでに何を確認すべきかについては、WhatsAppのコストと2026年10月の変更をご覧ください。


設定のテスト

顧客向けに公開する前に、すべてが正常に動作することを確認してください。

  1. テストメッセージを送信する。 この番号に割り当てられたAIエージェントまたはブロードキャストを開き、試用パネルを使用して自分宛てにテストメッセージを送信するか、チャットから直接送信します。
  2. 受信メッセージをテストする。 個人の電話からビジネス番号へWhatsAppメッセージを送信し、チャットに表示されることを確認します。
  3. AIの応答をテストする。 エージェントが期待される時間枠内に返信すること、およびその回答が指示やナレッジベースと一致していることを確認します。
  4. テンプレートメッセージをテストする。 シンプルなテンプレートを作成して承認し、テスト番号に送信して、すべての変数が埋め込まれた状態で届くことを確認します。

トラブルシューティング

番号がアクティブとして表示されない

  • Metaビジネスアカウントへのログインや権限の付与など、アクティベーションプロセス全体が完了していることを確認してください。
  • Metaビジネスアカウントの状態が良好であることを確認してください。
  • 数分待ってからページを更新してください。アクティベーションには時間がかかる場合があります。

Metaが新しいWhatsApp Businessアカウントを審査中のため保留中

Metaのウィンドウで新規のWhatsApp Businessアカウントが作成された場合、Metaはその番号が有効になる前に、アカウントの自動審査を独自に行います。審査が承認されるまで、その番号はアプリ内およびWhatsApp Managerで保留中と表示されます。この審査のために提出すべきものはなく、アプリから審査を早める方法もありません。番号はそのままでお待ちください。アプリが定期的に確認を行い、Metaがアカウントを承認すれば、数日かかる場合でも自動的に番号が接続されます。ビジネス認証は別のステップであり、メッセージング制限を引き上げるためのもので、この審査とは関係ありません。

Metaによるロック

MetaがWhatsApp Businessアカウントをロックすることがあります。これは、例えばビジネス認証の完了待ちや、審査の解決待ちなどの際に行われます。ロックされたアカウント上の番号は接続できません。アプリには**Metaによるロック(Locked by Meta)と表示され、バッジにカーソルを合わせると対処方法が表示されます。この場合、再登録を行っても解決しないため、アプリは再試行しません。Meta Business Suiteのビジネスサポートホーム(Business Support Home)**を開き、Metaの指示に従ってアカウントのロックを解除してください(Metaから求められた場合はビジネス認証も完了させてください)。その後、番号はそのままでお待ちください。アプリが継続的にチェックを行い、Metaがロックを解除すると自動的に番号が接続されます。再接続や「セットアップを完了(Finish setup)」を再度開始する必要はありません。

待ちたくない場合は、代わりにWhatsApp Webでその番号を使用できます。まず設定 → チャネルで番号を削除し、次にWhatsApp ManagerでWhatsApp Businessアカウントからその番号を削除してください(有効にならなかった番号はそこで削除可能です)。その後、スマートフォンのWhatsApp Businessアプリで登録し、QRコードで接続してください。後でAPIに戻す場合は、現在WhatsAppアプリで使用している番号を移行するで説明されている手順に従い、アプリ内のアカウントを再度削除する必要があります。

番号がオフラインと表示される

設定 → チャネルの下にある番号にオフラインバッジが表示されている場合、WhatsApp自体がその番号からの送信を停止していることを意味します。バッジにカーソルを合わせると、その理由を確認できます。最も一般的な原因は、Metaがその番号に関連付けられたWhatsApp Businessアカウントを無効にしていることであり、通常はポリシー違反が理由です。その場合、バッジに理由が表示され、Meta Business Managerへのリンクが示されます。そこで通知を確認し、異議申し立てを行うことができます。

また、MetaビジネスからTwilioが削除されると、バッジもオフラインになります(Metaビジネス設定内のTwilioを参照)。修正するには、設定 → チャネルで番号を再接続してください。

番号がオフラインの間、その番号からのブロードキャストは送信されずに保留され、メッセージごとに失敗することはありません。また、その番号からの自動返信も送信されません。この設定で接続されているすべての番号について、1日1回WhatsAppとの照合を行っています。正常に動作していた番号が一般的なWhatsAppエラー(ポリシー上の理由以外)でオフラインになった場合、その照合プロセスによって自動的に再登録が行われ、それでも復旧しない場合にのみメールが送信されます。その他の理由でオフラインになった場合は、初回発生時にメールが送信されます。WhatsAppがオンラインへの復旧を報告すると、遅くとも次回の1日1回の照合時にバッジが自動的に緑色に戻ります。Meta側で問題を解決しても番号がオフラインのままの場合は、サポートまでご連絡いただければ再照合を行います。番号がオフラインであったために送信できなかったメッセージについては、料金は発生しません。

番号が配信されていないと表示される

設定 → チャネルの下にある番号に配信されていませんというバッジが表示されている場合、その番号は接続されたままであり、受信メッセージは届きますが、その番号から送信するメッセージがWhatsAppによって配信されていないことを意味します。エージェントからの返信を含め、メッセージは数時間キューに入れられた後、失敗します。WhatsAppマネージャーでは、この番号はメッセージング制限なしとして表示されます。一般的な原因は、番号またはWhatsAppビジネスアカウントに対する制限や審査、あるいは支払い方法の不足です。バッジにカーソルを合わせると、理由が表示されます。

WhatsAppマネージャーで番号を確認し、Metaが表示する問題を解決してください。バッジが表示されている間、その番号からのブロードキャストは送信されずに保留されます。この設定で接続されているすべての番号は1日1回チェックされ、初めて問題が発生した際にはメールで通知されます。WhatsAppが再びその番号から配信を開始すると、バッジは自動的に緑色に変わります。チャットにおいて、15分経過しても送信待ちの状態である返信にはオレンジ色の時計アイコンが表示されるため、単に送信中のメッセージと区別することができます。

メッセージが送信されない

  • アカウントに十分なクレジットがあるか確認してください。
  • メッセージング制限のティアに達していないか確認してください。
  • 受信者の電話番号が正しい国際形式(例: +1234567890)であることを確認してください。
  • 24時間のウィンドウ外で送信する場合は、承認済みのテンプレートを使用していることを確認してください。

ブロードキャストとテンプレートはブロックされるが、返信は機能する

このパターン(相手からメッセージが送られてきた場合には返信できるが、自分から開始するメッセージは送信されない)は、ほぼ例外なく、その番号に関連付けられたWhatsApp Businessアカウントに有効な支払い方法が登録されていないことを意味します。これはお客様自身のWhatsApp Businessアカウントで実行される接続にのみ適用されます。Metaは、アカウントに有効な支払い方法が登録されるまで、ビジネス主導の会話(ブロードキャスト、あらゆるテンプレート)をブロックし、そのエラーをWhatsApp Managerで報告します。

この状況では、アプリはブロードキャストの送信を停止し、各メッセージが失敗するのではなく、支払い方法を追加するように通知します。WhatsApp Managerで支払い方法を追加または修正してから、再度送信してください。ここで番号を再接続してもこの問題は解決しません。WhatsAppのコストと2026年10月の変更を参照してください。

テンプレートが拒否された

  • Metaのテンプレートガイドラインを確認してください。特定のカテゴリでは、テンプレートにプロモーションコンテンツを含めることはできません。
  • プレースホルダーの不一致など、フォーマットの問題がないか確認してください。
  • Metaから提供された拒否理由を確認し、修正して再提出してください。詳細はWhatsAppメッセージテンプレートを参照してください。

メッセージの品質評価が低い

  • メッセージの内容が受信者にとって関連性が高く、価値のあるものか確認してください。
  • オプトインしていない連絡先へのメッセージ送信は避けてください。
  • 受信者から報告やブロックを受けている場合は、メッセージの頻度を減らしてください。

「電話番号が見つかりません」エラー

  • 電話番号がMetaビジネスアカウントに正しくリンクされていない可能性があります。
  • WhatsApp接続フローを通じて電話番号の再アクティベーションを試みてください。
  • 問題が解決しない場合は、サポートにお問い合わせください。

ベストプラクティス

  • WhatsAppで顧客にメッセージを送る前に、必ず同意を得てください。
  • 24時間ウィンドウを最大限に活用するために、顧客のメッセージに迅速に返信してください。
  • テンプレートは簡潔かつ価値のあるものにしてください。質の高いテンプレートは承認が早く、パフォーマンスも向上します。
  • ティアの格下げを避けるため、Meta Business Managerで品質評価を監視してください。
  • メッセージングウィンドウ内で24時間年中無休の応答性を確保するために、AIエージェントに返信を任せてください。詳細はAIエージェントを参照してください。