> 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.

# Primeiros passos

## O que você vai criar

Ao final deste guia, seu agente responderá mensagens de texto e áudios do WhatsApp no número da sua empresa, e você terá enviado uma mensagem de modelo iniciada por API. Reserve cerca de 20 minutos, além de uma breve espera para a Meta aprovar seu primeiro modelo.

## Antes de começar

Você precisa de:

* Um [agente da ElevenLabs](/docs/pt/eleven-agents/quickstart). Qualquer agente existente serve.
* Um [portfólio empresarial da Meta](https://business.facebook.com/) que você possa administrar.
* Um número de telefone que **não** esteja sendo usado atualmente no app WhatsApp Business nem registrado com outro provedor de WhatsApp. Não é possível importar números em uso em outros lugares — consulte [Limitações](/docs/pt/eleven-agents/whatsapp#limitations).
* Uma forma de pagamento no [Gerenciador do WhatsApp](https://business.facebook.com/latest/whatsapp_manager/) se você pretende enviar modelos ou fazer chamadas. A Meta cobra isso separadamente da ElevenLabs.

#### Importe sua conta comercial do WhatsApp

Acesse a [página do WhatsApp](https://elevenlabs.io/app/agents/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:

![Fluxo de autorização do WhatsApp](/docs/_fern-img/9e5238e98f926582db314e9debc187a7dc29fd38a980cb732b4563b373110351.webp)

#### 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:

![Página da conta do WhatsApp](/docs/_fern-img/f5598ac70ade00048effb5ee3bf6cbc93cd61876652eb3ce5917ac21c6209bf6.webp)

Configure como o agente se comporta nesse número (consulte as [configurações da conta](/docs/pt/eleven-agents/whatsapp#account-settings) 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:

![Conversa de texto no WhatsApp](/docs/_fern-img/4c31b4d2b5eccccd7cddfa81144176a6d3c32f4670add5306f3a6ef78bc05244.webp)

A conversa aparece no seu [histórico de conversas](https://elevenlabs.io/app/agents/history) conforme acontece.

> **Info**
>
> Uma conversa por mensagem termina quando o agente usa a ferramenta de sistema ***Encerrar conversa***, a
> ***Duração máxima da conversa*** termina ou o tempo limite padrão de 15 minutos de inatividade passa
> após a resposta mais recente do agente. A próxima mensagem do usuário inicia uma nova
> conversa. Saiba mais sobre [tempos limite de conversa](/docs/pt/eleven-agents/customization/conversation-flow#maximum-conversation-duration).

#### 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](https://business.facebook.com/latest/whatsapp_manager/message_templates), por exemplo:

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

Quando o modelo for aprovado, envie-o:

#### 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"
  }'
```

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](https://elevenlabs.io/app/agents/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í.

## Se algo não funcionar

* **O agente nunca responde**: nenhum agente está atribuído ao número ou **Ativar mensagens** está desativado. Se isso parecer correto, verifique se o agente exige [variáveis dinâmicas](/docs/pt/eleven-agents/customization/personalization/dynamic-variables) — uma conversa recebida pelo WhatsApp começa sem valores fornecidos pelo usuário, então um agente cujas ferramentas ou primeira mensagem exigem um valor falha antes de responder, a menos que um webhook de início de conversa o forneça. Consulte [contexto de inicialização](/docs/pt/eleven-agents/whatsapp#initialization-context).
* **A importação falha**: o número já está registrado com outro provedor ou no app WhatsApp Business.
* **A API retornou 200, mas nenhuma mensagem chegou**: o modelo ainda não foi aprovado, os parâmetros não correspondem ao modelo ou sua conta comercial do WhatsApp tem pagamentos pendentes (erro 131042 da Meta).
* **A resposta do usuário iniciou uma conversa separada sem contexto**: o formato do ID do destinatário estava incorreto — consulte [formato do número do destinatário](/docs/pt/eleven-agents/whatsapp/outbound#recipient-number-format).

Para qualquer outra situação, consulte [Solução de problemas e FAQ](/docs/pt/eleven-agents/whatsapp/troubleshooting).

## Próximas etapas

* Personalize conversas com [variáveis dinâmicas](/docs/pt/eleven-agents/whatsapp/outbound#dynamic-variables-branches-and-environments) e as [variáveis de sistema de personalização](/docs/pt/eleven-agents/whatsapp#personalization).
* Faça campanhas em escala com [mensagens de saída e modelos](/docs/pt/eleven-agents/whatsapp/outbound).
* Deixe o agente oferecer opções selecionáveis com [mensagens interativas](/docs/pt/eleven-agents/whatsapp/interactive-messages).
* Envie mensagens do WhatsApp a partir de agentes em outros canais com [ferramentas do WhatsApp](/docs/pt/eleven-agents/whatsapp/tools).
* Entenda os custos no [FAQ de preços](/docs/pt/eleven-agents/whatsapp/troubleshooting#faq).