# API do WhatsApp Business

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

Um dos principais desafios ao criar um bot para WhatsApp é garantir que seus clientes saibam que ele existe e onde podem encontrá‑lo. Portanto, pense cuidadosamente sobre onde você deseja posicionar sua experiência conversacional no WhatsApp. 

Temos algumas sugestões para ajudá‑lo a começar:

* Comunique em seus canais de mídia social que os usuários agora podem contatá‑lo pelo WhatsApp.
* Liste o WhatsApp como uma opção na sua página de contato entre as opções de contato.
* Use seu wa.me para orientar os clientes até seu canal no WhatsApp. Ele se parece com [http://wa.me/0000000](http://wa.me/32472041640), onde os zeros representam o número de telefone vinculado. Certifique‑se de substituir essa última sequência de números pelo seu próprio número de telefone da API do WhatsApp Business. Usuários que acessarem essa página verão a seguinte mensagem:

<figure><img src="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FezqrQ9pcB4KFBxr8CjF9%2FScreenshot%202025-01-10%20at%2014.43.02.png?alt=media&#x26;token=46190bd5-3ce1-43c2-8f12-926fcf852374" alt=""><figcaption></figcaption></figure>

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

## Restrições do WhatsApp

Comparado ao widget web ou ao Facebook Messenger, o WhatsApp é mais restritivo em relação ao que você pode fazer com seu bot. Os seguintes recursos **não** são compatíveis no WhatsApp via Sinch Conversation API:

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

  <figure><img src="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FXwjnnYgwuiiS8GKw26wQ%2Fimage.png?alt=media&#x26;token=ee96521b-4592-4a0b-9203-cc912011d07c" alt=""><figcaption><p>Uma mensagem em carrossel exibida como texto simples no WhatsApp</p></figcaption></figure>

Tanto botões quanto respostas rápidas são suportados no WhatsApp, embora existam algumas restrições a serem consideradas:

* O texto em 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 qualquer uma 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="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FUnC48LtCGqHaaIwg3Zai%2Fimage.png?alt=media&#x26;token=994dc18e-dbab-489a-918f-49ee06bb2912" alt=""><figcaption><p>Menu com botões com menos de 20 caracteres</p></figcaption></figure>

<figure><img src="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FqCJPogtN3JIgHCd6C8hp%2Fimage.png?alt=media&#x26;token=14e6f155-8ffb-48c5-be46-323901fe8c7c" alt=""><figcaption><p>Menu com um botão com mais de 20 caracteres</p></figcaption></figure>