> 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でメッセージを送信するツールをエージェントに追加できます。

WhatsAppインテグレーションには3つのツールがあります。

* **メッセージを送信** — 任意のWhatsAppユーザーにテンプレートメッセージを送信します。どのチャネルでも利用できるため、たとえば電話エージェントが発信者のWhatsAppに確認メッセージを送信できます。このページではこのツールについて説明します。
* **インタラクティブボタンを送信**と**インタラクティブリストを送信** — アクティブなWhatsAppメッセージ会話のユーザーに、タップ可能な選択肢を提示します。これらはWhatsAppメッセージ会話内でのみ機能します。詳しくは[インタラクティブメッセージ](/docs/ja/eleven-agents/whatsapp/interactive-messages)を参照してください。

## セットアップ

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

[こちら](/docs/ja/eleven-agents/whatsapp)の手順に従って、WhatsAppビジネスアカウントをインポートします。

#### インテグレーションを追加

[インテグレーションページ](https://elevenlabs.io/app/agents/integrations)に移動し、***Add
integration***ボタンをクリックして、WhatsAppを選択しアカウントを接続します。

![WhatsAppインテグレーション](/docs/_fern-img/e560b1b2a4345bd2fbe9519f7146b87d195268955d2b2aa2c6221629d97e4384.webp)

#### ツールを追加

[ツールページ](https://elevenlabs.io/app/agents/tools)に移動し、***Add integration
tool***ボタンをクリックして、WhatsAppインテグレーションと***Send Message***ツールを選択します。

![WhatsAppツール](/docs/_fern-img/e85dcc3a3e3581250604311c516e080fb7f61f100b98b4b55be5f6071866e888.webp)

## ツールを使用する

#### メッセージテンプレートを作成

[WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/)に移動し、***Manage templates***ページを開いて、メッセージテンプレートを作成します。

![WhatsAppメッセージテンプレート](/docs/_fern-img/e2d2c8bcab0b4c664261a57658627fd4368fc00e4768e4bd4c16264c59d07e16.webp)

> **Info**
>
> 現在、このツールでサポートされているのはメッセージ本文のパラメータのみです。

#### エージェントを設定

エージェント設定に移動して、ツールを追加します。

![エージェント設定：ツール](/docs/_fern-img/0e078a4206030111493387ec6c9bc2235106ac3cb763d4555dd1ae7307c6d46a.webp)

システムプロンプトで、エージェントに以下を伝えます。

* ツールを使用するタイミング
* 使用するテンプレート名と言語コード
* 渡すパラメータ

![エージェント設定：プロンプト](/docs/_fern-img/893aa34f7bd3e01a0cbb919f08f801398de318d46e1d8d1a6c72a945193f7de9.webp)

#### テスト

ツール設定をテストします。

![テスト会話](/docs/_fern-img/47d48232a04cd47112d5637288c6225761f7f66f3016f5fc7d9cf38a34b3782d.webp)![受信したテストメッセージ](/docs/_fern-img/6b3809101caa5d38cf7ea761feb38f4ee316bfde4bef20e2e22eca6b14d0262f.webp)

## パラメータと言語コード

このツールはテンプレートの**本文**パラメータのみを入力します。パラメータ化されたヘッダーまたはボタンを含むテンプレートは、このツールではサポートされていません。受信者にはWhatsAppユーザーIDを指定します。国番号を含む数字のみで、`+`は使用できません（例：`14155552671`）。国別の注意事項については、[受信者番号の形式ルール](/docs/ja/eleven-agents/whatsapp/outbound#recipient-number-format)を参照してください。

テンプレートの言語コードは、WhatsApp Managerでテンプレートを作成した際の言語と一致する必要があります。詳しくは[サポートされている言語コード](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/supported-languages/)を参照してください。よくある間違いは、`en_US`で作成したテンプレートに`en`を渡すことです（またはその逆）。Metaはこれらを別のテンプレートとして扱います。

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

* **テンプレートが見つからない**：テンプレート名または言語コードがWhatsApp Managerのものと完全に一致していないか、テンプレートが接続先とは別のWhatsAppビジネスアカウントに属しています。
* **メッセージは受け付けられたが配信されない**：テンプレートが承認されていない、本文パラメータが不足している、またはアカウントに支払い上の問題があります。詳しくは[トラブルシューティングとFAQ](/docs/ja/eleven-agents/whatsapp/troubleshooting#message-accepted-but-not-delivered)を参照してください。
* **エージェントが誤ったパラメータを渡す**：テンプレートの正確なパラメータ名と想定値をシステムプロンプトに記載し、呼び出し例を1つ示してください。