Primeiros passos

Importe sua conta comercial do WhatsApp

Acesse a página do WhatsApp e clique no botão Importar conta. Isso abre o fluxo de autorização da Meta, no qual você seleciona (ou cria) a conta comercial e o número de telefone do WhatsApp e concede à ElevenLabs permissão para gerenciá-los:

Atribua seu agente e escolha os comportamentos

Após a importação, você chegará à página de configurações da conta. Atribua um agente — até fazer isso, as mensagens recebidas serão ignoradas e as chamadas recebidas serão recusadas:

Configure como o agente se comporta nesse número (consulte as configurações da conta para ver a referência completa):

• Ativar mensagens — define se o agente responde às mensagens. Desative se outro sistema gerencia as mensagens e a ElevenLabs deve lidar apenas com chamadas.
• Ativar resposta a mensagens de áudio — quando ativado, o agente responde a áudios com áudios na própria voz; quando desativado, sempre responde com texto.
• Ativar indicador de digitação — quando ativado, o agente marca as mensagens recebidas como lidas e exibe um indicador de digitação enquanto trabalha.

Tenha sua primeira conversa

Envie uma mensagem para o número comercial usando um telefone pessoal. O agente responderá. Envie um áudio — ele será transcrito para o agente, e o agente responderá com um áudio próprio:

A conversa aparece no seu histórico de conversas conforme acontece.

Envie sua primeira mensagem de saída

Para entrar em contato com um usuário primeiro, é necessário um modelo de mensagem aprovado pela Meta — o WhatsApp permite mensagens comerciais de formato livre apenas dentro de uma conversa ativa. Crie um modelo simples de Utilidade no Gerenciador do WhatsApp, por exemplo:

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

Quando o modelo for aprovado, envie-o:

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

Dois detalhes são importantes aqui:

• template_params é uma lista de objetos de componente — o envoltório {"type": "body", ...} é obrigatório.
• whatsapp_user_id contém apenas dígitos, com código do país e sem + (por exemplo, 14155552671).

Encontre seu whatsapp_phone_number_id na página do WhatsApp, usando a opção Copiar ID do número de telefone no menu da conta.

Seu telefone receberá o modelo. Responda a ele — o agente continuará a conversa a partir daí.