はじめに

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

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

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

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

この番号でのエージェントの動作を設定します（完全なリファレンスはアカウント 設定をご覧ください）：

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

最初の会話をする

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

会話は進行中に会話履歴に表示されます。

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

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

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

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

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",
)

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

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

whatsapp_phone_number_idは、WhatsAppページのアカウントメニューにある電話番号IDをコピーオプションから確認できます。

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