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接続と同様に、24時間ルールが適用されます。 過去24時間以内にメッセージを送信してきた相手には、いつでも自由に返信できます。その期間を過ぎると、WhatsAppでは承認済みのメッセージテンプレートを使用した場合のみ、ビジネス側から会話を開始できます。プレーンテキストのメッセージは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アカウントでテンプレートを使用するをご覧ください。

うまくいかない場合

  • 「We couldn’t connect with those details（その詳細では接続できませんでした）」 — 各値をコピーし直してください。余分なスペースが含まれていることが一般的な原因です。エラーメッセージには Meta からの応答が含まれており、通常は誤っている値が示されます。
  • トークンが不足しているというエラーが表示される whatsapp_business_management — アプリにその権限がまだ付与されていません。パート1のステップ3に戻り、Get standard access（標準アクセスを取得） を押してから、両方の権限にチェックを入れて新しいトークンを生成し、詳細を再確認してください。その手順を行わずにトークンを再生成しても、同じエラーが発生し続けます。
  • トークンが消えた — Meta はトークンを一度しか表示しません。同じシステムユーザーから新しいトークンを生成してください。古いトークンは取り消すまで機能し続けますが、表示されるのは新しいトークンのみです。
  • 開始したメッセージが届かない — 上記の24時間ウィンドウに関する注意書きを確認してください。ウィンドウ外では、テンプレートメッセージのみが配信されます。
  • 何も届かない — その番号はまだ Cloud API 用にアクティベートされていない可能性があります。番号は一度に1つの場所でしか使用できないため、WhatsApp Business アプリにサインインしたままの場合は、まずアプリから削除してから、接続カードの Verify connection（接続を検証） を押してください。Your AI Connector が自動的にアクティベートを行い、Meta 側で不足しているものがあればその場で通知します。
  • 「This number already has a two-step verification PIN（この番号にはすでに2段階認証PINが設定されています）」 — その番号は以前どこかで設定されており、PINが保持されています。WhatsApp マネージャーでその番号の2段階認証をオフにしてから、Reconnect（再接続） を押してください。
  • 「Meta has not verified this number yet（Meta はまだこの番号を検証していません）」 — WhatsApp マネージャーで番号の検証を完了（Meta からコードが送信されます）してから、Reconnect（再接続） を押してください。
  • 「This number is hosted on the On-Premises API（この番号はオンプレミスAPIでホストされています）」 — これは WhatsApp の古いセルフホスト型製品で実行されており、Cloud API と番号を共有できません。まず WhatsApp マネージャーで Cloud API に移行してください。