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

# Ferramentas do WhatsApp

## Visão geral

Você pode fornecer ao seu agente uma ferramenta para enviar mensagens pelo WhatsApp, até mesmo durante conversas em outro canal (por exemplo, telefone).

A integração do WhatsApp oferece três ferramentas:

* **Enviar mensagem** — envia uma mensagem de modelo a qualquer usuário do WhatsApp. Funciona em qualquer canal, então um agente de telefone pode, por exemplo, enviar uma confirmação para o WhatsApp de quem ligou. Esta página aborda essa ferramenta.
* **Enviar botões interativos** e **Enviar lista interativa** — oferecem opções selecionáveis ao usuário de uma conversa ativa no WhatsApp. Elas funcionam apenas em conversas por mensagem do WhatsApp — consulte [Mensagens interativas](/docs/pt/eleven-agents/whatsapp/interactive-messages).

## Configuração

#### Importe sua conta

Siga as instruções [aqui](/docs/pt/eleven-agents/whatsapp) para importar sua conta comercial do WhatsApp.

#### Adicione uma integração

Acesse a [página de integrações](https://elevenlabs.io/app/agents/integrations), clique no botão **\_Adicionar
integração \_**, selecione o WhatsApp e conecte sua conta:

![Integração do WhatsApp](/docs/_fern-img/e560b1b2a4345bd2fbe9519f7146b87d195268955d2b2aa2c6221629d97e4384.webp)

#### Adicione uma ferramenta

Acesse a [página de ferramentas](https://elevenlabs.io/app/agents/tools), clique no botão **\_Adicionar ferramenta
de integração \_**, selecione a integração do WhatsApp e a ferramenta **\_ Enviar mensagem \_**:

![Ferramenta do WhatsApp](/docs/_fern-img/e85dcc3a3e3581250604311c516e080fb7f61f100b98b4b55be5f6071866e888.webp)

## Como usar a ferramenta

#### Crie um modelo de mensagem

Acesse o [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/), abra a página
***Gerenciar modelos*** e crie um modelo de mensagem:

![Modelo de mensagem do WhatsApp](/docs/_fern-img/e2d2c8bcab0b4c664261a57658627fd4368fc00e4768e4bd4c16264c59d07e16.webp)

> **Info**
>
> No momento, a ferramenta oferece suporte apenas a parâmetros no corpo da mensagem.

#### Configure seu agente

Acesse a configuração do seu agente e adicione a ferramenta:

![Configuração do agente: ferramentas](/docs/_fern-img/0e078a4206030111493387ec6c9bc2235106ac3cb763d4555dd1ae7307c6d46a.webp)

No prompt do sistema, informe ao agente:

* quando usar a ferramenta
* qual nome de modelo e código de idioma usar
* quais parâmetros transmitir

![Configuração do agente: prompt](/docs/_fern-img/893aa34f7bd3e01a0cbb919f08f801398de318d46e1d8d1a6c72a945193f7de9.webp)

#### Teste

Teste a configuração da ferramenta:

![Conversa de teste](/docs/_fern-img/47d48232a04cd47112d5637288c6225761f7f66f3016f5fc7d9cf38a34b3782d.webp)![Mensagem de teste recebida](/docs/_fern-img/6b3809101caa5d38cf7ea761feb38f4ee316bfde4bef20e2e22eca6b14d0262f.webp)

## Parâmetros e códigos de idioma

A ferramenta preenche apenas os parâmetros do **corpo** do modelo — modelos com cabeçalhos ou botões parametrizados não são compatíveis com esta ferramenta. O destinatário é um ID de usuário do WhatsApp: somente dígitos, com o código do país e sem `+` (por exemplo, `14155552671`) — consulte as [regras de formato do número do destinatário](/docs/pt/eleven-agents/whatsapp/outbound#recipient-number-format) para observações específicas de cada país.

O código de idioma do modelo deve corresponder ao idioma com que ele foi criado no WhatsApp Manager — consulte os [códigos de idioma compatíveis](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/supported-languages/). Um erro comum é enviar `en` para um modelo criado como `en_US` (ou vice-versa); a Meta os trata como modelos diferentes.

## Solução de problemas

* **Modelo não encontrado**: o nome do modelo ou o código de idioma não corresponde exatamente ao WhatsApp Manager, ou o modelo pertence a uma conta comercial do WhatsApp diferente da conta conectada.
* **Mensagem aceita, mas não entregue**: o modelo não foi aprovado, falta um parâmetro de corpo ou a conta tem problemas de pagamento — consulte [Solução de problemas e perguntas frequentes](/docs/pt/eleven-agents/whatsapp/troubleshooting#message-accepted-but-not-delivered).
* **O agente envia parâmetros incorretos**: informe no prompt do sistema os nomes exatos dos parâmetros do modelo e os valores esperados, além de fornecer um exemplo de chamada.