> For the complete documentation index, see [llms.txt](https://www.centralhub-ajuda.wlksistemas.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.centralhub-ajuda.wlksistemas.com.br/diretrizes-e-politicas/api-oficial-vs-api-nao-oficial.md).

# API Oficial vs API Não Oficial

A Central Hub permite conectar tanto a **API Oficial do WhatsApp (WABA)** quanto opções de **conexão não oficial** (via QR Code).

**Nossa recomendação:** recomendamos fortemente a utilização da **API Oficial (WABA)** devido à sua estabilidade, segurança e conformidade com as políticas da Meta. Ainda assim, a escolha final fica a critério da sua empresa. A definição do método de conexão determina o equilíbrio entre custos operacionais, estabilidade do serviço e os riscos assumidos em relação às diretrizes da plataforma WhatsApp.

Abaixo, detalhamos as características, requisitos e riscos de cada modalidade.

***

### 1. API Oficial (WABA — WhatsApp Business API)

A API Oficial é a infraestrutura homologada, construída e mantida pela própria Meta (WhatsApp).

#### Coexistência

A Central Hub suporta o recurso de **Coexistência**, através do método de "Dispositivos Conectados" da Meta. Isso permite que o número funcione simultaneamente no painel da Central Hub e no aplicativo WhatsApp Business no smartphone.

#### Gerenciamento, pagamentos e aprovação

* **Vínculo Comercial:** o número conectado permanece vinculado ao **Gerenciador de Negócios (Business Manager)** da sua empresa.
* **Custos:** a Central Hub não cobra taxas por mensagem. A cobrança é feita diretamente pela Meta no seu Gerenciador de Negócios, baseada em "janelas de conversa" de 24 horas (após a cota gratuita mensal).
* **Aprovação:** a utilização exige a verificação da empresa e a aprovação do número pelas políticas de comércio e mensageria da Meta. Veja o passo a passo completo na página **WhatsApp Oficial (API)**.

#### Diretrizes e risco de bloqueio

É fundamental compreender a dinâmica de bloqueios na API Oficial: o bloqueio de números não tem relação com a plataforma utilizada (Central Hub), mas sim com as regras da Meta. A API Oficial elimina o risco de banimento por "uso de software não autorizado". No entanto, **o número continua sujeito às avaliações de qualidade da Meta.** A conformidade, a ausência de spam e a qualidade do atendimento não dependem da ferramenta, mas exclusivamente do cumprimento rigoroso das políticas do WhatsApp por parte da sua empresa.

***

### 2. Conexões não oficiais

As conexões não oficiais são métodos alternativos que emulam o comportamento do WhatsApp Web ou Mobile, geralmente através da leitura de um QR Code. Elas isentam a empresa do custo por mensagem da Meta, mas envolvem mais riscos de instabilidade.

#### Riscos e responsabilidades

* **O WhatsApp não tolera SPAM:** disparos em massa ou mensagens não solicitadas via conexão não oficial têm altissima probabilidade de resultar em banimento permanente do número, sem possibilidade de recurso.
* **Aviso "Aguardando mensagem":** em conexões não oficiais, a sincronização da criptografia de ponta a ponta pode falhar se o aparelho celular principal perder a conexão com a internet. Isso gera o aviso de "Aguardando mensagem". Para o funcionamento correto, o smartphone base deve permanecer ligado, com internet estável e o aplicativo do WhatsApp ativo em segundo plano.
* A Central Hub não garante estabilidade (SLA) para conexões realizadas por vias não oficiais, já que dependem de bibliotecas de terceiros e do comportamento da plataforma WhatsApp.

***

### Perguntas frequentes

**A Central Hub cobra alguma taxa sobre as mensagens enviadas na API Oficial?** Não. O valor pago à WLK Sistemas refere-se apenas ao uso da plataforma. Todos os custos referentes ao tráfego de mensagens na API Oficial são faturados e cobrados diretamente pela Meta no cartão de crédito cadastrado no seu Gerenciador de Negócios.

**A API Oficial garante que meu número nunca será bloqueado?** Não. A API Oficial impede bloqueios por "uso de software de terceiros não autorizado". Contudo, se a operação violar as Políticas de Mensageria e Comércio do WhatsApp (ex: envio de SPAM, denúncias de usuários, quebra de regras), a Meta poderá rebaixar a qualidade e banir o número de forma administrativa.

**Se a API Oficial é mais segura, por que a opção não oficial existe?** Para oferecer flexibilidade. Empresas em fase de validação, operações com baixíssimo volume de mensagens ou que aceitam assumir os riscos técnicos e de banimento optam pela via não oficial para evitar o custo por conversa cobrado pela Meta.

**A conexão não oficial desconectou. O suporte da Central Hub pode resolver?** Desconexões em conexões não oficiais ocorrem devido a atualizações nos protocolos do WhatsApp. A resolução geralmente exige a releitura do QR Code e a garantia de que o celular hospedeiro possui conexão estável. Em casos de quebra estrutural (atualizações massivas da Meta), a WLK Sistemas acompanha as correções disponíveis, mas não atua individualmente na restauração de sessões.


---

# 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://www.centralhub-ajuda.wlksistemas.com.br/diretrizes-e-politicas/api-oficial-vs-api-nao-oficial.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.
