# API Oficial WhatsApp

## SUPORTE API OFICIAL VIA HUB

## 💵 Valores

**Taxa de ativação do canal oficial:** R$ 180,00

* Após ativado, **não poderá ser excluído**. Caso seja cancelada, a taxa de ativação será **perdida**.
* Em caso de **banimento do número** a taxa de ativação também é **perdida** — **SIM!** a API oficial **também pode ser banida**.

{% hint style="danger" %}
**Sendo necessária contratar e ativar uma nova Chave de API.**
{% endhint %}

## ⚠️ Considerações importantes <a href="#consideracoes-importantes" id="consideracoes-importantes"></a>

* É possível conectar a API oficial e manter o aplicativo do WhatsApp no celular? (**recurso em fase Beta**).
* Após conectar com a API oficial. **Não será mais possível usar a API não oficial** (como Baileys, Wavoip ou o App executável do Windows).

{% hint style="danger" %}
Caso o cliente esteja usando uma soluções nao oficial **ele não receberá mensagens da API oficial**.
{% endhint %}

* A API oficial **não oferece suporte a grupos**. O acesso será somente pelo app ou WhatsApp Web **não será possível acessar via sistema Super Zapp**.
* O envio de templates está configurado mas **ainda não testado com QR Code**.

[Tabela oficial de preços da Meta](https://business.whatsapp.com/products/platform-pricing?lang=pt_BR\&country=Brasil\&currency=D%C3%B3lar%20\(USD\)\&category=Utilit%C3%A1rios)

* A API oficial **não exibe a foto do contato**.
* Mensagens enviadas via app ou Web **não geram custo**, mas **não aparecerão na AgoraZap**.
* Você tem **24 horas** para responder uma mensagem do cliente via AgoraZap.
* Versão QR Code é **somente receptiva**, **não envia templates** (fase Beta).
* Na versão QR Code há **falha ao receber a primeira mensagem**.

## 📤 Por onde posso enviar essas mensagens? <a href="#por-onde-posso-enviar-essas-mensagens" id="por-onde-posso-enviar-essas-mensagens"></a>

* **Bot Interno**: Totalmente personalizável.
* **Typebot**:
* Até 3 botões → serão exibidos como botões.
* Mais de 3 → serão convertidos em listas.
* A personalização é feita **somente na integração** não no fluxo.

**Via API**

* Envio de botões deve ser feito dentro da **janela de 24 horas** da Meta..
* Postman com exemplos será disponibilizado.

## 📊 Limites da API Oficial <a href="#limites-da-api-oficial" id="limites-da-api-oficial"></a>

1. Para iniciar uma conversa, é necessário usar uma **mensagem de modelo**, que precisa de aprovação da Meta.
2. Imagens PNG com fundo transparente podem apresentar **alterações**, pois o WhatsApp converte para JPEG.
3. Mensagens fora do modelo só são entregues **dentro da janela de 24 horas** desde a última mensagem do cliente.

<figure><img src="https://1366633743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgYjNDvfAgOj2CwaLjNsM%2Fuploads%2Fdj13FTCJyzeYo4KrOoRq%2Fimage.png?alt=media&#x26;token=629e3308-77f4-41fb-8f46-3653c4804791" alt=""><figcaption></figcaption></figure>

### ❌ Por que minha mensagem enviada tem um “X” vermelho? <a href="#por-que-minha-mensagem-enviada-tem-um-x-vermelho" id="por-que-minha-mensagem-enviada-tem-um-x-vermelho"></a>

[![](https://ajuda.super-zapp.com.br/~gitbook/image?url=https%3A%2F%2Fgithub.com%2Fcleitonme%2FWhazing-SaaS-Beta%2Fraw%2Fmain%2Fdocs%2FAPI%2520OFICIAL%2Fmensagemrejeitada.png\&width=300\&dpr=4\&quality=100\&sign=e0e990a3\&sv=2)](https://github.com/cleitonme/Whazing-SaaS-Beta/blob/main/docs/API%20OFICIAL/mensagemrejeitada.png)

* Isso ocorre quando: A mensagem é enviada **fora da janela de 24 horas.**
* O conteúdo está em **formato não aceito pela Meta**.

## ✉️ Envio de mensagens com API oficial via AgoraZap <a href="#envio-de-mensagens-com-api-oficial-via-super-zapp" id="envio-de-mensagens-com-api-oficial-via-super-zapp"></a>

* Funciona com envio de **mensagens e arquivos** assim como na API não oficial.
* A API **não valida** se o número possui WhatsApp, então:
* O número deve estar correto (DDD + 9º dígito, quando necessário).
* Deve respeitar a **janela de 24 horas**.
* Novo endpoint disponível para **envio de botões**.

## 🚀 Quero iniciar conversa **sem usar templates da Meta** <a href="#quero-iniciar-conversa-sem-usar-templates-da-meta" id="quero-iniciar-conversa-sem-usar-templates-da-meta"></a>

* Fiz testes com APIs não oficiais que usam Google Chrome (baseadas no **wwjs**)
* [waha](https://github.com/devlikeapro/waha): interface web, **não envia arquivos na versão gratuita** e só aceita uma conexão.
* [wwebjs-api](https://github.com/avoylenko/wwebjs-api): API REST, envia **texto e arquivos** e aceita **vários canais**.
* Por serem pesadas, **não serão integradas diretamente a AgoraZap** para evitar impacto no desempenho.
* **Modo fallback será implementado** para enviar mensagens via wwjs caso a API oficial falhe.

## 🔁 Modo Fallback para API oficial via QR Code <a href="#modo-fallback-para-api-oficial-via-qr-code" id="modo-fallback-para-api-oficial-via-qr-code"></a>

* Se uma mensagem **não for enviada pela API oficial** o sistema tentará enviar automaticamente via **wwebjs-api** (se estiver configurada).
* Um documento separado será disponibilizado explicando a configuração.

## ⏰ Suporte a Agendamento <a href="#suporte-a-agendamento" id="suporte-a-agendamento"></a>

* Mensagens agendadas **serão enviadas apenas dentro da janela de 24 horas**.
* Pode ser utilizado para forçar o contato a responder e manter a conversa ativa.
