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件のユニークな連絡先という制限から開始されます(以下のメッセージング制限を参照してください)
  • 十分なクレジットがあるアカウント
  • WhatsApp(個人用またはビジネス用アプリ)に登録されておらず、他のアカウントのTwilio番号でもない電話番号

最初にビジネス名と住所を追加してください。 最初の番号を購入する前に、Settings → Business(Workspaceグループ)でビジネス名と住所を入力してください。通信事業者がこの住所を検証するため、正確かつ完全に入力してください。設定されるまで購入は失敗します。

注: 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. 番号をクリックし、Display name(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)」のままにすることがありますが、その場合は画面の指示に従って電話で確認を行ってください。番号の登録が繰り返し失敗する場合、WhatsAppによって一時的にレート制限がかけられている可能性があります。24時間待ってから再試行するか、サポートにお問い合わせください。

すでに独自の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アプリを接続に記載されています。

お客様自身のWhatsApp Businessアカウントを使用する接続では、メッセージの料金は当社ではなくMetaが請求します。 これには、上記の Managed by us で独自の番号を接続する場合、Through our Meta app を使用する場合、および独自のMetaアプリを使用する場合が含まれます。Metaは、そのWhatsApp Businessアカウントに登録されている支払い方法に請求を行います。有効な支払い方法がない場合、Metaは支払い方法が追加されるまで、ブロードキャスト、キャンペーン、テンプレートメッセージをブロックします。最初の送信を行う前に、WhatsApp Costs & the October 2026 Change をお読みください。これには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アカウントを作成してください。


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

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

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

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


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

アカウントに複数のWhatsApp Business API番号がある場合、それぞれに異なるAIエージェントを割り当てて対応させることができます。AIエージェントページの新規会話の対応者パネルには、WhatsApp用の番号ごとのブロックが表示され、接続されている番号ごとに選択ツールが用意されています。WhatsAppと同じを選択すると、そのチャネルのエージェントが引き継がれます。別のエージェント(または誰も対応しない)を選択すると、その設定はその番号のみに適用されます。返信は常に、顧客がメッセージを送ってきた番号から送信されます。詳細については、エントリーポイント → WhatsApp番号ごとに1つのエージェントを参照してください。

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

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

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

ティアシステム

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

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

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

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


メッセージの種類

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

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

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

テンプレートメッセージ

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ビジネスアカウントの状態が良好であることを確認してください。
  • 数分待ってからページを更新してください。アクティベーションには時間がかかる場合があります。

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

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

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

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

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

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

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

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

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

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

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

ベストプラクティス

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