> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# トラブルシューティングとFAQ

## メッセージは受理されたが配信されない

アウトバウンドメッセージエンドポイントからの`200`レスポンスは、ElevenLabsがリクエストを受理して転送したことを意味します。配信は引き続きMeta側で行われます。メッセージが届かない場合は、次の順に確認してください。

1. **テンプレートの承認** — テンプレートのステータスが[WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/message_templates)で「承認済み」になっている必要があります。保留中または却下されたテンプレートは配信されません。
2. **支払い** — WhatsAppビジネスアカウントに支払い方法が登録されていない、または未払いがあると、テンプレートの配信がブロックされます（Metaエラー131042）。WhatsApp Managerで支払い方法を追加または更新してください。
3. **パラメータの形式** — `template_params`の各エントリはコンポーネントオブジェクト（`{"type": "body", "parameters": [...]}`）である必要があります。テンプレート内のすべてのプレースホルダーを埋め、名前付きテンプレートでは各値に`parameter_name`を設定してください。[テンプレートパラメータ](/docs/ja/eleven-agents/whatsapp/outbound#template-parameters)を参照してください。
4. **受信者の形式** — `whatsapp_user_id`には、国番号を含む数字のみを指定します。`+`は付けません。[受信者番号の形式](/docs/ja/eleven-agents/whatsapp/outbound#recipient-number-format)を参照してください。
5. **マーケティング上限** — Metaでは、1人のユーザーが一定期間に受信できる[マーケティングテンプレート](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/per-user-limits)の数を制限しています（エラー131049）。ユーティリティテンプレートはこの上限の対象外です。

## インポートの問題

* **番号をインポートできない** — 別のWhatsAppプロバイダーに登録されているか、WhatsApp Businessアプリで有効になっています。番号は1つのプロバイダーにしか登録できません。[制限事項](/docs/ja/eleven-agents/whatsapp#limitations)を参照してください。
* **インポートフローにWABAが表示されない** — WABAを所有するビジネスポートフォリオへの管理者アクセス権を持つFacebookアカウントにログインしていることを確認してから、もう一度インポートしてください。
* **Metaデベロッパーアプリで作成されたWABA**は、標準フローではインポートできません。

### 別のパートナーが番号を管理しているか確認する

対象外と表示される、インポートフローに表示されない、またはインポート時にエラーになる番号は、多くの場合、以前のプロバイダーにまだ登録されています。番号を管理しているパートナーがいると、インポート失敗とWABAが表示されない問題の両方を説明できます。

1. [business.facebook.com](https://business.facebook.com)にアクセスし、ビジネスポートフォリオを選択します。
2. **ビジネス設定** > **WhatsAppアカウント**を開きます。
3. 番号が含まれているアカウントを見つけるまで、各WhatsAppアカウントの**電話番号**を確認します。
4. **パートナー**を開きます。
5. そのパートナーから番号を切断する（またはビジネスポートフォリオ全体を削除する）と、数分後に再度インポートできます。

## エージェントが受信メッセージに応答しない

既読通知と入力インジケーターで原因を絞り込めます。これらは、エージェントが返信を生成する前、メッセージが処理用に受理された直後に送信されます。**入力インジケーターを有効にする**がオン（デフォルト）の場合、テストメッセージを送信し、メッセージが既読になり入力インジケーターが表示されるか確認してください。

**入力インジケーターは表示されるが、返信が届かない。** メッセージはElevenLabsに到達し、エージェントは処理を開始しています。失敗は返信の生成中または配信中に発生しています。

* エージェントが、値のない[動的変数](/docs/ja/eleven-agents/customization/personalization/dynamic-variables)を必要としています。受信WhatsApp会話はユーザー提供の動的変数なしで開始され、設定されるのはシステム変数のみです。解決するには、エージェントが必要とするすべての変数を返す[会話開始Webhook](/docs/ja/eleven-agents/customization/personalization#conversation-initiation-webhooks)を設定してください。[初期化コンテキスト](/docs/ja/eleven-agents/whatsapp#initialization-context)を参照してください。エージェントエディターの**動的変数**で入力した値はテスト用プレースホルダーであり、本番環境では使用されません。
* Metaがエージェントの返信を拒否しました。たとえば、このビジネスとユーザーの組み合わせに対するレート制限や、アカウントレベルの支払い問題が考えられます。以下の[エラーリファレンス](#meta-error-reference)を参照してください。

必要な動的変数が存在しない場合、会話は失敗します。

**入力インジケーターが表示されない。** メッセージはエージェントに届く前に破棄されました。

* 番号にエージェントが割り当てられていない、または**メッセージングを有効にする**スイッチがオフになっています。[WhatsAppページ](https://elevenlabs.io/app/agents/whatsapp)のアカウント設定を確認してください。
* アカウントの認証が無効になっています。Meta側でアクセストークンの期限が切れたか、取り消されています。[WhatsAppページ](https://elevenlabs.io/app/agents/whatsapp)でアカウントを再インポートしてください。
* エージェントのワークスペースが[ゼロ保持モード](/docs/ja/eleven-api/resources/zero-retention-mode)になっており、受信WhatsAppメッセージを完全に無視しています。
* 受信メッセージがサポートされていない種類です（例：動画、WhatsApp Flowの返信）。[制限事項](/docs/ja/eleven-agents/whatsapp#limitations)を参照してください。

> **Note**
>
> アカウントで**入力インジケーターを有効にする**がオフになっている場合、この確認は適用されません。両方のリストを確認してください。

## テンプレート後の最初の返信の挙動がおかしい

エージェントの**セキュリティ**タブで**最初のメッセージ**のオーバーライドが有効になっている場合、アウトバウンドテンプレート会話と競合することがあります。テンプレートがすでに最初のメッセージとして送信されているためです。テンプレートへの返信が想定どおりに動作しない場合は、WhatsAppアウトバウンドメッセージで使用するエージェントの最初のメッセージオーバーライドを削除してください。

## Metaエラーリファレンス

Metaが配信中に返すエラーには、可能な場合は対処方法が表示されます。よくあるエラーは次のとおりです。

| コード    | 意味                              | 対処方法                                                                                                               |
| ------ | ------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| 131042 | WhatsAppビジネスアカウントの支払い問題         | WhatsApp Managerで支払い方法を追加または修正する                                                                                   |
| 131056 | このビジネスとユーザーの組み合わせに対するレート制限      | このユーザーへのメッセージ送信速度を落とす                                                                                              |
| 131047 | 再エンゲージメントが必要                    | カスタマーサービスウィンドウが終了しました。テンプレートで再エンゲージメントしてください                                                                       |
| 130497 | 特定の国のユーザーへのメッセージ送信がビジネスに制限されている | Metaがアカウントの国をまたぐメッセージ送信を制限しています。Metaサポートで解決してください                                                                  |
| 132000 | パラメータ数がテンプレートと一致しない             | テンプレートで定義されたパラメータを正確に送信してください。[テンプレートパラメータ](/docs/ja/eleven-agents/whatsapp/outbound#template-parameters)を参照してください |
| 132001 | テンプレートが存在しない                    | テンプレート名と言語コード、およびテンプレートが承認済みであることを確認してください                                                                         |
| 131037 | 電話番号の表示名に関する問題                  | WhatsApp Managerで表示名の承認を完了してください                                                                                   |
| 190    | アクセストークンの期限切れ                   | [WhatsAppページ](https://elevenlabs.io/app/agents/whatsapp)でアカウントを再インポートしてください                                        |

完全な一覧は、[Metaのエラーコードリファレンス](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)を参照してください。

## FAQ

#### WhatsAppの利用料金はどのように請求されますか？

2つの事業者から、それぞれ独立して請求されます。

**ElevenLabs**は、エージェントの利用分（会話時間、メッセージ、ボイスノートのスピーチtoテキストとテキスト読み上げ、LLMの利用）を、通常の[ElevenLabs請求](/docs/ja/overview/administration/billing)に従ってプランのクレジットから請求します。

**Meta**は、テンプレートメッセージ、アウトバウンド通話、通話許可リクエストなどのWhatsApp料金を別途請求します。料金はWhatsApp Managerの支払い方法を通じて請求されます。料金はメッセージカテゴリと国によって異なります。またMetaは、2026年10月1日から料金改定を実施すると発表しています。対象市場に適用される料金については、[MetaのWhatsApp料金](https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing)を参照してください。

#### ElevenLabsを別のWhatsAppプロバイダーと併用できますか？

現在、番号は1つのメッセージングプロバイダーにのみ登録できます。サードパーティプロバイダー（例：Gupshup）がアカウントを管理している場合、そのアカウントをElevenLabsにもインポートすることはできません。1つの番号で複数のプロバイダーを利用できる[Multi-Solution Conversations](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/multi-solution-conversations)を有効にするため、Metaと取り組んでいます。

**SIP経由の音声。** 現在のプロバイダーでメッセージングを維持しながら、音声にはElevenLabsエージェントを使用したい場合、現在利用可能な方法があります。WhatsApp Business CallingはSIPをサポートしているため、SIP設定を公開しているプロバイダーなら、番号へのWhatsApp通話をElevenLabsの[SIPトランク](/docs/ja/eleven-agents/phone-numbers/sip-trunking)にルーティングできます。プロバイダーは番号のメッセージを引き続き処理し、通話にはSIP経由でエージェントが応答します。利用できるかどうかはプロバイダーがSIP通話ルーティングをサポートしているかに依存します。[お問い合わせ](https://elevenlabs.io/contact-sales)いただければ、設定を評価できます。

同じアカウントで独自のWhatsAppアプリを運用している場合（サードパーティプロバイダーではない場合）、ElevenLabsを通話専用に設定できます。アカウント設定で***メッセージングを有効にする***スイッチをオフにしてください。

#### 会話を人間の担当者に引き継ぐにはどうすればよいですか？

近日提供予定です。エージェントが使用する同じ番号でチームが会話に参加できるようにする、WhatsApp Businessとの共存機能についてMetaと取り組んでいます。

#### ゼロ保持モードはWhatsAppで利用できますか？

[ゼロ保持モード](/docs/ja/eleven-api/resources/zero-retention-mode)ではWhatsApp機能の提供に制限があります。受信メッセージは無視され、アウトバウンド通話は許可されません。

#### ユーザーがクリックしたWhatsApp広告に基づいてパーソナライズできますか？

まだできません。エージェントはClick-to-WhatsApp広告から開始された会話を受信して応答しますが、Metaの広告紹介メタデータ（`ctwa_clid`、キャンペーンID、クリエイティブIDなど）は現在、エージェント、動的変数、Webhookには公開されていません。そのため、広告に基づくパーソナライズとアトリビューションはネイティブではサポートされていません。これは機能リクエストとして追跡しています。広告アトリビューションがユースケースで重要な場合は、[お問い合わせ](https://elevenlabs.io/contact-sales)ください。

#### 認証コード（OTP）を送信するにはどうすればよいですか？

コードを本文パラメータとして含むユーティリティテンプレートを使用し、[アウトバウンドメッセージエンドポイント](/docs/ja/eleven-agents/whatsapp/outbound)から送信してください。コピーコードボタンを含むMetaの認証テンプレートカテゴリは、まだ特別にはサポートされていません。

#### WhatsAppアカウントのテクノロジープロバイダーは誰ですか？

WhatsAppビジネスアカウントをインポートすると、MetaのパートナーモデルにおいてElevenLabsがそのアカウントの**テックプロバイダー**として機能します。ElevenLabsはMetaのテクノロジーパートナーであり、再販業者ではありません。WhatsApp料金は、WhatsApp Managerの支払い方法を通じてMetaから直接請求されます。

#### EUデータレジデンシーはサポートされていますか？

WhatsApp会話データを含むElevenAgentsのEUデータレジデンシーは、分離されたEU環境を通じてエンタープライズプランで利用できます。これはElevenLabsのインフラストラクチャで処理されるデータを対象とします。WhatsApp自体を介したメッセージ転送は、Metaとの契約に従って管理されます。