API oficial, COEX ou QR Code: qual canal de WhatsApp usar
Compare os três jeitos de conectar o WhatsApp da clínica na Clinia, entenda o que muda em custo, risco e fluxos, e escolha o canal certo para cada número.
Os três jeitos de conectar um número
-
API oficial
O número fica direto na API do WhatsApp, homologada pela Meta. É a conexão mais estável e a indicada para volume alto e modelos de mensagem. Cada mensagem tem custo e sai do saldo do WhatsApp da clínica. -
COEX (Coexistência)
O mesmo número funciona ao mesmo tempo no WhatsApp Business App do celular e na API. A equipe continua usando o aplicativo enquanto a Clinia cuida das automações. As mensagens pela API têm custo e saem do saldo. -
QR Code
A Clinia entra no WhatsApp da clínica como um dispositivo conectado, do mesmo jeito que o WhatsApp Web. Não tem custo por mensagem e não usa o saldo, mas não é uma integração homologada e existe o risco de banimento do número.
Quando a clínica clica em Conectar ao WhatsApp, a API oficial e o QR Code aparecem lado a lado. O COEX é ativado com o time da Clinia.

Comparativo
| API oficial | COEX | QR Code | |
|---|---|---|---|
| Como funciona | Número direto na API da Meta | Número no WhatsApp Business App e na API | WhatsApp da clínica lido por QR Code |
| Custo por mensagem | Sim, sai do saldo | Sim, nas mensagens pela API | Não |
| Botões e listas nos fluxos | Sim | Sim | Sim |
| Risco | Conexão oficial | Conexão oficial | Banimento do número |
| Quando faz sentido | Volume alto e uso de modelos de mensagem | Equipe que não quer largar o app no celular | Clínica pequena que quer custo baixo |
A escolha vale para cada número, não para a clínica inteira. Em Configurações › Canais › WhatsApp, a etiqueta de cada conexão mostra o tipo e o status.
Fluxos com botões no QR Code
Os botões e as listas dos fluxos funcionam também no QR Code, tanto na conexão avulsa quanto junto com o COEX, do mesmo jeito que na API oficial. A clínica pode usar os mesmos fluxos de atendimento inicial, com botões para levar o paciente à fila certa. Veja mais sobre fluxos e gatilhos.
Depois de vincular o aparelho, mande uma mensagem de um celular de teste para o número e confira se os botões do atendimento inicial aparecem e levam para o caminho certo.
Antes de escolher o QR Code
- Banimento: o WhatsApp pode suspender o número. A clínica aceita esse risco ao criar a conexão. Leia os riscos do canal QR Code e as boas práticas para reduzi-los.
- Saldo: o saldo do WhatsApp vale só para a API oficial. No QR Code, as mensagens não têm custo por mensagem.
- Número principal: se a clínica não pode ficar sem o número, prefira a API oficial ou o COEX.
Para conectar, siga o passo a passo da conexão por QR Code. Para a API oficial, comece pela verificação do Business Manager da Meta. Para o COEX, veja o que é o WhatsApp Coexistência.
Dúvidas frequentes
Os botões dos fluxos funcionam no QR Code?
Sim. Os botões e as listas dos fluxos funcionam no QR Code, tanto na conexão avulsa quanto junto com o COEX, como na API oficial. Depois de conectar, teste o fluxo de atendimento inicial com um celular.
A clínica pode ter números em canais diferentes?
Sim. Cada número é uma conexão própria em Configurações › Canais › WhatsApp, e a etiqueta de cada uma mostra o tipo e o status. A clínica pode, por exemplo, ter o número principal na API oficial e um número de apoio por QR Code.
O saldo do WhatsApp vale para o QR Code?
Não. O saldo do WhatsApp na Clinia é usado só nas mensagens pela API oficial, inclusive no modo COEX. No QR Code as mensagens não têm custo por mensagem.