> 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.

# WhatsApp

## 概要

WhatsAppビジネスアカウントをElevenLabsエージェントに接続できます。エージェントは次の対応を行えます。

* メッセージでの会話 — テキスト、ボイスメモ、メディア、[インタラクティブメッセージ](/docs/ja/eleven-agents/whatsapp/interactive-messages)
* 通話 — 着信および[発信](/docs/ja/eleven-agents/whatsapp/outbound#scheduling-an-outbound-call)

他のチャネル上のエージェントも、[WhatsAppツール](/docs/ja/eleven-agents/whatsapp/tools)を通じてWhatsAppメッセージを送信できます。

ElevenLabsでWhatsAppを初めて利用する場合は、[スタートガイド](/docs/ja/eleven-agents/whatsapp/getting-started)をご覧ください。

## WhatsAppビジネスアカウントをインポートする

#### アカウントをインポートする

[WhatsAppページ](https://elevenlabs.io/app/agents/whatsapp)に移動し、***アカウントをインポート***ボタンをクリックします。

![WhatsAppページ](/docs/_fern-img/734d6e0c2af1c50b769700e084368bed2a8c7eccf47aece6cfb6fc5ca7623f44.webp)

#### ElevenLabsを認可する

認可フローが開くので、アカウントを選択し、ElevenLabsに管理権限を付与します。

![WhatsApp認可フロー](/docs/_fern-img/9e5238e98f926582db314e9debc187a7dc29fd38a980cb732b4563b373110351.webp)

#### エージェントを割り当てる

アカウントのインポートが完了すると設定ページが表示され、エージェントを割り当てられます。

![WhatsAppアカウントページ](/docs/_fern-img/f5598ac70ade00048effb5ee3bf6cbc93cd61876652eb3ce5917ac21c6209bf6.webp)

> **Info**
>
> アカウントにエージェントを割り当てない場合、受信メッセージは無視され、着信通話
> は拒否されます。ただし、発信は引き続き可能です。

#### WhatsApp Managerを設定する

[WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/)で以下を設定します。

* プロフィール画像などを設定する：***電話番号***ページを開き、電話番号を選択して***プロフィール***タブに移動します
* 音声通話を許可する：***電話番号***ページを開き、電話番号を選択して***通話設定***タブに移動します
* 発信する場合は支払い方法を追加する：***概要***ページを開き、***支払い方法を追加***ボタンをクリックします

## アカウント設定

インポートした各番号には、エージェントの動作を制御する設定があります。

* **メッセージを有効にする** — エージェントがメッセージに応答するかどうか。オフにすると、独自のアプリケーションでメッセージを処理しつつ、ElevenLabsでは通話のみを処理できます。
* **音声メッセージへの応答を有効にする** — オン（デフォルト）の場合、エージェントはボイスメモにボイスメモで応答します。オフの場合は常にテキストで返信します。
* **入力中インジケーターを有効にする** — オン（デフォルト）の場合、エージェントは受信メッセージを既読にし、応答を作成している間は入力中インジケーターを表示します。

## メッセージでの会話

WhatsAppのメッセージ会話は、エージェントが[***会話を終了***システム ツール](/docs/ja/eleven-agents/customization/tools/system-tools/end-call)を使用したとき、設定した***最大
会話時間***が経過したとき、またはエージェントの直近の応答後にデフォルトの非アクティブタイムアウトが経過したときに終了します。

> **Info**
>
> WhatsAppのメッセージ会話には、エージェントの直近の応答から計測されるデフォルト15分間の非アクティブタイムアウトがあります。[会話の タイムアウト](/docs/ja/eleven-agents/customization/conversation-flow#maximum-conversation-duration)について詳しくはこちらをご覧ください。

### 受信

WhatsAppビジネスアカウントにメッセージを送信すると、エージェントが応答します。

![WhatsAppテキスト会話](/docs/_fern-img/4c31b4d2b5eccccd7cddfa81144176a6d3c32f4670add5306f3a6ef78bc05244.webp)

いずれかのタイムアウトが切れると、ElevenAgentsは会話を終了する前に設定済みの***最大会話時間
メッセージ***を送信します。メッセージが空の場合、別れのメッセージなしで会話を終了します。

エージェントはプレーンテキスト以外も理解できます。

* **引用返信** — ユーザーがメッセージを長押しして返信すると、エージェントはどのメッセージへの返信かを認識します。
* **リアクション** — エージェントのメッセージに対する絵文字リアクションは、エージェントに渡されます。
* **テンプレートボタンのタップ** — ユーザーがテンプレートのクイック返信ボタンをタップすると、エージェントは選択されたボタンを認識します。
* **インタラクティブ返信** — [インタラクティブボタンとリスト](/docs/ja/eleven-agents/whatsapp/interactive-messages)のタップは、選択されたオプションとともに届きます。

> **Note**
>
> エージェントは受信メッセージごとに個別に応答します。短時間に連続して届いたメッセージが
> 1つの返信にまとめられることはありません。

### 発信

ダッシュボードまたはAPIからMeta承認済みのメッセージテンプレートを送信して会話を開始でき、通話許可リクエストを使って発信通話をスケジュールできます。テンプレートの作成、コード例、受信者形式のルール、バッチキャンペーンについては、[発信メッセージとテンプレート](/docs/ja/eleven-agents/whatsapp/outbound)をご覧ください。

### メッセージタイプ

テキストに加えて、次のコンテンツも送信できます。

* オーディオ
  * 受信したボイスメモは、エージェントに渡される前にテキストに文字起こしされます。
  * デフォルトでは、エージェントはボイスメモに対し、設定した音声（どの音声、どの言語でも可）で生成されたボイスメモで応答します。アカウント設定で***音声メッセージへの応答を有効にする***をオフにすると、常にテキストで応答します。オーディオ生成に失敗した場合、エージェントはテキスト返信にフォールバックします。
  * オーディオメッセージには、スピーチtoテキストとテキスト読み上げの追加料金がかかります。料金はSTTおよびTTS APIと同じです。
* 画像
* ドキュメント
* ステッカー
* 位置情報
* 連絡先

![WhatsAppオーディオ会話](/docs/_fern-img/372158bc0f86d62b6742f2bb44a741e5299ee7b95e36e38c3df1f9c06cffe2a0.webp)![WhatsApp画像会話](/docs/_fern-img/cbfbadb9d0a20f35537ce3bd137eb12b1005a862a7e1cf0155d271502fb713da.webp)![WhatsAppドキュメント会話](/docs/_fern-img/2b91d4077ac19a56dda9c5c016a47ed7d574ba2cb77ac89eb8785925bc89fa13.webp)![WhatsApp位置情報会話](/docs/_fern-img/bcd0d8f7df69d6c381be5be7c7a91ec7752b2b1894a80539823b7d9266beb3dd.webp)![WhatsApp連絡先会話](/docs/_fern-img/75e56544700c87817a7f842943301a95e9e0b1fb84fc87e19139adb77f49ea5a.webp)

## 通話

### 着信

WhatsAppビジネスアカウントに電話をかけると、エージェントが応答します。通話中にテキストメッセージを送信することもでき、それらは会話に反映されます。

### 発信

発信通話には、テンプレートでリクエストするユーザーの許可が必要です。フロー、コード例、バッチ発信については、[発信通話をスケジュールする](/docs/ja/eleven-agents/whatsapp/outbound#scheduling-an-outbound-call)をご覧ください。

## パーソナライゼーション

`{{system__caller_id}}`および`{{system__called_number}}`の[動的変数](/docs/ja/eleven-agents/customization/personalization/dynamic-variables)には、WhatsAppユーザーIDとWhatsApp電話番号IDが設定されます（会話を開始した側に応じて逆になります）。これらをツールや[会話開始Webhook](/docs/ja/eleven-agents/customization/personalization#conversation-initiation-webhooks)で使用すると、会話中のユーザーに関する情報を取得できます。

> **Info**
>
> WhatsApp電話番号IDは、[WhatsApp ページ](https://elevenlabs.io/app/agents/whatsapp)に移動し、アカウントの横にあるメニューをクリックして
> ***電話番号IDをコピー***を選択すると確認できます。

### 初期化コンテキスト

エージェントが上記のシステム変数以外の[動的変数](/docs/ja/eleven-agents/customization/personalization/dynamic-variables)を使用する場合は、その値の取得元を計画する必要があります。エージェントが動的変数を使用しない場合、これは該当しません。

**受信会話**は、ユーザーが指定した動的変数なしで開始されます。値を提供するための対応方法は[会話開始Webhook](/docs/ja/eleven-agents/customization/personalization#conversation-initiation-webhooks)です。WhatsAppメッセージが会話を開始すると、ElevenAgentsはWhatsAppユーザーIDを`caller_id`、WhatsApp電話番号IDを`called_number`としてエンドポイントを呼び出し、レスポンスで返された動的変数を適用します。Webhookでは、エージェントに必要なすべての変数を必ず返してください。CRM値がある場合はその値を、ない場合はフォールバック定数を返します。

> **Warning**
>
> エージェントエディターの**動的変数**に入力した値は、エージェントをプレビューするためのテスト用プレースホルダーです。本番環境では
> 使用されず、受信会話のデフォルト値にもなりません。

**発信会話**は、[発信メッセージまたは通話リクエスト](/docs/ja/eleven-agents/whatsapp/outbound#dynamic-variables-branches-and-environments)の`conversation_initiation_client_data.dynamic_variables`フィールドから値を受け取ります。これらの値は会話中保持され、ユーザーが返信したときにも利用できます。テンプレートパラメーターは別のフィールドであり、動的変数には設定されません。

必須変数に値が設定されない場合、会話は失敗します。トラブルシューティングガイドの[不足している動的変数](/docs/ja/eleven-agents/whatsapp/troubleshooting#the-agent-doesnt-respond-to-inbound-messages)をご覧ください。

> **Note**
>
> `system__called_number`の値は電話番号そのものではなく、WhatsAppの**電話番号ID**です。WhatsAppユーザー識別子も[ビジネススコープユーザーID （BSUID）](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids)へ移行中です。
> ElevenAgentsはBSUIDをサポートしているため、Metaがユーザーの電話番号ではなくIDを提供する場合でも会話は機能します。

## 制限事項

現在、以下はサポートされていません。

* **WhatsApp Flows** — インタラクティブフォームは送信できず、Flowの返信もエージェントに渡されません。
* **ビデオメッセージ** — 受信したビデオはエージェントに渡されません。
* **メッセージのバッチ処理** — エージェントは、短時間に連続して届いたメッセージをまとめず、各メッセージに個別に返信します。
* **他のプロバイダーが管理する番号** — 別のWhatsAppプロバイダーに登録されている番号、またはWhatsApp Businessアプリで有効な番号はインポートできません。Metaと協力して[マルチソリューション会話](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/multi-solution-conversations)を有効化する作業を進めています。音声のみの構成は、すでにSIP経由で利用できる場合があります（[FAQ](/docs/ja/eleven-agents/whatsapp/troubleshooting#faq)をご覧ください）。
* **デベロッパーアプリで作成されたWABA** — 標準フローではインポートできません。
* **広告紹介メタデータ** — Click-to-WhatsApp広告のアトリビューションデータはエージェントに公開されません（[FAQ](/docs/ja/eleven-agents/whatsapp/troubleshooting#faq)をご覧ください）。
* **有人対応への引き継ぎ** — 近日提供予定です（[FAQ](/docs/ja/eleven-agents/whatsapp/troubleshooting#faq)をご覧ください）。

## FAQ

料金、マルチプロバイダー構成、有人対応への引き継ぎ、ゼロリテンションモード、OTP、コンプライアンスなどのよくある質問については、[トラブルシューティングとFAQ](/docs/ja/eleven-agents/whatsapp/troubleshooting)をご覧ください。