Conectar o WhatsApp oficial é copiar quatro chaves. O difícil é saber onde a Meta guarda cada uma

por Dr. Filipe Flausino, fisioterapeuta · setembro de 2026 · 20 min de leitura · artigo 3 da série do WhatsApp oficial · tutorial passo a passo

Este é o terceiro artigo da série. O primeiro explicou o que muda quando a clínica passa para a via oficial — a janela de 24 horas, o fim do risco de banimento, o custo por modelo. O segundo decidiu qual número usar. Agora é mão na massa: este é o tutorial de conexão, do começo ao fim, no modo manual — você mesmo cria tudo, dentro da sua conta, e sai com o canal funcionando e com a propriedade de cada peça.

A boa notícia primeiro: a conexão inteira se resume a copiar quatro informações de dois painéis da Meta, colar no fulcro e apontar um endereço de volta. Nada aqui exige saber programar. O que exige é paciência: os painéis da Meta foram desenhados para desenvolvedores, os nomes são em parte em inglês, e a informação que você precisa está espalhada em telas que não conversam entre si. Este tutorial existe para você não precisar entender nada além do que está escrito nele.

Ele é longo de propósito: preferimos que você leia dez minutos a mais do que descubra em trinta dias que faltou um passo. Não pule nenhuma parte — em especial a Parte 3, que é onde mora a pegadinha que derruba a maioria das conexões feitas por conta própria.

Um aviso que vale para o tutorial inteiro: a Meta muda os menus de tempos em tempos. Se algum nome de botão estiver diferente do que descrevemos, a função continua existindo — procure pelo termo que indicamos em cada passo, que ela aparece.

Antes de começar: três coisas sem as quais não adianta seguir

Estas três não são burocracia nossa — são exigências da Meta, e duas delas levam dias para resolver se ainda não estiverem prontas. Confira antes de abrir qualquer painel:

• O Gerenciador de Negócios (Business Manager) da clínica existe, de preferência com a empresa verificada ou com a verificação em andamento. Ela não é obrigatória para conectar, mas sem ela a Meta limita quantas conversas novas a clínica pode abrir por dia, e a análise leva dias: se ainda não começou, comece pelo tutorial de verificação da empresa e siga este em paralelo
• O número está decidido — o artigo 2 da série trata exatamente dessa escolha. Lembre do fato central: o número que entra na API oficial sai do aplicativo WhatsApp do celular; não dá para usar o mesmo número nos dois ao mesmo tempo
• Há um cartão cadastrado na conta da Meta — é ele que paga as mensagens de modelo enviadas fora da janela de 24 horas. Fica no Gerenciador de Negócios, na área de pagamentos (a Meta muda os menus de tempos em tempos; se não achar, procure por "Pagamentos" ou "Billing" nas Configurações do negócio)
• O fulcro aberto numa aba, em Configuração → Canais

O mapa das quatro chaves

Antes de entrar nos painéis, veja o conjunto. É esta tabela que o tutorial inteiro preenche — se em algum momento você se perder, volte aqui:

Repare que são dois painéis diferentes: o de desenvolvedor (developers.facebook.com), onde vivem o app, os IDs e o segredo; e o Gerenciador de Negócios (business.facebook.com), onde vive o token. É essa separação que confunde todo mundo — e é só isso que ela é: duas telas, não duas contas.

Tudo que conversa com a API do WhatsApp precisa passar por um "app" — um registro que diz à Meta quem está pedindo o quê, em nome de qual empresa. Ninguém vai baixar nem abrir esse app: ele existe só como ponto de conexão. Você cria uma vez e nunca mais mexe.

Com o produto WhatsApp adicionado, o app ganha um painel próprio do WhatsApp. É nele que estão os dois identificadores que o fulcro pede. Um detalhe que evita confusão: o "ID do número" não é o número de telefone. É um código comprido, só de dígitos, que a Meta atribui ao número — o telefone que você conhece aparece por perto, mas o que o fulcro precisa é do código.

O token é a chave que autoriza o fulcro a agir em nome da clínica: enviar mensagem, criar modelo, perguntar o estado do número. E aqui mora a armadilha que precisamos desarmar antes de qualquer clique:

O que é um "usuário do sistema"? Pense num funcionário que não existe: uma conta técnica, que não é de ninguém, não tem celular, não troca de senha e não sai da empresa. É exatamente por isso que o token gerado por ela é permanente — ele não morre quando alguém da equipe muda a senha, perde o acesso ou vai embora. Token gerado por pessoa de verdade morre junto com o vínculo dela; token de usuário do sistema fica.

O segredo do app tem um papel diferente do token. O token autoriza o fulcro a falar com a Meta; o segredo serve para o fulcro conferir a assinatura de tudo que a Meta manda para ele. Sem essa conferência, qualquer um que descobrisse o endereço do webhook poderia se passar pela Meta e injetar mensagens falsas. Com ela, aviso sem assinatura válida vai para o lixo.

O webhook é o interfone do sistema: o endereço que a Meta usa para tocar a campainha do fulcro toda vez que uma mensagem chega no seu número. As quatro chaves da Parte 5 resolveram a saída (o fulcro falando com a Meta); o webhook resolve a entrada (a Meta avisando o fulcro). Um canal sem webhook manda mensagem normalmente e nunca fica sabendo das respostas — parece funcionar e é surdo.

E o primeiro teste bem-sucedido dispara uma coisa a mais, sozinho: o fulcro cria e envia para análise da Meta seis modelos de mensagem padrão — lembrete_consulta, lembrete_com_motivo, confirmacao_consulta, confirmacao_com_motivo, retomada_contato e pos_consulta. Os dois "com motivo" relembram o problema que a pessoa contou. São eles que permitem às rotinas automáticas (lembrete, confirmação, retomada, pós) alcançarem o paciente fora da janela de 24 horas, quando só mensagem de modelo aprovado pode sair. Você não precisa fazer nada: o veredito da Meta chega sozinho pelo webhook que você acabou de configurar, e o status de cada modelo aparece na seção Modelos de mensagem do mesmo cartão — Rascunho, Em análise na Meta, Aprovado ✓, Rejeitado (com o motivo) ou Pausado. Ninguém precisa abrir o Gerenciador da Meta para acompanhar.

O teste da Parte 7 provou a saída: o fulcro fala com a Meta. Falta provar a entrada — o caminho que depende do webhook — e nada prova a entrada como uma mensagem de verdade. É o mesmo princípio que usamos em todos os nossos tutoriais: a prova honesta é a que percorre o caminho real, não a luz verde do painel.

O que muda no dia a dia, agora que está conectado

Conectar foi a parte que exigia tutorial. O uso diário foi desenhado para não exigir: as regras da Meta são aplicadas pelas telas do fulcro, e o que você precisa é só entender o comportamento que vai ver.

A janela de 24 horas manda em tudo. Cada mensagem do paciente renova a janela. Dentro dela, conversa livre — texto normal, sem custo por mensagem, na categoria de serviço. Fora dela, só sai modelo aprovado, pago por mensagem. Você não precisa decorar isso: quando a janela de uma conversa fecha, o compositor do Atendimento troca a caixa de texto por um aviso e pelo botão Enviar modelo aprovado, que abre a lista de modelos e pede o valor de cada variável. A tela não deixa errar.

As rotinas automáticas seguem a mesma regra sozinhas. Lembrete de consulta, confirmação, follow-up e pós-consulta mandam texto normal quando a janela está aberta e usam os modelos aprovados quando está fechada. E se um toque precisar sair fora da janela sem que exista modelo aprovado para ele, o toque não sai — e o motivo fica registrado na conversa, para ninguém achar que o sistema falhou calado.

Uma escolha que deixamos com você: o follow-up do segundo dia em diante pela via oficial vem desligado de fábrica. Cada retomada fora da janela é um modelo pago, e insistência demais pesa no quality rating — a nota que a Meta dá ao seu número. A clínica liga quando quiser, sabendo do custo; preferimos isso a você descobrir a cobrança na fatura.

Campanhas em massa continuam saindo pela via não oficial. Marketing em massa pela oficial exigiria um modelo pago por disparo — não faz sentido para esse uso. É mais um motivo para os dois canais conviverem: cada mensagem pelo canal que lhe cabe.

E o vigia trabalha por você. Modelo rejeitado, mensagem barrada pela janela, token que parou de funcionar: o aviso chega por push no celular e no painel da aba Canais. Você não precisa vigiar o painel — o painel vigia por você.

Quanto custa — a lógica, não a tabela

Não vamos escrever valores aqui, porque a Meta os revisa de tempos em tempos e um número neste artigo estaria errado em breve. A tabela oficial, sempre atual, está em business.whatsapp.com/products/platform-pricing. O que não muda é a lógica, e ela cabe em quatro linhas:

• Conversa que o paciente inicia, respondida dentro da janela de 24 horas: categoria de serviço, sem custo por mensagem. No dia a dia de uma clínica — pergunta, agendamento, dúvida — é a maior parte do movimento.
• Mensagem sua fora da janela: só por modelo aprovado, paga por mensagem, com preço diferente por categoria (Utilidade ou Marketing).
• Conversa iniciada por anúncio de clique-para-WhatsApp: tem 72 horas gratuitas — e traz de brinde o identificador do anúncio de forma estrutural, o que fecha o rastreio de conversão nativamente. É a via oficial devolvendo em medição o que cobra em mensagem; o tutorial de rastreio mostra o circuito completo.
• A cobrança é entre você e a Meta: cai no cartão cadastrado no Gerenciador de Negócios da clínica. O fulcro não fica no meio do dinheiro da Meta — nem vê a sua fatura.

E vale repetir a troca que o artigo 1 detalhou: a via oficial é a API da própria Meta — sem risco de banimento do número. A via não oficial segue grátis por mensagem e sem janela, com o risco assumido por termo. Não é uma contra a outra: é cada conversa no canal certo.

Problemas comuns, e o que fazer

Sua lista final de conferência

Toque em cada item para marcar. As marcações ficam guardadas neste navegador, então dá para fazer o tutorial em duas sentadas sem perder o fio.

• Empresa verificada no Gerenciador de Negócios
• Cartão cadastrado na conta da Meta para o billing
• App criado no developers.facebook.com, do tipo Empresa, vinculado ao Gerenciador da clínica
• Produto WhatsApp adicionado ao app, apontando para o número decidido
• phone_number_id e waba_id anotados, cada um com o rótulo certo
• Usuário do sistema "fulcro" criado como administrador, com o app atribuído em controle total
• Token permanente gerado com whatsapp_business_messaging e whatsapp_business_management — e não o token de teste de 24h
• Chave Secreta do Aplicativo copiada
• As quatro chaves coladas no fulcro e Conectar canal oficial salvo
• Webhook verificado e salvo no app da Meta, com o campo messages assinado
• Testar conexão trouxe o meu número e o nome verificado
• Os 6 modelos padrão aparecem na seção Modelos de mensagem (Em análise ou Aprovado ✓)
• Mensagem de teste de outro celular chegou no Atendimento com a pílula ☁️ Oficial
• Respondi de dentro do fulcro e a resposta chegou no celular

Marcou tudo? Então o canal oficial da sua clínica está no ar, provado nas duas direções, com os modelos a caminho da aprovação e o vigia de plantão. O próximo passo natural da série é o artigo 4 — escrever modelos que a Meta aprova: é neles que a via oficial mostra a que veio.