Ativar a API Oficial do Whatsapp

Com a API Oficial do WhatsApp, as mensagens automáticas da sua clínica — lembretes, confirmações de agendamento, pós-atendimento e até parabéns no aniversário — passam a ser enviadas pela integração oficial da Meta, a empresa dona do WhatsApp. É a forma mais estável de conexão: o número fica ligado diretamente à Meta, sem depender de um celular por perto nem de reconectar por QR Code de tempos em tempos.

Neste artigo você vai do zero até a primeira mensagem enviada. Pode ir com calma, passo a passo — a gente te acompanha. 💚

Importante: o custo de cada mensagem é pago direto à Meta, e não ao Gestek. Para que as mensagens sejam enviadas, a sua clínica precisa ter uma forma de pagamento cadastrada e selecionada na conta do WhatsApp Business, lá no Facebook (Meta). O Gestek não cobra, não recebe e não intermedia o pagamento das mensagens: a cobrança é feita pela Meta, diretamente na conta do WhatsApp da clínica. Sem forma de pagamento na Meta, as mensagens automáticas não são enviadas. Mais abaixo mostramos exatamente onde cadastrar.

Antes de começar

Deixe estas coisas à mão — assim a conexão acontece de uma vez só:

Módulo WhatsApp ativo no seu plano do Gestek. Se ainda não tiver, o próprio sistema oferece a contratação quando você clicar para conectar.
Uma conta do Facebook. De preferência, a de quem administra a clínica: ela fica como responsável pela conta do WhatsApp Business na Meta, e é por ela que se cadastra o pagamento.
O número de WhatsApp da clínica, e o celular onde ele está, caso use o aplicativo WhatsApp Business.
Um cartão de crédito da empresa, para cadastrar como forma de pagamento na Meta.

Para conectar e configurar o WhatsApp, o usuário precisa ter a permissão Configurações com acesso de edição, em Minha Clínica → Usuários.

API Oficial ou conexão por QR Code?

Se a sua clínica já usava o WhatsApp no Gestek antes, a conexão era feita por QR Code. As duas formas funcionam, mas são bem diferentes:

Característica	Conexão por QR Code	API Oficial
Custo das mensagens	Sem custo por mensagem enviada.	Cada mensagem tem um custo cobrado pela Meta, direto da clínica.
Como conecta	Escaneando um QR Code com o WhatsApp da clínica.	Pela conta da empresa na Meta, com uma conta do WhatsApp Business.
Mensagens	Texto livre, sem aprovação prévia.	Usa templates aprovados pela Meta antes do envio.
Estabilidade	De vez em quando é preciso reconectar escaneando o QR Code de novo e com alto risco de bloqueio e perda do número.	Integração oficial e homologada pela Meta, com conexão estável.

Contas criadas agora no Gestek já começam pela API Oficial. Se a sua clínica já usava a conexão por QR Code, ela continua funcionando normalmente — a troca só acontece se você quiser. Veja como em Trocando da conexão por QR Code para a API Oficial, mais abaixo.

Passo 1 — Conectar o WhatsApp

Clique no seu nome, no canto superior direito do sistema, e depois em Configurações. Abra a aba WhatsApp.

Na área Status do WhatsApp (API Oficial), clique em Conectar WhatsApp (API Oficial).

O Gestek pede uma confirmação, lembrando que a Meta passa a cobrar por mensagem enviada. Clique em Sim.

Abre uma janela da Meta (Login do Facebook para Empresas). Entre com a sua conta do Facebook e siga as etapas que aparecem. Na primeira tela, clique em Continuar.

Se a janela não abrir, confira se o navegador bloqueou pop-ups para o Gestek e libere-os.

As etapas na Meta

A partir daqui, as telas são todas da Meta. Elas podem variar um pouco conforme a situação da sua empresa — por exemplo, se você já tem um portfólio empresarial ou se o número já está no aplicativo WhatsApp Business. Em geral, a sequência é esta:

1. Informe o número de WhatsApp da clínica. Escolha o país e digite o número que vai enviar as mensagens.

2. Confira os dados da conta. A Meta mostra o perfil ligado a esse número. Se algo estiver errado, volte e corrija o número.

3. Escolha o portfólio empresarial. Se a sua empresa já tem um portfólio na Meta, selecione-o. Se não tiver, escolha Criar um portfólio empresarial.

4. Complete o perfil comercial. Informe o nome da empresa, o e-mail, o país e o site.

5. Importe os contatos e o histórico (se o número estiver no WhatsApp Business). Quando o número já está no aplicativo WhatsApp Business do celular, a Meta mostra um QR Code para você ler com o próprio app. Assim o número continua funcionando no celular, e os contatos e o histórico de conversas dos últimos 6 meses são trazidos para a conta.

6. Confirme a conta do WhatsApp Business. Confira o nome da conta e o fuso horário — para o horário de Brasília, (GMT-03:00) America/Sao_Paulo.

7. Autorize o Gestek. A Meta mostra o que o Gestek poderá acessar para enviar as mensagens em nome da clínica. Clique em Confirmar.

8. Pronto, conta conectada! Na última tela, aproveite e clique em Adicionar forma de pagamento — é o Passo 2, logo abaixo. Se preferir fazer depois, clique em Concluir.

De volta ao Gestek, aparece a mensagem WhatsApp conectado com sucesso!, o status muda para Conectado e o número conectado passa a aparecer na tela.

Como mostra a última tela da Meta, ela pode precisar verificar a sua empresa antes de liberar o envio de mensagens. Você recebe um e-mail da Meta quando esse processo termina. Para entender como funciona, veja o artigo da Meta Sobre a verificação da empresa no Meta Business Suite.

Passo 2 — Cadastrar a forma de pagamento na Meta

Este é o passo que mais faz diferença — e o mais fácil de esquecer. Sem uma forma de pagamento cadastrada e selecionada na conta do WhatsApp Business, a Meta não envia as mensagens automáticas.

Quem cobra, e como

A cobrança é feita pela Meta, por mensagem entregue, e o valor depende da categoria do template usado (Utilidade, Marketing ou Autenticação).
O pagamento é feito direto à Meta, pela própria conta do WhatsApp Business da clínica.
O Gestek não cobra, não recebe e não repassa nenhum valor das mensagens. O que você paga ao Gestek é o seu plano, com o módulo WhatsApp — o custo de cada mensagem é outra conta, da clínica com a Meta.

Para consultar os valores atualizados, veja a página oficial Preços da Plataforma do WhatsApp Business, escolhendo o Brasil como mercado.

Onde cadastrar

Você chega lá pelo botão Adicionar forma de pagamento, na última tela da conexão, ou a qualquer momento pelo Meta Business Suite, no menu Cobrança e pagamentos.

Em Cobrança e pagamentos, abra Formas de pagamento.
Clique na aba Contas do WhatsApp Business e selecione a conta da clínica.
Clique em Adicionar forma de pagamento e cadastre o cartão.

Não basta cadastrar o cartão no portfólio da empresa: ele precisa estar vinculado à conta do WhatsApp Business da clínica, na aba Contas do WhatsApp Business. Se essa aba mostrar Nenhuma forma de pagamento adicionada, as mensagens não serão enviadas.

O passo a passo detalhado, com todas as opções, está na Central de Ajuda da Meta:

Passo 3 — Criar os templates

Na API Oficial, toda mensagem automática sai a partir de um template: um modelo de texto que a Meta analisa e aprova antes do primeiro envio. É ele que garante que as mensagens sigam as regras do WhatsApp.

Logo depois de conectar, o Gestek abre a janela Gerenciar Templates. Você também chega nela pelo botão Gerenciar Templates, no quadro Templates da aba WhatsApp — que mostra quantos templates estão sincronizados e quando foi a última sincronização.

Criando um template

Clique em Criar Template e preencha:

Campo	O que informar
Usado para	Para qual mensagem o template vai servir: Lembrete de Agendamento, Confirmação de Agendamento, Resposta de Confirmação, Resposta de Não Confirmação, Pós Agendamento ou Aniversário. O Gestek já sugere um texto para cada um.
Nome do template	Apenas letras minúsculas, números e underline, sem espaços — por exemplo, `lembrete_agendamento`. É uma regra da Meta, e o nome não pode ser alterado depois.
Idioma	Português do Brasil.
Corpo da mensagem	O texto da mensagem, com até 1.024 caracteres. Use as tags do dicionário para os dados do agendamento.
Botões de resposta	Botões que o cliente toca para responder, com até 25 caracteres cada. Para Confirmação de Agendamento, os botões Confirmar e Cancelar são obrigatórios.

Ao lado, a Prévia no WhatsApp mostra como a mensagem vai chegar para o cliente, com dados de exemplo.

As tags disponíveis nos templates são:

Tag	O que preenche
`{{cliente}}`	Primeiro nome do cliente
`{{clinica}}`	Nome da clínica
`{{profissional}}`	Primeiro nome do profissional
`{{data_agendamento}}`	Data do agendamento, no formato dd/mm
`{{horario_agendamento}}`	Horário do agendamento, no formato hh:mm

A Meta não aceita que o texto comece com uma variável. Em vez de {{cliente}}, seu horário está confirmado, escreva Olá, {{cliente}}! Seu horário está confirmado.

Clique em Salvar. O template vai para análise da Meta com o status Em análise — a aprovação pode levar algumas horas. Quando for aprovado, o status muda para Aprovado e o template já pode ser usado nas notificações.

Categoria do template

Quem define a categoria de cada template é a própria Meta, na aprovação: Utilidade, Marketing ou Autenticação. Ela aparece na lista de templates e faz diferença no custo de cada mensagem.

Mantenha os templates de agendamento focados no atendimento — data, horário, profissional, confirmação. Textos com promoções e ofertas tendem a ser classificados pela Meta como Marketing. Para entender os critérios, veja a documentação da Meta sobre categorização de modelos.

Status dos templates

Status	O que significa
Aprovado	Liberado pela Meta. Pode ser usado nas notificações.
Em análise	A Meta ainda está revisando. Enquanto isso, a mensagem não é enviada.
Rejeitado	A Meta não aprovou o template. Crie um novo, ajustando o texto.
Pausado / Desativado	A Meta suspendeu o uso do template.
Removido	O template não existe mais na conta da Meta.

Somente templates aprovados podem ser editados. Ao editar, o template volta para análise da Meta antes de poder ser usado de novo.

Templates criados direto na Meta

Se você já tem templates criados no painel da Meta, eles aparecem na lista depois da sincronização. Como a Meta usa variáveis numeradas — {{1}}, {{2}} —, o Gestek precisa saber o que cada uma representa. O template fica sinalizado, e o botão de variáveis abre a tela Relacionar Variáveis do Template: para cada variável, escolha a tag do dicionário correspondente, na ordem em que aparecem na mensagem.

Relacionar as variáveis não muda nada na Meta — só ensina o Gestek a preencher a mensagem corretamente. Enquanto as variáveis não forem relacionadas, o template não pode ser usado nas notificações.

Sincronizar Templates

O botão Sincronizar Templates traz para o Gestek o que mudou na Meta, como novos templates, aprovações e alterações de texto. O sistema também sincroniza sozinho sempre que você abre a aba WhatsApp. Se um template for excluído na Meta, as notificações que o usavam são removidas; se o texto for alterado lá, a mensagem da notificação é atualizada, e o Gestek avisa quando for preciso relacionar as variáveis de novo.

Passo 4 — Configurar as notificações automáticas

Com os templates aprovados, é hora de dizer ao Gestek quando cada mensagem deve sair. Na aba WhatsApp, em Notificações configuradas, clique em Adicionar Notificação.

Escolha o tipo de notificação.
Para lembretes, confirmações e pós-atendimento, informe quanto tempo antes ou depois do agendamento a mensagem deve ser enviada, em minutos, horas ou dias.
Selecione o template aprovado.
Confira o resumo — por exemplo, "Esta mensagem será enviada 24 Horas Antes do Agendamento, usando o template lembrete_agendamento." — e clique em Adicionar.
Clique em Salvar, no topo da página de Configurações.

As notificações só passam a valer depois que você clica em Salvar, no topo da página de Configurações.

Tipos de notificação

Tipo	Quando é enviada	Limite
Lembrete de Agendamento	No tempo que você definir, antes do agendamento. Não espera resposta.	Até 2
Confirmação de Agendamento	No tempo que você definir, antes do agendamento. O cliente responde pelos botões Confirmar ou Cancelar.	1
Resposta de Confirmação	Logo depois que o cliente confirma.	—
Resposta de Não Confirmação	Logo depois que o cliente cancela.	—
Pós Agendamento	No tempo que você definir, depois do horário de término do agendamento.	Até 2
Aniversário	No dia do aniversário do cliente, às 9h da manhã.	1

Como funciona a confirmação

Quando o cliente toca em Confirmar, o agendamento passa automaticamente para Confirmado no Gestek. Se ele tocar em Cancelar, o agendamento é marcado como não confirmado pelo cliente, e as demais mensagens programadas para ele deixam de ser enviadas.

Com os botões, o cliente responde com um toque — sem precisar digitar "sim". Isso costuma aumentar bastante o número de confirmações.

Mensagem de aniversário

A mensagem de aniversário é exclusiva da API Oficial. Ela é enviada automaticamente no dia do aniversário de cada cliente, às 9h da manhã, para o telefone principal do cadastro — por isso, mantenha a data de nascimento e o telefone dos clientes atualizados.

Seus agendamentos já existentes

Cada agendamento guarda por qual canal o cliente vai ser avisado. Para que os agendamentos futuros que hoje estão configurados para não notificar, ou para notificar por SMS, passem a ser avisados pelo WhatsApp, use o botão Atualizar, no quadro Atualizar agendamentos para notificar via WhatsApp.

Trocando da conexão por QR Code para a API Oficial

Se a sua clínica já usava o WhatsApp pelo Gestek, aparece o campo Tipo de integração, no topo da aba WhatsApp. Nele você escolhe entre API Oficial (Meta / WhatsApp Business) e Evolution API, que é a conexão por QR Code. O botão de ajuda, ao lado, resume as diferenças entre as duas.

Ao trocar o tipo de integração, o WhatsApp da opção anterior é desconectado e as notificações automáticas configuradas são apagadas. O sistema pede confirmação antes de continuar.

Para a troca ser tranquila:

Anote as mensagens que você usa hoje, para usá-las como base dos novos templates.
Escolha um momento calmo. Os templates só podem ser criados depois da conexão pela API Oficial e, até a Meta aprová-los — o que pode levar algumas horas —, nenhuma mensagem automática é enviada.
Cadastre a forma de pagamento na Meta logo depois de conectar, como mostramos no Passo 2.

Se quiser continuar com a conexão por QR Code, veja o artigo Habilitar WhatsApp Automático por QR Code (desativado).

Minhas mensagens não estão sendo enviadas. E agora?

Confira, nesta ordem:

A forma de pagamento está cadastrada e vinculada à conta do WhatsApp Business, na Meta? Essa é a causa mais comum. Veja o Passo 2.
A Meta já concluiu a verificação da empresa? Procure o e-mail da Meta sobre a verificação.
O template está Aprovado? No cartão da notificação, um ícone de alerta aparece ao lado do status quando o template ainda não foi aprovado — enquanto isso, a mensagem não é enviada.
As variáveis do template foram relacionadas? Templates criados direto na Meta precisam desse passo.
O status da aba WhatsApp está como Conectado?
O agendamento está configurado para notificar pelo WhatsApp? Se não estiver, use o botão Atualizar.
O cliente tem um telefone principal válido no cadastro?

Desconectando o WhatsApp

Na aba WhatsApp, clique em Desconectar WhatsApp e confirme. As notificações automáticas configuradas são apagadas, e nenhuma mensagem é enviada até que você conecte novamente.

Desconectar no Gestek não exclui a sua conta do WhatsApp Business nem a forma de pagamento na Meta. Essas configurações são gerenciadas diretamente no Meta Business Suite.

Para saber mais

Artigos de ajuda da própria Meta:

Se ficou com alguma dúvida, entre em contato com nosso time de suporte através do chat online.

Atualizado em: 30/09/2026

Este artigo foi útil?

Obrigado!