トラブルシューティングとFAQ
トラブルシューティングとFAQ
よくあるWhatsAppの問題を診断し、よくある質問への回答を確認する
メッセージは受理されたが配信されない
アウトバウンドメッセージエンドポイントからの200レスポンスは、ElevenLabsがリクエストを受理して転送したことを意味します。配信は引き続きMeta側で行われます。メッセージが届かない場合は、次の順に確認してください。
- テンプレートの承認 — テンプレートのステータスがWhatsApp Managerで「承認済み」になっている必要があります。保留中または却下されたテンプレートは配信されません。
- 支払い — WhatsAppビジネスアカウントに支払い方法が登録されていない、または未払いがあると、テンプレートの配信がブロックされます（Metaエラー131042）。WhatsApp Managerで支払い方法を追加または更新してください。
- パラメータの形式 —
template_paramsの各エントリはコンポーネントオブジェクト（{"type": "body", "parameters": [...]}）である必要があります。テンプレート内のすべてのプレースホルダーを埋め、名前付きテンプレートでは各値にparameter_nameを設定してください。テンプレートパラメータを参照してください。 - 受信者の形式 —
whatsapp_user_idには、国番号を含む数字のみを指定します。+は付けません。受信者番号の形式を参照してください。 - マーケティング上限 — Metaでは、1人のユーザーが一定期間に受信できるマーケティングテンプレートの数を制限しています（エラー131049）。ユーティリティテンプレートはこの上限の対象外です。
インポートの問題
- 番号をインポートできない — 別のWhatsAppプロバイダーに登録されているか、WhatsApp Businessアプリで有効になっています。番号は1つのプロバイダーにしか登録できません。制限事項を参照してください。
- インポートフローにWABAが表示されない — WABAを所有するビジネスポートフォリオへの管理者アクセス権を持つFacebookアカウントにログインしていることを確認してから、もう一度インポートしてください。
- Metaデベロッパーアプリで作成されたWABAは、標準フローではインポートできません。
別のパートナーが番号を管理しているか確認する
対象外と表示される、インポートフローに表示されない、またはインポート時にエラーになる番号は、多くの場合、以前のプロバイダーにまだ登録されています。番号を管理しているパートナーがいると、インポート失敗とWABAが表示されない問題の両方を説明できます。
- business.facebook.comにアクセスし、ビジネスポートフォリオを選択します。
- ビジネス設定 > WhatsAppアカウントを開きます。
- 番号が含まれているアカウントを見つけるまで、各WhatsAppアカウントの電話番号を確認します。
- パートナーを開きます。
- そのパートナーから番号を切断する（またはビジネスポートフォリオ全体を削除する）と、数分後に再度インポートできます。
エージェントが受信メッセージに応答しない
既読通知と入力インジケーターで原因を絞り込めます。これらは、エージェントが返信を生成する前、メッセージが処理用に受理された直後に送信されます。入力インジケーターを有効にするがオン（デフォルト）の場合、テストメッセージを送信し、メッセージが既読になり入力インジケーターが表示されるか確認してください。
入力インジケーターは表示されるが、返信が届かない。 メッセージはElevenLabsに到達し、エージェントは処理を開始しています。失敗は返信の生成中または配信中に発生しています。
- エージェントが、値のない動的変数を必要としています。受信WhatsApp会話はユーザー提供の動的変数なしで開始され、設定されるのはシステム変数のみです。解決するには、エージェントが必要とするすべての変数を返す会話開始Webhookを設定してください。初期化コンテキストを参照してください。エージェントエディターの動的変数で入力した値はテスト用プレースホルダーであり、本番環境では使用されません。
- Metaがエージェントの返信を拒否しました。たとえば、このビジネスとユーザーの組み合わせに対するレート制限や、アカウントレベルの支払い問題が考えられます。以下のエラーリファレンスを参照してください。
必要な動的変数が存在しない場合、会話は失敗します。
入力インジケーターが表示されない。 メッセージはエージェントに届く前に破棄されました。
- 番号にエージェントが割り当てられていない、またはメッセージングを有効にするスイッチがオフになっています。WhatsAppページのアカウント設定を確認してください。
- アカウントの認証が無効になっています。Meta側でアクセストークンの期限が切れたか、取り消されています。WhatsAppページでアカウントを再インポートしてください。
- エージェントのワークスペースがゼロ保持モードになっており、受信WhatsAppメッセージを完全に無視しています。
- 受信メッセージがサポートされていない種類です（例：動画、WhatsApp Flowの返信）。制限事項を参照してください。
アカウントで入力インジケーターを有効にするがオフになっている場合、この確認は適用されません。両方のリストを確認してください。
テンプレート後の最初の返信の挙動がおかしい
エージェントのセキュリティタブで最初のメッセージのオーバーライドが有効になっている場合、アウトバウンドテンプレート会話と競合することがあります。テンプレートがすでに最初のメッセージとして送信されているためです。テンプレートへの返信が想定どおりに動作しない場合は、WhatsAppアウトバウンドメッセージで使用するエージェントの最初のメッセージオーバーライドを削除してください。
Metaエラーリファレンス
Metaが配信中に返すエラーには、可能な場合は対処方法が表示されます。よくあるエラーは次のとおりです。
完全な一覧は、Metaのエラーコードリファレンスを参照してください。
FAQ
WhatsAppの利用料金はどのように請求されますか？
2つの事業者から、それぞれ独立して請求されます。
ElevenLabsは、エージェントの利用分（会話時間、メッセージ、ボイスノートのスピーチtoテキストとテキスト読み上げ、LLMの利用）を、通常のElevenLabs請求に従ってプランのクレジットから請求します。
Metaは、テンプレートメッセージ、アウトバウンド通話、通話許可リクエストなどのWhatsApp料金を別途請求します。料金はWhatsApp Managerの支払い方法を通じて請求されます。料金はメッセージカテゴリと国によって異なります。またMetaは、2026年10月1日から料金改定を実施すると発表しています。対象市場に適用される料金については、MetaのWhatsApp料金を参照してください。
ElevenLabsを別のWhatsAppプロバイダーと併用できますか？
現在、番号は1つのメッセージングプロバイダーにのみ登録できます。サードパーティプロバイダー（例：Gupshup）がアカウントを管理している場合、そのアカウントをElevenLabsにもインポートすることはできません。1つの番号で複数のプロバイダーを利用できるMulti-Solution Conversationsを有効にするため、Metaと取り組んでいます。
SIP経由の音声。 現在のプロバイダーでメッセージングを維持しながら、音声にはElevenLabsエージェントを使用したい場合、現在利用可能な方法があります。WhatsApp Business CallingはSIPをサポートしているため、SIP設定を公開しているプロバイダーなら、番号へのWhatsApp通話をElevenLabsのSIPトランクにルーティングできます。プロバイダーは番号のメッセージを引き続き処理し、通話にはSIP経由でエージェントが応答します。利用できるかどうかはプロバイダーがSIP通話ルーティングをサポートしているかに依存します。お問い合わせいただければ、設定を評価できます。
同じアカウントで独自のWhatsAppアプリを運用している場合（サードパーティプロバイダーではない場合）、ElevenLabsを通話専用に設定できます。アカウント設定でメッセージングを有効にするスイッチをオフにしてください。
会話を人間の担当者に引き継ぐにはどうすればよいですか？
近日提供予定です。エージェントが使用する同じ番号でチームが会話に参加できるようにする、WhatsApp Businessとの共存機能についてMetaと取り組んでいます。
ゼロ保持モードはWhatsAppで利用できますか？
ゼロ保持モードではWhatsApp機能の提供に制限があります。受信メッセージは無視され、アウトバウンド通話は許可されません。
ユーザーがクリックしたWhatsApp広告に基づいてパーソナライズできますか？
まだできません。エージェントはClick-to-WhatsApp広告から開始された会話を受信して応答しますが、Metaの広告紹介メタデータ（ctwa_clid、キャンペーンID、クリエイティブIDなど）は現在、エージェント、動的変数、Webhookには公開されていません。そのため、広告に基づくパーソナライズとアトリビューションはネイティブではサポートされていません。これは機能リクエストとして追跡しています。広告アトリビューションがユースケースで重要な場合は、お問い合わせください。
認証コード（OTP）を送信するにはどうすればよいですか？
コードを本文パラメータとして含むユーティリティテンプレートを使用し、アウトバウンドメッセージエンドポイントから送信してください。コピーコードボタンを含むMetaの認証テンプレートカテゴリは、まだ特別にはサポートされていません。
WhatsAppアカウントのテクノロジープロバイダーは誰ですか？
WhatsAppビジネスアカウントをインポートすると、MetaのパートナーモデルにおいてElevenLabsがそのアカウントのテックプロバイダーとして機能します。ElevenLabsはMetaのテクノロジーパートナーであり、再販業者ではありません。WhatsApp料金は、WhatsApp Managerの支払い方法を通じてMetaから直接請求されます。
EUデータレジデンシーはサポートされていますか？
WhatsApp会話データを含むElevenAgentsのEUデータレジデンシーは、分離されたEU環境を通じてエンタープライズプランで利用できます。これはElevenLabsのインフラストラクチャで処理されるデータを対象とします。WhatsApp自体を介したメッセージ転送は、Metaとの契約に従って管理されます。