LiGO

Como funciona a API oficial do WhatsApp? Passo a passo para clínicas

Por equipe LiGO · · 12 min de leitura

Resposta curta

A API oficial do WhatsApp é o caminho autorizado pela Meta para uma empresa ligar o número dela a um sistema, como um CRM. Na clínica, ela funciona assim.

  1. A clínica tem um portfólio empresarial na Meta, com uma conta do WhatsApp Business e um número verificado por SMS ou ligação.
  2. Um sistema conectado à Cloud API envia e recebe as mensagens no lugar do celular. Quase sempre essa conexão é feita por um parceiro da Meta, como um Tech Provider.
  3. Dentro da janela de 24 horas a recepção conversa livremente. Fora dela, só com template aprovado pela Meta.
  4. A Meta acompanha a qualidade das mensagens. Quem manda mensagem que o paciente não quer recebe limite menor, e pode ter o número restringido.

Entender como funciona a API oficial do WhatsApp ajuda a clínica a escolher sistema, a conversar com o fornecedor e a evitar surpresa no dia em que o número for conectado. Este guia explica cada etapa em linguagem de recepção, com exemplos de clínica médica, odontológica e de estética. A comparação com as ferramentas que conectam por QR code está em outro artigo, API oficial do WhatsApp vs. não oficial. Aqui o foco é o passo a passo.

Glossário rápido

  • API. Uma porta para um sistema conversar com outro. No WhatsApp, é o que deixa o CRM mandar e receber mensagens sem ninguém segurar o celular.
  • Cloud API. A versão da API oficial que roda nos servidores da própria Meta. A clínica não instala nada.
  • Portfólio empresarial. O cadastro da empresa na Meta (antigo Business Manager). É onde ficam a conta do WhatsApp, as páginas e os anúncios.
  • Nome de exibição. O nome que o paciente vê no perfil do número, por exemplo "Clínica Bem Estar".
  • Template. Modelo de mensagem revisado pela Meta. É o único tipo de mensagem permitido fora da janela de 24 horas.
  • Webhook. O aviso automático que a Meta manda para o sistema quando algo acontece, como "chegou mensagem nova" ou "a mensagem foi lida".
  • Tech Provider. Empresa de tecnologia verificada pela Meta para conectar clientes à API oficial.

O que é a API oficial do WhatsApp, em uma frase?

É o WhatsApp Business ligado a um sistema, com regras públicas e com a Meta sabendo quem é a empresa. O paciente continua usando o WhatsApp dele normalmente. Nada muda do lado dele. Quem muda é a clínica, que deixa de depender de um celular na recepção e passa a atender por um sistema com várias pessoas ao mesmo tempo.

Um exemplo. Numa clínica odontológica com duas recepcionistas, as duas respondem pelo mesmo número, cada uma no seu computador, e o sistema mostra quem está cuidando de cada conversa. No celular, isso não seria possível sem gambiarra.

Passo 1. Como preparar o portfólio empresarial da clínica?

Tudo começa no portfólio empresarial da Meta. Se a clínica já anuncia no Instagram ou no Facebook, é provável que ele já exista.

  1. Confira quem é administrador. O ideal é ter pelo menos duas pessoas da clínica como administradoras. Se só a agência de marketing tem acesso, peça para incluir o dono ou o gestor.
  2. Use o CNPJ e o nome certos. O nome da empresa no portfólio deve bater com o da clínica. Isso ajuda na verificação.
  3. Mantenha e-mail e telefone dos administradores em dia. A Meta avisa por e-mail quando há problema de política. Se o e-mail é de alguém que saiu da clínica, o aviso se perde.

Exemplo na clínica de estética. O perfil do Instagram foi criado por uma agência que já não atende a clínica. Antes de conectar o WhatsApp, a dona pede o acesso de administradora e remove quem não trabalha mais com ela.

Passo 2. Qual número usar e como ele é verificado?

A clínica escolhe o número que vai para a API. Pode ser um número novo ou o número que o paciente já conhece. A Meta pede a verificação do número por código enviado por SMS ou por ligação, e o registro na Cloud API usa um PIN de verificação em duas etapas, que protege a conta.

Duas decisões práticas.

Exemplo na clínica médica. O consultório usa um celular pessoal da secretária no WhatsApp Business. Na mudança, a clínica decide levar esse número para a API, porque é ele que está nos receituários e no site.

Passo 3. O que é o nome de exibição e quando ele aparece?

O nome de exibição é informado no registro do número. Ele aparece no perfil do WhatsApp da clínica. Segundo a Meta, ele também pode aparecer no topo das conversas e na lista de chats quando o número passa pela verificação de nome, que acontece automaticamente quando a conta atinge um limite de envio maior.

Use o nome real da clínica, do jeito que o paciente reconhece. "Clínica Sorriso Centro" funciona. "Promoções Sorriso" pode ser recusado e ainda confunde o paciente.

Passo 4. Quem conecta o número ao sistema?

Existem dois caminhos.

  1. A própria clínica conecta direto na Meta. Exige um desenvolvedor, um aplicativo na Meta, servidor para receber os avisos e manutenção. Faz sentido para quem tem equipe de tecnologia.
  2. Um parceiro da Meta conecta. É o caminho comum. O parceiro pode ser um Solution Partner (também chamado de BSP) ou um Tech Provider, e cada modelo tem regras diferentes de verificação e de cobrança. A diferença está explicada em o que é um Tech Provider da Meta.

No segundo caminho, a conexão costuma ser feita pelo cadastro incorporado da Meta (Embedded Signup). Na prática, é uma janela da própria Meta, aberta dentro do sistema do parceiro, em que a clínica entra com a conta do Facebook, escolhe o portfólio, informa o número e confirma o código. A clínica autoriza o parceiro a usar aquele número. Ela não entrega senha para ninguém.

Pergunte antes de contratar

  • O sistema usa a Cloud API oficial ou conecta por QR code?
  • Quem é o parceiro da Meta nessa conexão?
  • Se eu sair do sistema, o número continua sendo da clínica?
  • Quem recebe os avisos de qualidade e de política da Meta?

Passo 5. Como funciona a janela de 24 horas?

Cada vez que o paciente manda mensagem, abre uma janela de 24 horas. Dentro dela, a clínica responde com mensagem livre, do jeito que quiser. Quando a janela fecha, a clínica só pode iniciar conversa com um template aprovado.

Exemplo na clínica odontológica. A paciente pergunta às 20h de segunda se tem horário para limpeza. A clínica pode responder livremente até 20h de terça. Se ela só voltar a falar na quinta, a clínica precisa de um template para retomar o assunto.

Isso muda a rotina. Responder rápido não é só educação. É a forma de aproveitar a janela.

Passo 6. O que são templates e como são aprovados?

O template é um modelo de mensagem que a clínica cadastra e a Meta revisa. Ele pode ter partes variáveis, como o nome do paciente e o horário. A Meta classifica cada template em uma categoria.

CategoriaPara que serveExemplo na clínica
UtilidadeAlgo que o paciente pediu ou já tem, sem tom de vendaLembrete da consulta de amanhã às 14h
MarketingTudo que tenta convencer ou reengajarCampanha de avaliação de harmonização
AutenticaçãoCódigo de acessoCódigo para entrar no portal do paciente

Se o texto de um template de utilidade tiver tom promocional, a Meta pode mudar a categoria. Os detalhes estão em template de marketing vs. utilidade. A Meta cobra por mensagem conforme a categoria e a situação da conversa, e as regras mudam em 1º de outubro de 2026. Veja a nova cobrança do WhatsApp API.

Passo 7. O que são webhooks e por que a recepção deveria se importar?

O webhook é o aviso que a Meta manda para o sistema quando algo acontece. Chegou mensagem, a mensagem foi entregue, foi lida, falhou. É por ele que o CRM sabe que a paciente respondeu "confirmo" e atualiza a agenda sem ninguém digitar nada.

Para a recepção, isso aparece como coisas simples. A conversa nova surge na tela na hora. Os tiques de entregue e lido aparecem no sistema. Um aviso de falha mostra que o número do paciente está errado.

Passo 8. Existe limite de envio na API oficial?

Existe, e ele vale para mensagens fora da janela, ou seja, para templates. A Meta chama de limite de mensagens. É o número máximo de pacientes diferentes que a empresa pode alcançar fora da janela em 24 horas móveis. O limite começa baixo e sobe conforme a empresa envia mensagens de boa qualidade.

Também existe um limite para o mesmo contato. A Meta informa que o número da empresa pode enviar uma mensagem a cada 6 segundos para o mesmo usuário. Isso impede metralhar o paciente.

Exemplo na clínica de estética. A clínica quer avisar 3 mil pacientes antigos sobre um novo procedimento. Com um limite ainda baixo, o envio precisa ser dividido em vários dias. E só deve ir para quem aceitou receber mensagens.

Passo 9. Como a Meta mede a qualidade?

A Meta dá uma nota de qualidade para cada número e para cada template. Quando muitos pacientes bloqueiam, denunciam ou simplesmente não leem, a nota cai. Um template com nota baixa pode ser pausado ou desativado. Um número com muita reclamação pode ter o envio restringido. O que causa isso e como sair está em WhatsApp Business banido ou restringido.

Antes de conectar o número

  • Portfólio empresarial com pelo menos dois administradores da clínica.
  • Nome da empresa e CNPJ corretos.
  • Número escolhido e PIN guardado com a gestão.
  • Nome de exibição igual ao nome que o paciente conhece.
  • Parceiro da Meta identificado e contrato claro sobre a posse do número.
  • Lista de quem aceitou receber mensagens (opt-in).
  • Primeiros templates escritos, como lembrete de consulta e confirmação.

Erros comuns

  • Conectar o número de um celular pessoal sem avisar quem usava.
  • Deixar o portfólio só no nome da agência de marketing.
  • Mandar campanha para a base inteira no primeiro dia.
  • Usar template de utilidade para promoção.
  • Achar que a API resolve atendimento lento. Ela só abre a porta. Alguém ainda precisa responder.

Regra rápida. Responda dentro da janela, use template fora dela e só escreva para quem quer receber. O resto da API oficial é detalhe de configuração.

Como isso fica na prática (cena ilustrativa)

Terça, 23h12. Um paciente escreve para a clínica médica pedindo consulta com o clínico geral. O webhook avisa o sistema na hora. A IA da LiGO responde dentro da janela, oferece dois horários reais da agenda e reserva quando o paciente confirma o nome completo. Na quarta de manhã, a recepção abre o LiGO e vê o card em "Agendado" no Funil de Vendas, com a conversa inteira anexada. No dia anterior à consulta, sai um template de utilidade com o lembrete. Dados e horários fictícios.

Como a LiGO usa a API oficial do WhatsApp

O LiGO CRM usa a WhatsApp Cloud API oficial, e a LiGO é Tech Provider da Meta. Na implantação, a equipe da LiGO conecta o número oficial da clínica e a agenda, e valida tudo antes de começar. O número segue sendo da clínica.

Depois de conectado, o atendimento acontece em Conversas, uma caixa de entrada compartilhada com responsável e status por conversa. A IA atende dentro da janela, 24 horas ou no horário que a clínica definir, e passa para a equipe o que é clínico, reclamação ou cancelamento. Fora da janela, os Disparos de template usam modelos aprovados pela Meta, com pré-visualização, variáveis por unidade e opt-out respeitado. Veja a página sobre a IA de atendimento e como tratamos segurança e LGPD.

Falar com especialista

Se a clínica já usa o WhatsApp Business no celular, veja como migrar para a API oficial e como funciona a coexistência, que mantém o número também no celular. A LiGO oferece esse caminho.

Perguntas frequentes

Como funciona a API oficial do WhatsApp para clínicas?

A clínica liga o número dela a um sistema pela Cloud API da Meta, normalmente por um parceiro como um Tech Provider. Dentro da janela de 24 horas a equipe conversa livremente. Fora dela, só com templates aprovados pela Meta.

Preciso de um número novo para usar a API oficial?

Não necessariamente. A clínica pode usar um número novo ou levar o número que já usa, desde que consiga verificá-lo por SMS ou ligação. Com a coexistência, o número pode continuar também no app WhatsApp Business do celular.

Posso continuar usando o celular com a API oficial?

Sim, com a coexistência. O número continua no app WhatsApp Business do celular e funciona ao mesmo tempo na API oficial, com as conversas espelhadas. A LiGO oferece esse caminho. Na migração tradicional, o número sai do app e passa a ser atendido só pelo sistema.

O que acontece se o paciente não responder em 24 horas?

A janela fecha. A clínica só pode voltar a falar com ele por um template aprovado pela Meta, e o ideal é que seja um template útil, como o lembrete da consulta.

Quem é o dono do número na API oficial?

A clínica. O parceiro recebe autorização para usar o número pelo cadastro da Meta, mas o número e a conta ficam no portfólio empresarial da clínica. Deixe isso escrito no contrato.

Fontes

Consultadas em 27 de setembro de 2026.