> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://ajuda.gestek.com.br/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # 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)**. ![](https://storage.crisp.chat/users/helpdesk/website/-/4/2/6/1/4261e4a3917f7800/01-configuracoes-conectar_1oq4nql.png) O Gestek pede uma confirmação, lembrando que a Meta passa a cobrar por mensagem enviada. Clique em **Sim**. ![](https://storage.crisp.chat/users/helpdesk/website/-/4/2/6/1/4261e4a3917f7800/02-confirmacao-cobranca-meta_gn4ru8.png) 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**. ![](https://storage.crisp.chat/users/helpdesk/website/-/4/2/6/1/4261e4a3917f7800/03-meta-inicio_1u2lfnh.png) | 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. ![](https://storage.crisp.chat/users/helpdesk/website/-/4/2/6/1/4261e4a3917f7800/04-meta-numero-whatsapp_xl99de.png) **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. ![](https://storage.crisp.chat/users/helpdesk/website/-/4/2/6/1/4261e4a3917f7800/05-meta-detalhes-conta_1m0zwaw.png) **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**. ![](https://storage.crisp.chat/users/helpdesk/website/-/4/2/6/1/4261e4a3917f7800/06-meta-portfolio-empresarial_q3s8tf.png) **4. Complete o perfil comercial.** Informe o nome da empresa, o e-mail, o país e o site. ![](https://storage.crisp.chat/users/helpdesk/website/-/4/2/6/1/4261e4a3917f7800/07-meta-perfil-comercial_1w4s1gr.png) **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. ![](https://storage.crisp.chat/users/helpdesk/website/-/4/2/6/1/4261e4a3917f7800/08-meta-importar-contatos-qrco_qdyxsi.png) **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**. ![](https://storage.crisp.chat/users/helpdesk/website/-/4/2/6/1/4261e4a3917f7800/09-meta-conta-whatsapp-busines_kzs1uv.png) **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**. ![](https://storage.crisp.chat/users/helpdesk/website/-/4/2/6/1/4261e4a3917f7800/10-meta-permissoes_10g3qgr.png) **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**. ![](https://storage.crisp.chat/users/helpdesk/website/-/4/2/6/1/4261e4a3917f7800/11-meta-conta-conectada_dcze42.png) 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. ![](https://storage.crisp.chat/users/helpdesk/website/-/4/2/6/1/4261e4a3917f7800/image_13frrbp.png) || 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](https://pt-br.facebook.com/business/help/1095661473946872). --- # 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](https://whatsappbusiness.com/pt-br/products/platform-pricing/), 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**. ![](https://storage.crisp.chat/users/helpdesk/website/-/4/2/6/1/4261e4a3917f7800/13-meta-cobranca-contas_aou5bs.webp) 1. Em **Cobrança e pagamentos**, abra **Formas de pagamento**. 2. Clique na aba **Contas do WhatsApp Business** e selecione a conta da clínica. 3. Clique em **Adicionar forma de pagamento** e cadastre o cartão. ![](https://storage.crisp.chat/users/helpdesk/website/-/4/2/6/1/4261e4a3917f7800/14-meta-formas-pagamento-whats_6qhmgc.webp) ||| 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: * [Como adicionar um cartão de crédito à sua conta da Plataforma do WhatsApp Business](https://pt-br.facebook.com/business/help/488291839463771) * [Adicionar um cartão de crédito existente à sua conta do WhatsApp Business](https://pt-br.facebook.com/business/help/3146639885655187) --- # 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. ![](https://storage.crisp.chat/users/helpdesk/website/-/4/2/6/1/4261e4a3917f7800/12-gerenciar-templates-vazio_1866f8p.png) ## 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. ![](https://storage.crisp.chat/users/helpdesk/website/-/4/2/6/1/4261e4a3917f7800/image_hwjfmb.png) 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. ![](https://storage.crisp.chat/users/helpdesk/website/-/4/2/6/1/4261e4a3917f7800/image_xae8kg.png) ## 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](https://developers.facebook.com/docs/whatsapp/updates-to-pricing/new-template-guidelines?locale=pt_BR). ## 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**. ![](https://storage.crisp.chat/users/helpdesk/website/-/4/2/6/1/4261e4a3917f7800/image_zzfrs8.png) 1. Escolha o **tipo** de notificação. 2. 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. 3. Selecione o **template** aprovado. 4. Confira o resumo — por exemplo, *"Esta mensagem será enviada 24 Horas Antes do Agendamento, usando o template lembrete_agendamento."* — e clique em **Adicionar**. 5. 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)](https://ajuda.gestek.com.br/pt-br/article/habilitar-whatsapp-automatico-n2hzzs/). --- # Minhas mensagens não estão sendo enviadas. E agora? Confira, nesta ordem: 1. **A forma de pagamento está cadastrada e vinculada à conta do WhatsApp Business, na Meta?** Essa é a causa mais comum. Veja o Passo 2. 2. **A Meta já concluiu a verificação da empresa?** Procure o e-mail da Meta sobre a verificação. 3. **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. 4. **As variáveis do template foram relacionadas?** Templates criados direto na Meta precisam desse passo. 5. **O status da aba WhatsApp está como Conectado?** 6. **O agendamento está configurado para notificar pelo WhatsApp?** Se não estiver, use o botão **Atualizar**. 7. **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: * [Como adicionar um cartão de crédito à sua conta da Plataforma do WhatsApp Business](https://pt-br.facebook.com/business/help/488291839463771) * [Adicionar um cartão de crédito existente à sua conta do WhatsApp Business](https://pt-br.facebook.com/business/help/3146639885655187) * [Preços da Plataforma do WhatsApp Business](https://whatsappbusiness.com/pt-br/products/platform-pricing/) * [Sobre a verificação da empresa no Meta Business Suite](https://pt-br.facebook.com/business/help/1095661473946872) * [Categorização de modelos](https://developers.facebook.com/docs/whatsapp/updates-to-pricing/new-template-guidelines?locale=pt_BR) --- Se ficou com alguma dúvida, entre em contato com nosso time de suporte através do **chat online**.