Pular para o conteúdo

API Oficial do WhatsApp

A maior parte das clínicas conecta o WhatsApp por QR Code, um método não oficial que expõe o número ao risco de bloqueio. Existe um caminho oficial e seguro para essa conexão, e uma opção que a Auris passou a oferecer: a Coexistência, que combina a segurança da conexão oficial com a liberdade de continuar usando o WhatsApp no celular.

  • Sai do risco de bloqueio. A conexão oficial é feita pela Meta para negócios. Acaba o risco de banir o número por “uso indevido”.
  • Continua usando o celular. Com a Coexistência, você segue usando o app e o WhatsApp Web do mesmo número, junto com a Auris.
  • A janela vale só na plataforma. A regra da janela de 24 horas vale apenas para a conexão pela plataforma Auris. No aplicativo e no WhatsApp Web, não existe janela de restrição.

A conexão via QR Code funciona como o WhatsApp Web: foi feita para uso pessoal, no navegador. Quando uma ferramenta usa esse canal para automatizar o atendimento, ela na prática simula um aparelho conectado para “puxar” as mensagens, e isso fere os Termos de Uso do WhatsApp.

Foi exatamente para permitir esse uso de forma legal (automação, integração, vários atendentes) que a Meta criou a API Oficial. A regra é simples: sempre que o WhatsApp for usado por uma plataforma que não é do próprio WhatsApp, a conexão precisa ser pela API Oficial.

Conexão via QR Code

  • Feita para uso pessoal (como o WhatsApp Web)
  • Fere os Termos de Uso ao ser usada para automação
  • A Meta detecta e pode banir o número, muitas vezes de forma permanente
  • Conexão instável: a sessão cai e o QR Code vence

API Oficial do WhatsApp

  • Feita pela Meta para negócios que precisam de escala
  • Uso oficialmente permitido, sem risco de bloqueio por automação
  • Conta protegida pelas políticas oficiais
  • Conexão estável e gerenciada pela Meta

Estas regras valem para toda conexão oficial (tanto a Coexistência quanto a API pura). São definidas pela Meta, sem exceção. Entender a janela de 24 horas resolve 90% das dúvidas.

A API Oficial é o canal que a Meta criou para negócios conectarem o WhatsApp a plataformas de atendimento, de forma autorizada. É por ela que a Auris conversa com o seu número dentro das regras. Diferente do app comum, esse canal é disponibilizado com custo, cobrado pela própria Meta de quem o utiliza.

O ponto importante é o que gera cobrança: o custo existe apenas nos templates, as mensagens necessárias para abrir uma conversa parada há mais de 24 horas. Responder o paciente dentro da janela aberta por ele é sempre gratuito. Por isso, para a clínica que usa o WhatsApp de forma reativa — recebendo e respondendo pacientes — o custo é extremamente baixo.

Quando o paciente te manda uma mensagem, abre uma janela de 24 horas. Dentro dela você conversa livremente e sem custo. Cada nova mensagem do paciente renova a janela. Passadas 24h em silêncio, ela fecha, e para reiniciar o contato é preciso um template aprovado (que tem custo).

Um exemplo do dia a dia deixa isso claro. Marina é paciente da Clínica Vida (exemplo fictício) e escreve pelo WhatsApp.

Situação 1 · A paciente procura a clínica

  • Marina (paciente), seg 09h00: “Olá! Quero confirmar minha consulta de amanhã.” → A janela de 24h abre.
  • Clínica Vida: “Confirmada para amanhã às 14h com o Dr. Silva.” → Resposta livre e gratuita (dentro da janela).
  • Marina (paciente), seg 10h15: “Ótimo, obrigada!” → A janela renova (zera mais 24h).

Situação 2 · A clínica precisa lembrar a paciente

  • 24h sem mensagem da Marina: a conversa ficou parada por mais de um dia. → A janela fecha.
  • Clínica Vida (template): “Lembrete: sua consulta é hoje às 14h. Confirma sua presença?” → Única forma de reabrir: template pago.
  • Marina (paciente): “Confirmo, estarei lá!” → Nova janela abre, volta a ser grátis.

Resumindo: mensagem comum dentro de uma janela aberta é sempre gratuita, e a Meta cobra só pelos templates, conforme o tipo. O template de utilidade (confirmação, lembrete, status de exame) sai por poucos centavos, e o de marketing custa cerca de nove vezes mais.

Para quem só dispara lembrete, o custo é baixíssimo: a cada 100 lembretes de consulta, a clínica gasta cerca de R$ 4,50.

Os valores por categoria, a tabela completa de quando há cobrança e os limites de envio do número estão em Preços e limites do WhatsApp.

Sair do QR Code pode ser feito de duas formas. A diferença principal está em uma pergunta: a clínica quer continuar usando o WhatsApp no celular?

API Oficial pura

  • Conexão oficial, estável e segura
  • Zero manutenção da sua parte
  • O número sai do app: você deixa de usar o WhatsApp no celular e no Web daquele número
  • Todo o atendimento passa a ser pelo painel da Auris

Boa opção para quem já atende 100% pela plataforma e não usa o celular daquele número.

Coexistência

  • Conexão oficial, estável e segura
  • Você continua usando o app e o WhatsApp Web do mesmo número
  • As mensagens ficam espelhadas: o que você responde no celular aparece na Auris, e vice-versa
  • Seu histórico de conversas é preservado

Recomendada pela Auris para quem está no QR Code.

Coexistência: oficial no celular e na Auris ao mesmo tempo

Seção intitulada “Coexistência: oficial no celular e na Auris ao mesmo tempo”

Seu número fica conectado na API Oficial, com toda a segurança, os templates e a janela de 24h, e ao mesmo tempo continua funcionando normalmente no app do WhatsApp e no WhatsApp Web. É uma conexão híbrida: não é preciso escolher entre usar o celular ou usar a plataforma. A clínica usa os dois.

Para manter os dois lados sincronizados, o número precisa continuar instalado no app, você precisa abrir o WhatsApp de tempos em tempos e manter o aplicativo sempre atualizado no aparelho. Tecnicamente, a Auris entra como um “dispositivo conectado” do seu celular, e o WhatsApp desconecta dispositivos que ficam muito tempo sem sinal do aparelho principal ou rodando uma versão desatualizada.

No modo Coexistência, alguns recursos do app do WhatsApp deixam de funcionar naquele número. Nenhuma limitação fica escondida. Veja o que impacta a rotina:

  • Listas de transmissão deixam de funcionar (aquele envio para vários contatos de uma vez pelo app). Para disparos, o caminho passa a ser o template oficial.
  • Grupos, chamadas de voz/vídeo e status não são suportados naquele número pela conexão.
  • Editar, apagar para todos, mensagens temporárias, “ver uma vez” e localização em tempo real ficam desativados.
  • WhatsApp para Windows e smartwatch não sincronizam: mensagens enviadas por eles não chegam à Auris.

No dia a dia de atendimento da clínica (receber, responder, confirmar e lembrar pacientes), tudo continua funcionando. As limitações acima são de recursos pessoais e sociais do app, não do atendimento.

Critério QR Code (não oficial) API pura Coexistência
Dentro dos Termos de Uso Não Sim Sim
Risco de bloqueio Alto Baixo Baixo
Usa o app no celular Sim Não Sim
Usa o WhatsApp Web Sim Não Sim
Atende pelo painel da Auris Sim Sim Sim
Estabilidade Instável Alta Alta
Manutenção sua Nenhuma Nenhuma Abrir o app a cada 7 dias

Vou perder meu número de WhatsApp? Não. O número continua o mesmo em qualquer um dos caminhos oficiais. O que muda é como ele se conecta.

Com a Coexistência eu ainda uso o WhatsApp no celular? Sim, e essa é a grande vantagem. Você segue usando o app e o WhatsApp Web do mesmo número, ao mesmo tempo que a Auris atende pela plataforma. As mensagens ficam espelhadas entre os dois.

Por que preciso abrir o app a cada semana? Na Coexistência, a Auris funciona como um “dispositivo conectado” ao seu celular. O WhatsApp desconecta dispositivos quando o aparelho principal fica muito tempo sem sinal. O limite oficial é de 14 dias; a Auris recomenda abrir a cada 7 dias para nunca chegar perto disso.

Todo paciente que me manda mensagem gera cobrança? Não. Quando o paciente inicia a conversa, você responde livremente por 24 horas sem custo. A cobrança só acontece quando você envia um template fora dessa janela.

O que acontece se eu continuar no QR Code? Continua funcionando, mas o risco de bloqueio é real, crescente e pode ser permanente. Por isso a Auris recomenda migrar para a Coexistência: a clínica sai do risco sem perder o WhatsApp no celular.

Quem cuida dos custos e da aprovação dos templates? As tarifas e a aprovação de templates são da Meta. A Auris orienta a configuração, acompanha a conexão e ajuda a preparar os textos dos templates.