> For the complete documentation index, see [llms.txt](https://docs.chatlayer.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/channels/sinch-conversation-api-beta/whatsapp.md).

# WhatsApp Business API

## Informe os usuários sobre o seu bot do WhatsApp

Um dos principais desafios ao criar um bot do WhatsApp é garantir que seus clientes saibam que ele existe e onde podem encontrá-lo. Por isso, pense com cuidado sobre onde você quer posicionar sua experiência conversacional no WhatsApp.

Temos algumas sugestões para ajudar você a começar:

* Comunique, pelos seus canais de mídia social, que os usuários agora podem entrar em contato com você no WhatsApp.
* Liste o WhatsApp como uma opção na sua lista de formas de contato na sua página de contato.
* Use o seu wa.me para direcionar os clientes ao seu canal do WhatsApp. Ele se parece com [http://wa.me/0000000](http://wa.me/32472041640), em que os zeros representam o número de telefone vinculado. Certifique-se de substituir a última sequência de números pelo seu próprio número de telefone da API do WhatsApp Business. Os usuários que acessarem esta página verão a seguinte mensagem:

<figure><img src="/files/133891f963bae2858a99b8d81ae11cf00a2db506" alt=""><figcaption></figcaption></figure>

* Depois de clicar em "Mensagem", o aplicativo WhatsApp será aberto no smartphone do usuário, ou a interface web do WhatsApp será aberta no desktop, e os usuários poderão começar a enviar mensagens para a sua empresa imediatamente.
  * Você também pode incluir mensagens de texto nos seus links wa.me usando o seguinte modelo: <https://wa.me/32472041640?text=Hello%20there>. Esse texto será preenchido e ficará pronto para ser enviado pelo usuário com o clique de um botão. Certifique-se de usar a codificação correta de consulta de URL.
  * Esse link pode ser facilmente incluído em botões de site, campanhas no Facebook ou como um código QR.

## Restrições do WhatsApp

Em comparação com o widget da web ou o Facebook Messenger, o WhatsApp é mais restritivo no que você pode fazer com o seu bot. Os recursos a seguir não são **não** compatíveis no WhatsApp por meio da API de Conversação da Sinch:

* Chamadas de voz e vídeo não são compatíveis
* Indicadores de digitação e confirmações de leitura não são compatíveis
* GIFs não são compatíveis\
  (como alternativa, você pode baixar o GIF que deseja usar como .mp4 e enviá-lo para o Chatlayer como vídeo. Você pode saber mais sobre os tipos de mídia compatíveis com o WhatsApp [aqui](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media#supported-media-types))
* iFrames não são compatíveis
* Carrosséis não são compatíveis nativamente com o WhatsApp. Se você usar um, ele será exibido como uma mensagem de texto simples e não interativa. Imagens são exibidas como links.<br>

  <figure><img src="/files/634d372bf9ba6ae767f56e24800af10d3094743d" alt=""><figcaption><p>Uma mensagem de carrossel exibida como texto simples no WhatsApp</p></figcaption></figure>

Tanto botões quanto respostas rápidas são compatíveis no WhatsApp, embora haja algumas restrições a serem consideradas:

* O texto dos botões ou respostas rápidas não pode ter mais de 20 caracteres
* Botões de URL ou de chamada não podem ser usados\
  (como alternativa, você pode exibir a URL completa ou o número de telefone em uma mensagem separada do bot)
* Botões ou respostas rápidas dentro de um mesmo menu não podem ter o mesmo título duas vezes

Se você violar alguma dessas restrições, o menu de botões ou respostas rápidas será exibido como texto simples não clicável.<br>

<figure><img src="/files/09cce998f815d8ffccb229c10b61f3ada44bb008" alt=""><figcaption><p>Menu com botões com menos de 20 caracteres</p></figcaption></figure>

<figure><img src="/files/4d9fbde7201d2e8de72be905b59dc595b7acd812" alt=""><figcaption><p>Menu com um botão com mais de 20 caracteres</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.chatlayer.ai/chatlayer-documentation-pt-br/channels/sinch-conversation-api-beta/whatsapp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.