> 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のテキストメッセージとボイスノートに応答し、APIから開始したテンプレートメッセージを1件送信できるようになります。所要時間は約20分です。加えて、Metaによる最初のテンプレートの承認を少し待つ必要があります。

## 始める前に

必要なもの：

* [ElevenLabsエージェント](/docs/ja/eleven-agents/quickstart)。既存のエージェントであればどれでも使えます。
* 管理できる[Metaビジネスポートフォリオ](https://business.facebook.com/)。
* 現在WhatsApp Businessアプリで使用されておらず、別のWhatsAppプロバイダーにも登録されていない電話番号。他で使用中の番号はインポートできません。詳しくは[制限事項](/docs/ja/eleven-agents/whatsapp#limitations)をご覧ください。
* テンプレートの送信または通話を行う場合は、[WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/)の支払い方法。Metaからの請求はElevenLabsとは別です。

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

[WhatsAppページ](https://elevenlabs.io/app/agents/whatsapp)に移動し、***アカウントをインポート***ボタンをクリックします。Metaの認可フローが開くので、WhatsAppビジネスアカウントと電話番号を選択（または作成）し、ElevenLabsに管理権限を付与します：

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

#### エージェントを割り当て、動作を選択する

インポート後、アカウント設定ページが開きます。エージェントを割り当ててください。割り当てるまで、受信メッセージは無視され、受信通話は拒否されます：

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

この番号でのエージェントの動作を設定します（完全なリファレンスは[アカウント 設定](/docs/ja/eleven-agents/whatsapp#account-settings)をご覧ください）：

* **メッセージングを有効化** — エージェントがメッセージに応答するかどうか。別のシステムがメッセージを処理し、ElevenLabsには通話のみを処理させる場合はオフにします。
* **音声メッセージへの応答を有効化** — オンの場合、エージェントはボイスノートに自身の声のボイスノートで応答します。オフの場合は、常にテキストで返信します。
* **入力インジケーターを有効化** — オンの場合、エージェントは受信メッセージを既読にし、処理中は入力インジケーターを表示します。

#### 最初の会話をする

個人の電話からビジネス用番号にメッセージを送信します。エージェントが返信します。ボイスノートを送ると、エージェント用に文字起こしされ、エージェントもボイスノートで応答します：

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

会話は進行中に[会話履歴](https://elevenlabs.io/app/agents/history)に表示されます。

> **Info**
>
> メッセージ会話は、エージェントが***会話を終了***システムツールを使用したとき、
> ***最大会話時間***が経過したとき、またはエージェントの最後の応答後にデフォルトの15分間の非アクティブタイムアウトが経過したときに終了します。
> ユーザーからの次のメッセージで、新しい会話が始まります。詳しくは[会話 タイムアウト](/docs/ja/eleven-agents/customization/conversation-flow#maximum-conversation-duration)をご覧ください。

#### 最初の送信メッセージを送る

ユーザーに最初に連絡するには、Metaが承認した**メッセージテンプレート**が必要です。WhatsAppでは、自由形式のビジネスメッセージを送信できるのはアクティブな会話内だけです。[WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/message_templates)で、次のようなシンプルなユーティリティテンプレートを作成します：

```text
Hi {{name}}, thanks for signing up. Reply here if you have any questions.
```

テンプレートが承認されたら、送信します：

#### Python

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.whatsapp.outbound_message(
    whatsapp_phone_number_id="524029457612345",
    whatsapp_user_id="12213231492",
    template_name="welcome",
    template_language_code="en",
    template_params=[
        {
            "type": "body",
            "parameters": [
                {"type": "text", "parameter_name": "name", "text": "Daniele"}
            ],
        }
    ],
    agent_id="agent_9201kwcrbq9qfxaa2t8nnnkqf2w9",
)
```

#### TypeScript

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.whatsapp.outboundMessage({
  whatsappPhoneNumberId: "524029457612345",
  whatsappUserId: "12213231492",
  templateName: "welcome",
  templateLanguageCode: "en",
  templateParams: [
    {
      type: "body",
      parameters: [{ type: "text", parameterName: "name", text: "Daniele" }],
    },
  ],
  agentId: "agent_9201kwcrbq9qfxaa2t8nnnkqf2w9",
});
```

#### cURL

```bash
curl -X POST https://api.elevenlabs.io/v1/convai/whatsapp/outbound-message \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "whatsapp_phone_number_id": "524029457612345",
    "whatsapp_user_id": "12213231492",
    "template_name": "welcome",
    "template_language_code": "en",
    "template_params": [
      {
        "type": "body",
        "parameters": [
          {"type": "text", "parameter_name": "name", "text": "Daniele"}
        ]
      }
    ],
    "agent_id": "agent_9201kwcrbq9qfxaa2t8nnnkqf2w9"
  }'
```

ここでは2点が重要です：

* `template_params`はコンポーネントオブジェクトのリストです。`{"type": "body", ...}`のラッパーは必須です。
* `whatsapp_user_id`は国番号を含む数字のみで、`+`は付けません（例：`14155552671`）。

`whatsapp_phone_number_id`は、[WhatsAppページ](https://elevenlabs.io/app/agents/whatsapp)のアカウントメニューにある***電話番号IDをコピー***オプションから確認できます。

電話にテンプレートが届きます。返信すると、エージェントがそこから会話を引き継ぎます。

## うまくいかない場合

* **エージェントがまったく返信しない**：番号にエージェントが割り当てられていないか、**メッセージングを有効化**がオフになっています。これらに問題がない場合は、エージェントに[動的変数](/docs/ja/eleven-agents/customization/personalization/dynamic-variables)が必要か確認してください。受信WhatsApp会話はユーザー提供の値なしで開始するため、ツールまたは最初のメッセージで値を必要とするエージェントは、会話開始Webhookで値が提供されない限り、返信前に失敗します。[初期化コンテキスト](/docs/ja/eleven-agents/whatsapp#initialization-context)をご覧ください。
* **インポートに失敗する**：番号がすでに別のプロバイダーまたはWhatsApp Businessアプリに登録されています。
* **APIが200を返したのにメッセージが届かない**：テンプレートがまだ承認されていない、パラメーターがテンプレートと一致しない、またはWhatsAppビジネスアカウントに未決済の支払いがあります（Metaエラー131042）。
* **ユーザーの返信がコンテキストなしの別会話として開始された**：受信者IDの形式が正しくありません。[受信者番号の形式](/docs/ja/eleven-agents/whatsapp/outbound#recipient-number-format)をご覧ください。

その他については、[トラブルシューティングとFAQ](/docs/ja/eleven-agents/whatsapp/troubleshooting)をご覧ください。

## 次のステップ

* [動的変数](/docs/ja/eleven-agents/whatsapp/outbound#dynamic-variables-branches-and-environments)と[パーソナライズ用システム変数](/docs/ja/eleven-agents/whatsapp#personalization)で会話をパーソナライズします。
* [送信メッセージとテンプレート](/docs/ja/eleven-agents/whatsapp/outbound)で大規模なアウトリーチを実行します。
* [インタラクティブメッセージ](/docs/ja/eleven-agents/whatsapp/interactive-messages)で、エージェントがタップ可能な選択肢を提示できるようにします。
* [WhatsAppツール](/docs/ja/eleven-agents/whatsapp/tools)で、他チャネルのエージェントからWhatsAppメッセージを送信します。
* [料金FAQ](/docs/ja/eleven-agents/whatsapp/troubleshooting#faq)でコストを確認します。