# Como funciona a API oficial do WhatsApp? Passo a passo para clínicas :::resumo 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](/blog/api-oficial-whatsapp-vs-api-nao-oficial.html). Aqui o foco é o passo a passo. :::glossario - **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. - **Número conhecido ou número novo?** O número que está na fachada, no Google e no Instagram é o que o paciente procura. Quando dá para usar esse, o paciente não precisa aprender outro contato. - **Quem guarda o PIN?** Anote em lugar seguro, com acesso de mais de uma pessoa da gestão. Perder o PIN atrasa qualquer troca de sistema. 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](/blog/tech-provider-meta-o-que-e.html). 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. :::atencao 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. | Categoria | Para que serve | Exemplo na clínica | |---|---|---| | Utilidade | Algo que o paciente pediu ou já tem, sem tom de venda | Lembrete da consulta de amanhã às 14h | | Marketing | Tudo que tenta convencer ou reengajar | Campanha de avaliação de harmonização | | Autenticação | Código de acesso | Có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](/blog/template-marketing-vs-utilidade-whatsapp.html). 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](/blog/nova-cobranca-whatsapp-api-outubro-2026.html). ## 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](/blog/whatsapp-business-banido-clinica.html). :::checklist 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. ::: :::atencao 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. :::exemplo 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](/ia-de-atendimento-para-clinicas.html) e como tratamos [segurança e LGPD](/lgpd-crm-odontologico.html). [Falar com especialista](https://wa.me/554931983115?text=Ol%C3%A1%21%20Quero%20falar%20com%20um%20especialista%20da%20LiGO.) Se a clínica já usa o WhatsApp Business no celular, veja [como migrar para a API oficial](/blog/migrar-whatsapp-business-para-api-oficial.html) 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. - Meta for Developers, [WhatsApp Cloud API Get Started](https://developers.facebook.com/documentation/business-messaging/whatsapp/get-started). - Meta for Developers, [Register a business phone number](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/registration) (verificação do número e PIN de duas etapas). - Meta for Developers, [Business phone numbers](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers). - Meta for Developers, [Display names](https://developers.facebook.com/documentation/business-messaging/whatsapp/display-names). - Meta for Developers, [Service messages and customer service windows](https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/send-messages) (janela de 24 horas). - Meta for Developers, [Template categorization](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-categorization). - Meta for Developers, [Messaging limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits). - Meta for Developers, [About the WhatsApp Business Platform](https://developers.facebook.com/documentation/business-messaging/whatsapp/about-the-platform) (qualidade e limite por contato). - Meta for Developers, [Template quality rating](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-quality). - Meta for Developers, [Solution providers overview](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/overview).