WhatsAppビジネスアカウントをElevenLabs Agentsに接続
概要
WhatsAppビジネスアカウントをElevenLabsエージェントに接続できます。エージェントは次の対応を行えます。
- メッセージでの会話 — テキスト、ボイスメモ、メディア、インタラクティブメッセージ
- 通話 — 着信および発信
他のチャネル上のエージェントも、WhatsAppツールを通じてWhatsAppメッセージを送信できます。
ElevenLabsでWhatsAppを初めて利用する場合は、スタートガイドをご覧ください。
WhatsAppビジネスアカウントをインポートする
エージェントを割り当てる
アカウントのインポートが完了すると設定ページが表示され、エージェントを割り当てられます。
アカウントにエージェントを割り当てない場合、受信メッセージは無視され、着信通話 は拒否されます。ただし、発信は引き続き可能です。
WhatsApp Managerを設定する
WhatsApp Managerで以下を設定します。
- プロフィール画像などを設定する：電話番号ページを開き、電話番号を選択してプロフィールタブに移動します
- 音声通話を許可する：電話番号ページを開き、電話番号を選択して通話設定タブに移動します
- 発信する場合は支払い方法を追加する：概要ページを開き、支払い方法を追加ボタンをクリックします
アカウント設定
インポートした各番号には、エージェントの動作を制御する設定があります。
- メッセージを有効にする — エージェントがメッセージに応答するかどうか。オフにすると、独自のアプリケーションでメッセージを処理しつつ、ElevenLabsでは通話のみを処理できます。
- 音声メッセージへの応答を有効にする — オン（デフォルト）の場合、エージェントはボイスメモにボイスメモで応答します。オフの場合は常にテキストで返信します。
- 入力中インジケーターを有効にする — オン（デフォルト）の場合、エージェントは受信メッセージを既読にし、応答を作成している間は入力中インジケーターを表示します。
メッセージでの会話
WhatsAppのメッセージ会話は、エージェントが会話を終了システム ツールを使用したとき、設定した最大 会話時間が経過したとき、またはエージェントの直近の応答後にデフォルトの非アクティブタイムアウトが経過したときに終了します。
WhatsAppのメッセージ会話には、エージェントの直近の応答から計測されるデフォルト15分間の非アクティブタイムアウトがあります。会話の タイムアウトについて詳しくはこちらをご覧ください。
受信
WhatsAppビジネスアカウントにメッセージを送信すると、エージェントが応答します。
いずれかのタイムアウトが切れると、ElevenAgentsは会話を終了する前に設定済みの最大会話時間 メッセージを送信します。メッセージが空の場合、別れのメッセージなしで会話を終了します。
エージェントはプレーンテキスト以外も理解できます。
- 引用返信 — ユーザーがメッセージを長押しして返信すると、エージェントはどのメッセージへの返信かを認識します。
- リアクション — エージェントのメッセージに対する絵文字リアクションは、エージェントに渡されます。
- テンプレートボタンのタップ — ユーザーがテンプレートのクイック返信ボタンをタップすると、エージェントは選択されたボタンを認識します。
- インタラクティブ返信 — インタラクティブボタンとリストのタップは、選択されたオプションとともに届きます。
エージェントは受信メッセージごとに個別に応答します。短時間に連続して届いたメッセージが 1つの返信にまとめられることはありません。
発信
ダッシュボードまたはAPIからMeta承認済みのメッセージテンプレートを送信して会話を開始でき、通話許可リクエストを使って発信通話をスケジュールできます。テンプレートの作成、コード例、受信者形式のルール、バッチキャンペーンについては、発信メッセージとテンプレートをご覧ください。
メッセージタイプ
テキストに加えて、次のコンテンツも送信できます。
- オーディオ
- 受信したボイスメモは、エージェントに渡される前にテキストに文字起こしされます。
- デフォルトでは、エージェントはボイスメモに対し、設定した音声（どの音声、どの言語でも可）で生成されたボイスメモで応答します。アカウント設定で音声メッセージへの応答を有効にするをオフにすると、常にテキストで応答します。オーディオ生成に失敗した場合、エージェントはテキスト返信にフォールバックします。
- オーディオメッセージには、スピーチtoテキストとテキスト読み上げの追加料金がかかります。料金はSTTおよびTTS APIと同じです。
- 画像
- ドキュメント
- ステッカー
- 位置情報
- 連絡先
通話
着信
WhatsAppビジネスアカウントに電話をかけると、エージェントが応答します。通話中にテキストメッセージを送信することもでき、それらは会話に反映されます。
発信
発信通話には、テンプレートでリクエストするユーザーの許可が必要です。フロー、コード例、バッチ発信については、発信通話をスケジュールするをご覧ください。
パーソナライゼーション
{{system__caller_id}}および{{system__called_number}}の動的変数には、WhatsAppユーザーIDとWhatsApp電話番号IDが設定されます（会話を開始した側に応じて逆になります）。これらをツールや会話開始Webhookで使用すると、会話中のユーザーに関する情報を取得できます。
WhatsApp電話番号IDは、WhatsApp ページに移動し、アカウントの横にあるメニューをクリックして 電話番号IDをコピーを選択すると確認できます。
初期化コンテキスト
エージェントが上記のシステム変数以外の動的変数を使用する場合は、その値の取得元を計画する必要があります。エージェントが動的変数を使用しない場合、これは該当しません。
受信会話は、ユーザーが指定した動的変数なしで開始されます。値を提供するための対応方法は会話開始Webhookです。WhatsAppメッセージが会話を開始すると、ElevenAgentsはWhatsAppユーザーIDをcaller_id、WhatsApp電話番号IDをcalled_numberとしてエンドポイントを呼び出し、レスポンスで返された動的変数を適用します。Webhookでは、エージェントに必要なすべての変数を必ず返してください。CRM値がある場合はその値を、ない場合はフォールバック定数を返します。
エージェントエディターの動的変数に入力した値は、エージェントをプレビューするためのテスト用プレースホルダーです。本番環境では 使用されず、受信会話のデフォルト値にもなりません。
発信会話は、発信メッセージまたは通話リクエストのconversation_initiation_client_data.dynamic_variablesフィールドから値を受け取ります。これらの値は会話中保持され、ユーザーが返信したときにも利用できます。テンプレートパラメーターは別のフィールドであり、動的変数には設定されません。
必須変数に値が設定されない場合、会話は失敗します。トラブルシューティングガイドの不足している動的変数をご覧ください。
system__called_numberの値は電話番号そのものではなく、WhatsAppの電話番号IDです。WhatsAppユーザー識別子もビジネススコープユーザーID
（BSUID）へ移行中です。
ElevenAgentsはBSUIDをサポートしているため、Metaがユーザーの電話番号ではなくIDを提供する場合でも会話は機能します。
制限事項
現在、以下はサポートされていません。
- WhatsApp Flows — インタラクティブフォームは送信できず、Flowの返信もエージェントに渡されません。
- ビデオメッセージ — 受信したビデオはエージェントに渡されません。
- メッセージのバッチ処理 — エージェントは、短時間に連続して届いたメッセージをまとめず、各メッセージに個別に返信します。
- 他のプロバイダーが管理する番号 — 別のWhatsAppプロバイダーに登録されている番号、またはWhatsApp Businessアプリで有効な番号はインポートできません。Metaと協力してマルチソリューション会話を有効化する作業を進めています。音声のみの構成は、すでにSIP経由で利用できる場合があります（FAQをご覧ください）。
- デベロッパーアプリで作成されたWABA — 標準フローではインポートできません。
- 広告紹介メタデータ — Click-to-WhatsApp広告のアトリビューションデータはエージェントに公開されません（FAQをご覧ください）。
- 有人対応への引き継ぎ — 近日提供予定です（FAQをご覧ください）。
FAQ
料金、マルチプロバイダー構成、有人対応への引き継ぎ、ゼロリテンションモード、OTP、コンプライアンスなどのよくある質問については、トラブルシューティングとFAQをご覧ください。