快速入门

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

这里有两个关键点：

• template_params 是组件对象列表——必须包含 {"type": "body", ...} 包装层。
• whatsapp_user_id 只能包含数字，需带国家代码且不含 +（例如 14155552671）。

在 WhatsApp 页面的账号菜单中，通过 复制电话号码 ID 选项查找 whatsapp_phone_number_id。

手机会收到该模板。回复它——智能体将从这里继续对话。