Your AI Connector Docs

独自のMetaアプリを接続する

独自のMetaアプリを通じてWhatsAppを運用し、Metaの料金体系で直接Metaに支払います。Your AI Connectorはこの接続に対してメッセージごとの手数料を課すことはなく、仲介するTwilioアカウントも存在しません。WhatsAppアカウントはお客様自身のものであるため、クライアントにはお客様のビジネス名のみが表示されます。

これはWhatsApp接続オプションの中で最も技術的な手順です。Metaの開発者サイト内にアプリを作成し、4つの値をYour AI Connectorにコピーする必要があります。所要時間は約20分を見込んでください。もしこれが負担に感じられる場合は、管理型のWhatsApp Business接続が最も簡単に開始できる方法です。

必要なもの

  • Metaビジネスマネージャアカウントへのアクセス権。
  • WhatsAppアプリで現在使用されていない電話番号。
  • 約20分。

パート1 — Metaでアプリをセットアップする

まずMeta側でこれらの手順を実行してください。その過程で、App ID、App secret、Access token、WhatsApp account IDの4つの値を取得します。

1. アプリを作成する

developers.facebook.comにアクセスし、マイアプリを開いてアプリを作成を押します。ビジネスタイプを選択し、任意の名前を付けます（この名前は自分にしか表示されません）。

2. アプリにWhatsAppを追加する

アプリのダッシュボードで、製品リストからWhatsAppを見つけて設定を押します。Metaが無料のテスト番号を含むテスト用WhatsAppアカウントを作成するため、実際の番号を接続する前に動作を試すことができます。

3. WhatsAppの権限を有効にする

これは多くのガイドで省略されがちな手順ですが、ここを飛ばすと後で接続に失敗する最も一般的な原因となります。

アプリ内でアプリレビューを開き、権限と機能を選択します。whatsapp_business_managementを検索してください。アクセスなしと表示されている場合は、標準アクセスを取得を押します。Metaからパスワードの再入力を求められ、その場で権限が付与されます。待機期間やアプリ審査はなく、ボタンを押すだけです。

whatsapp_business_messagingは通常、すでに標準アクセス権を持っています。次のステップに進む前に、両方の権限が標準アクセスと表示されている必要があります。そうでない場合、生成されるトークンにいずれかの権限が欠けてしまいます。

4. システムユーザーを作成する

Metaビジネス設定でユーザーを開き、システムユーザーを選択します。システムユーザーを追加し、アプリとWhatsAppアカウントの両方に対する管理者アクセス権を付与してください。

5. そのユーザーのトークンを生成する

システムユーザーを選択し、トークンを生成を押します。アプリを選択し、有効期限なしのトークンを選び、whatsapp_business_messagingとwhatsapp_business_managementの両方にチェックを入れます。Metaはトークンを一度しか表示しないため、すぐにコピーしてください。

6. WhatsAppアカウントIDを確認する

ビジネス設定でアカウントを開き、WhatsAppアカウントを選択して、対象のアカウントを選びます。名前の下にある長い数字がIDです。

アプリIDとアプリシークレットは、アプリのアプリ設定内のベーシックにあります。アプリシークレットの横にある表示を押すと確認できます。

パート2 — Your AI Connectorでの接続

設定を開き、チャネルを選択します。WhatsApp Business APIカードを見つけて、WhatsAppを接続を押します。既にお持ちの番号を使用するを選択し、次に独自のMetaアプリを選択します。ウィザードが開き、簡単な概要が表示されます。セットアップを開始を押してください。

  1. 詳細情報。 このステップでは、パート1のMeta側での5つの手順を繰り返し、4つの値を入力するフォームが表示されます。App ID、App secret、Access token、WhatsApp account IDをMetaに表示されている通りに、余分なスペースを含めずに貼り付け、詳細を確認を押してください。正常に動作するまで何も保存されません。Your AI ConnectorがMeta側で先に検証を行います。
  1. 接続する番号を選択。 ウィザードには、Metaの品質評価とともに、WhatsAppアカウントに関連付けられているすべての番号が一覧表示されます。このワークスペースで送受信に使用する番号を選択し、この番号を接続を押してください。
  1. アクティベーションと配信。 Your AI Connector は Cloud API 用の番号を自動的にアクティベートし、Meta に Webhook を登録するため、受信メッセージは自動的に受信トレイに届きます。ほとんどの場合、そのまま「Number connected（番号が接続されました）」という確認メッセージが表示された接続カードに移動します。自動ステップが完了しない場合、ウィザードにコールバック URL と検証トークンがコピーボタン付きで表示され、Meta での手動追加手順が案内されます。これらの値は、Meta から再入力を求められた場合に備えて、接続カード上に引き続き表示されます。
  2. ウィザードによる接続の自動チェック。 最終ステップでセットアップが自動的に検証されるため、ユーザー側で待機する必要はありません。カードに接続済みと表示されたら、別の電話から自分宛てに WhatsApp メッセージを送信し、チャットに届くことを確認してください。その番号での会話は他のチャネルと同様に流れ込み、AI エージェントが返信できるようになります。チェックの結果、Meta 側でまだ必要な作業（番号の検証など）がある場合は、カードにその内容が正確に表示されます。修正後に Verify connection（接続を検証） をクリックすると、再度チェックが実行されます。

いつでも同じページに戻って接続ステータスを確認したり、新しい詳細情報で再接続したり、切断したりできます。番号、Metaアカウント、請求情報はそのまま保持されます。

管理された接続からの切り替え

管理された WhatsApp Business 接続から開始し、後で独自のMetaアプリに移行することができます。どちらも同じアカウント上で動作するため、再構築の必要はありません。

  • 連絡先とチャット履歴は保持されます。 連絡先、会話、タグ、エージェント、ナレッジベースは接続ではなくアカウントに属しています。番号を削除または置き換えてもこれらが削除されることはなく、以前に連絡をくれた人が再度その番号にメッセージを送ると、同じ会話に表示されます。
  • 番号はまずMeta側で移行する必要があります。 WhatsAppでは、1つの番号を一度に1つの場所でしか使用できません。サポートに連絡して管理された設定から番号を解放してもらい、WhatsApp Managerで独自のWhatsApp Businessアカウントに追加してから、このページのステップに従ってください。移行中は、短時間番号がオフラインになることを想定しておいてください。
  • 切り替えを予定している場合は、所有している番号を使用してください。 Your AI Connector 内でレンタルされた番号は管理された設定に属する仮想回線であり、独自のMetaアプリにそのまま引き継ぐことはできないため、切り替えには新しいWhatsApp番号が必要になります。
  • テンプレートは再度承認が必要です。 MetaはWhatsApp Businessアカウントごとにテンプレートを承認するため、使用するテンプレートは自身のアカウントで再作成してください（以下の テンプレート を参照）。
  • 代理店: 各サブアカウントが独自のMetaアプリに接続するため、クライアントは1つずつ切り替えることができます。

知っておくべきこと

  • WhatsApp Businessのすべての接続と同様に、24時間ルールが適用されます。 過去24時間以内にメッセージを送信してきたユーザーに対しては、いつでも自由に返信できます。その期間を過ぎると、WhatsAppでは承認済みのメッセージテンプレートを使用した場合にのみ、ビジネス側から会話を開始できます。プレーンテキストのメッセージはMeta側で受け付けられますが、配信はされません。
  • Metaが会話料金を直接請求します。 料金はMetaが公開している国別のレートに基づき、MetaのWhatsAppアカウントに登録されている支払い方法に対して請求されます。Your AI Connectorでは、この接続におけるメッセージごとの課金は行いません。AIの使用料は通常通りクレジットで請求されます。
  • WhatsAppアカウントには有効な支払い方法を登録しておいてください。 支払い方法が登録されていない場合、Metaはビジネス側から開始するすべての会話（ブロードキャストやテンプレートメッセージなど）をブロックし、WhatsApp Managerにエラーを表示します。この接続では、支払い方法が未登録の場合、ブロードキャストの開始が拒否され、メッセージごとに失敗するのではなく、支払い方法を追加するよう通知されます。ユーザーから先にメッセージが送られてきた場合の返信は現時点では送信されますが、2026年10月1日以降はMetaがそれらに対しても課金を開始するため、有効な支払い方法が登録されていないアカウントは、その日をもって完全に機能しなくなります。詳細はWhatsAppのコストと2026年10月の変更をご覧ください。
  • ここでのコスト見積もりの表示は異なります。 これらの料金はクレジットから差し引かれることはないため、ブロードキャストの確認ステップでの見積もりには、クレジットの合計ではなく、連絡先数と国別の内訳が表示され、MetaからWhatsApp Businessアカウントに対して直接請求される旨の注記が記載されます。
  • テスト番号は無料です。 Metaがすべての新しいアプリに提供するテスト番号は、最大5人の認証済み受信者まで無料でメッセージを送信できます。実際の電話番号を接続する前に、すべての設定を試すのに便利です。

テンプレート

メッセージテンプレートはこの接続で機能し、お客様自身のWhatsApp Businessアカウント内に保存されます。テンプレートページで作成すると、そのアカウント上で作成され、Metaによる審査が行われます。承認、保留、または拒否の結果は、こちらに表示されます。WhatsAppマネージャーに既に存在するテンプレートは自動的にリストに表示されます。Metaから同期ボタンを使用すると、そこで変更した内容がすべて取り込まれます。送信方法は他のすべてのWhatsApp接続と同様です。承認済みのテンプレートを選択して会話を開始するか、24時間経過後のウィンドウ外で会話を再開してください。詳細はMeta WhatsAppアカウントでテンプレートを使用するをご覧ください。

うまくいかない場合

  • 「その詳細では接続できませんでした」 — 各値をコピーし直してください。余分なスペースが入っているのが一般的な原因です。メッセージにはMetaからの返信が含まれており、通常は誤っている値が示されます。
  • エラーに「トークンが不足しています whatsapp_business_management」と表示される — アプリにその権限がまだ付与されていません。パート1のステップ3に戻り、**「標準アクセスを取得」**を押してから、両方の権限にチェックを入れて新しいトークンを生成し、詳細を再度確認してください。その手順を行わずにトークンを再生成しても、同じエラーが発生し続けます。
  • トークンが消えた — Metaはトークンを一度しか表示しません。同じシステムユーザーから新しいトークンを生成してください。古いトークンは取り消すまで機能し続けますが、新しいトークンのみが表示されます。
  • 返信が「この会話はWhatsApp Business番号…に送信されましたが、接続されている番号ではありません」というエラーで失敗する — Metaアプリに複数の番号が登録されており、ユーザーがここに接続されていない番号にメッセージを送っています。Metaはすべての番号のメッセージをアプリに送信するため、メッセージは表示されますが、返信は接続されている番号からしか送信できないため、AIが回答できません。「チャネル」ページのWhatsAppカードには、メッセージが届き続けている間、その番号を指す警告が表示されます。そのカードの番号の行には「再接続」ボタンがなく（「プライマリとして設定」と削除のみ）、Metaアプリの接続ページ（「WhatsApp Business API」カードの「WhatsAppを接続」、次に**「既存の番号を使用」、次に「独自のMetaアプリ」）を再度開き、接続カードで「再接続」**を押して、顧客が実際に書き込んでいる番号を選択してください。システムユーザーのトークンには、そのWhatsAppアカウントへのアクセス権が必要です。その番号が Your AI Connector に一切到達すべきでない場合は、代わりにMetaアプリからその番号（またはそのWhatsAppアカウント）を削除してください。
  • 開始したメッセージが届かない — 上記の24時間ウィンドウに関する注意を確認してください。ウィンドウ外では、テンプレートメッセージのみが配信されます。
  • 何も届かない — その番号はまだCloud API用にアクティブ化されていない可能性があります。番号は一度に1つの場所にしか存在できないため、電話機のWhatsApp Business アプリにまだサインインしている場合は、まずそこで削除してから、接続カードの**「接続を確認」**を押してください。Your AI Connector が自動的にアクティブ化を行い、Meta側で不足しているものがあればその場で通知します。
  • 「この番号にはすでに2段階認証PINが設定されています」 — その番号は以前どこかで設定されており、PINが保持されています。WhatsAppマネージャーでその番号の2段階認証をオフにしてから、**「再接続」**を押してください。
  • 「Metaはこの番号をまだ検証していません」 — WhatsAppマネージャーで番号の検証を完了（Metaからコードが送信されます）してから、**「再接続」**を押してください。
  • 「この番号はオンプレミスAPIでホストされています」 — これはWhatsAppの古いセルフホスト型製品で実行されており、Cloud APIと番号を共有できません。まずWhatsAppマネージャーでCloud APIに移行してください。