Lembrete de vacina no WhatsApp: como automatizar sem bloquear a conta da clínica

Clínica veterinária que tenta automatizar o lembrete de vacina ou de retorno pelo WhatsApp esbarra cedo ou tarde na mesma trava: a mensagem simplesmente não chega, ou o número da clínica recebe um aviso de restrição. Isso não é falha de sistema. É a regra da plataforma de negócios do WhatsApp, descrita na documentação oficial da Meta para desenvolvedores, atualizada em 21 de maio de 2026.

O problema não é a IA. É o canal. Entender como o WhatsApp Business trata mensagem automática evita que a clínica perca o número, a reputação com os tutores e o acesso ao próprio canal de atendimento.

O que é a janela de atendimento e por que ela trava o lembrete

Toda conversa no WhatsApp Business abre uma janela de atendimento quando o tutor manda uma mensagem para a clínica. Dentro dela, a clínica responde livremente, com texto solto, sem aprovação prévia de ninguém. O problema é o que acontece depois que essa janela fecha.

Segundo a documentação da Meta, mensagens de modelo (template messages) são "o único tipo de mensagem que pode ser enviado a usuários do WhatsApp fora de uma janela de atendimento ao cliente". Na prática: se a janela de atendimento com o tutor já estiver fechada, a única forma de avisar que a vacina da Luna vence sexta-feira é com um modelo pré-aprovado pela Meta. Texto livre gerado na hora, mesmo que a IA escreva bonito, não passa.

É exatamente aí que a maioria das clínicas pequenas tropeça: monta um fluxo de IA que escreve a mensagem do zero para cada pet, tenta disparar fora da janela e o WhatsApp rejeita o envio ou, pior, penaliza o número por tentativa de burlar a regra.

O modelo de mensagem precisa existir antes, e precisa ser aprovado

Um modelo (template) é criado antes de qualquer envio, pela API de modelos de mensagem ou pelo painel do WhatsApp Manager. Ele passa por revisão automática da Meta, que pode levar até 24 horas, e só pode ser disparado depois de receber o status APPROVED.

O nome do modelo usa letras minúsculas, números e underline, com até 512 caracteres: algo como lembrete_vacina_pet. Cada modelo tem um idioma fixo (a Meta não traduz o texto) e uma categoria obrigatória: authentication, marketing ou utility.

Um lembrete de vacina de um paciente que já é cliente da clínica se enquadra em utility. Classificar como marketing por engano, mesmo sem intenção, pode alterar o que é cobrado pelo envio (as categorias entram no cálculo de pricing da Meta) e sujeita a mensagem ao limite de modelos de marketing por usuário que a plataforma aplica.

Como fica o texto do modelo na prática

O corpo do modelo tem variáveis que são preenchidas na hora do envio, não antes. A documentação da Meta mostra dois formatos possíveis: nomeado ou posicional. Para uma clínica veterinária, um modelo de lembrete de vacina com parâmetro posicional ficaria assim:

"name": "lembrete_vacina_pet",
"category": "utility",
"language": "pt_BR",
"components": [{
 "type": "body",
 "text": "Olá {{1}}, a vacina {{2}} do(a) {{3}} está prevista para {{4}}. Responda esta mensagem para agendar.",
 "example": {
 "body_text": [["Marina", "V10", "Thor", "30/10"]]
 }
}]

Esse texto, uma vez aprovado, fica congelado. A clínica não reescreve a frase a cada disparo: ela só troca os valores das variáveis {{1}} a {{4}} para cada tutor e cada pet. Qualquer mudança no texto em si exige um novo modelo, submetido a nova revisão.

Onde a IA entra de verdade

O papel certo da IA aqui não é compor a mensagem na hora do envio, isso é papel do modelo aprovado. O papel da IA é organizar os dados que alimentam as variáveis: cruzar a ficha de vacinação de cada pet com a data de hoje, separar quem vence vacina nos próximos sete dias, puxar o nome do tutor e do pet do prontuário e montar a lista de envios.

Em termos práticos, isso significa um fluxo com duas peças separadas:

1. Um modelo utility aprovado pela Meta, com o texto fixo e as variáveis.
2. Uma rotina (que pode ser orquestrada por IA) que lê o sistema de gestão da clínica, identifica quais pets precisam de lembrete e envia o disparo preenchendo só os parâmetros.

Quem tenta pedir para a IA "escrever uma mensagem diferente para cada tutor" e mandar isso como texto livre fora da janela de atendimento está, na prática, tentando enviar algo que o WhatsApp vai recusar por não ser um modelo aprovado.

Status do modelo: de aprovado a pausado sem aviso prévio

Um modelo aprovado não fica aprovado para sempre. A Meta aplica uma nota de qualidade (quality rating) baseada em como os tutores reagem: quem bloqueia, denuncia como spam ou nem abre a mensagem derruba a nota do modelo.

Os status possíveis, segundo a documentação, vão de Active - High Quality até Paused e Disabled. Um modelo pausado ou desabilitado não pode mais ser enviado, mesmo que já tenha sido usado centenas de vezes antes. Modelos sem uso por 12 meses seguidos entram em arquivamento automático e são apagados 28 dias depois, a menos que a clínica os reative.

Para a clínica pequena, a lição prática é: não dispare lembrete de vacina com frequência maior do que o tutor espera, e não reaproveite o mesmo modelo para assunto diferente só para economizar aprovação. Isso derruba a nota de qualidade e pode travar o canal inteiro, não só aquele modelo.

O que pode e o que não pode entrar na variável do lembrete

As variáveis do modelo aparecem na tela de notificação do celular do tutor, muitas vezes antes mesmo de ele abrir o WhatsApp. Isso muda o que é seguro colocar ali.

Nome do pet, tipo de vacina (V10, antirrábica, V8) e data prevista são informações de baixo risco e cabem no texto do modelo. Resultado de exame, diagnóstico, valor de internação ou qualquer dado clínico mais sensível do atendimento não deve ir para uma variável de template, porque fica exposto na tela de bloqueio do celular do tutor e sai do controle da clínica quanto a quem mais vê aquele aparelho.

O telefone e o nome do tutor usados para o disparo são dados pessoais protegidos pela Lei Geral de Proteção de Dados (Lei 13.709/2018, sancionada em 14 de agosto de 2018). A clínica precisa ter a base legal para usar esse contato (em geral, o próprio cadastro feito no atendimento) e não pode repassar essa lista de telefones a terceiros, nem usá-la para outra finalidade sem avisar o tutor.

Quando não vale a pena automatizar

Clínica com poucos pacientes e agenda que muda toda semana ganha pouco montando um pipeline de modelos aprovados: o retorno manual, feito por quem já atende no balcão, resolve com menos esforço de configuração. O investimento em modelo aprovado e rotina automatizada compensa quando o volume de pets com vacina vencendo por mês já é grande o suficiente para que um lembrete manual comece a escapar da agenda, e quando a clínica aceita o tempo de até 24 horas de revisão da Meta antes de cada modelo novo entrar no ar.

Fonte 1: Documentação do WhatsApp Business Platform (Meta) — Modelos de mensagem (https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates)

Template fundamentals | Meta for Developers

WhatsApp Business Platform Template fundamentals Updated : May 21, 2026 Copy for LLM View as Markdown This document covers template mechanics that apply across all template categories. For category-specific template guides, see Marketing messages , Utility messages , and Authentication messages . Templates are Messaging account assets that can be sent in template messages via Cloud API or Marketing Messages API for WhatsApp. Template messages are the only type of message that can be sent to WhatsApp users outside of a customer service window .

Templates are commonly used when messaging users in bulk or when no customer service window is open between you and the user. Creation Use the Message Templates API or message templates panel ⁠ in WhatsApp Manager to create a template. Template creation via API uses a common syntax. The bulk of the variation occurs in the category string, which assigns a category to the template, and the components array, which defines the components that make up the template. You can create a maximum of 100 templates in a Messaging account per hour. Common syntax

curl 'https://graph.facebook.com/v23.0/102290129340398/message_templates' \ -H 'Authorization: Bearer EAAJB...' \ -H 'Content-Type: application/json' \ -d ' { "name": "", "category": "", "language": "", "parameter_format": "", "components": [] }'

Names Every template must have a name, but names are not unique. This flexibility allows you to create multiple templates with the same name, but in different languages. Template names are limited to a maximum of 512 characters, consisting of lowercase alphanumeric characters and underscores. Categories Each template must be categorized as authentication , marketing , or utility .

The template categorization guide describes how to assign the proper category to a template, and what can happen if a template has been miscategorized. Note that template categories also factor into pricing . Components Templates are made up of various text, media, and interactive UI components, which you define upon template creation. The template components guide describes all possible components and how to define them. Since there are a lot of components to choose from, see the Authentication messages , Marketing messages , and Utility messages sections for category-specific template guides with code examples showing how to create various templates with commonly used components.

Languages You must assign a template language code upon template creation. Template strings and variables are not translated by Meta, so you are responsible for supplying strings and example parameters in their appropriate language. If you create multiple templates with the same name but with different languages, each template counts against your template limit . Parameter formats Some template components allow you to define strings that contain one or more parameters (described as "variables" in WhatsApp Manager). These are replaced with values included by you in your send message payload when you send the template.

Upon template creation, if a string includes one or more parameters, you can specify their format, either named or positional, and you must include an example value for each parameter. If you do not specify a format, the template uses positional format by default. Named parameters Parameters using the named format must be unique, single strings, composed of lowercase characters and underscores, wrapped in double curly brackets, for example, {{first_name}} . Example values in template creation payloads and real values in template send payloads can appear in any order. Example template creation payload with named parameters:

"name": "order_confirmation", "language": "en_US", "category": "utility", "parameter_format": "named", "components": [ "type": "body", "text": "Thank you, {{first_name}}! Your order number is {{order_number}}.", "example": { "body_text_named_params": [ "param_name": "first_name", "example": "Pablo" }, "param_name": "order_number", "example": "860198-230332" } ] } Example template send payload of template that uses named parameters:

"messaging_product": "whatsapp", "recipient_type": "individual", "to": "+16505551234", "type": "template", "template": { "language": { "code": "en_US" "parameters": [ "type": "text", "parameter_name": "first_name", "text": "Jessica" "parameter_name": "order_number", "text": "SKBUP2-4CPIG9" Positional parameters Positional parameters must be ordered array index numbers, starting from 1, wrapped in double curly brackets: ( {{1}} ... {{2}} ...and so on). Example values in template creation payloads and real values in template send payloads must appear in the order in which their corresponding placeholders appear in the component text string. Example template creation payload with positional parameter:

"parameter_format": "positional", "text": "Hi {{1}}! Your order number is {{2}}. Thank you.", "body_text": [ [ "Pablo", "860198-230332" } Example template send payload of template that uses positional parameter:

Media Template header components can display media assets. If you are creating a template with a media header, you must use the Resumable Upload API to obtain an asset handle, and include this asset handle in your template creation request. The example asset will be reviewed as part of template review . Template review Templates are automatically reviewed upon creation or after editing. If your template is approved, its status is set to APPROVED and you can begin sending it in template messages. If it is rejected, or if its status changes to any other value, it cannot be sent in template messages.

See Template review to learn more about the review process, common rejection reasons, and what you can do if your template is rejected. Template status Templates must have a status of APPROVED before they can be sent in template messages. A template's status is initially set by the template review process, but can be changed to another value based on usage and quality feedback . Template status changes are communicated via message_template_status_update webhooks, but you can use the Template API and request the status field to get the status of a template at any time. Example request

curl 'https://graph.facebook.com//?fields=status' \ -H 'Authorization: Bearer '

Example response

"status": "APPROVED", "id": "1259544702043867" } See the Template API reference for a list of all possible status values and what they mean. WhatsApp Manager The Manage templates ⁠ panel in WhatsApp Manager also displays template statuses, and appends quality ratings for approved ( active ) templates: In-Review : Indicates that the template is still under review. Review can take up to 24 hours. Rejected : The template has been rejected during the review process or violates one or more policies.

Active - Quality pending : The message template has yet to receive quality feedback or read-rate information from customers. Message templates with this status can be sent to customers. Active - High Quality : The template has received little to no negative customer feedback. Message templates with this status can be sent to customers. Active - Medium Quality : The template has received negative feedback from multiple customers, or low read-rates, but might soon become paused or disabled. Message templates with this status can be sent to customers.

Active - Low Quality : The template has received negative feedback from multiple customers, or low read-rates. Message templates with this status can be sent to customers but are in danger of being paused or disabled soon, so address the issues that customers are reporting. Paused : The template has been paused due to recurring negative feedback from customers, or low read-rates. Message templates with this status cannot be sent to customers. See Template Pausing . Disabled : The template has been disabled due to recurring negative feedback from customers.

Message templates with this status cannot be sent to customers. Appeal Requested : Indicates that an appeal has been requested. Template limits The number of templates a Messaging account can have is determined by its parent business portfolio. If a parent business portfolio is unverified, each of its Messaging accounts is limited to 250 message templates. However, if the portfolio is verified ⁠ , and at least one of its WhatsApp accounts has a business phone number with an approved display name , each of its Messaging accounts can have up to 6,000 templates.

Additionally, there are limits on the number of templates you can send, as well as processes that can affect template delivery: Messaging limits — A limit on the number of message templates you can send outside of customer service windows. Template pacing — A process that allows time for WhatsApp users to provide feedback on message templates. Template pausing — A process that can temporarily pause message templates that have received poor feedback. Template archival — A process that automatically archives and deletes templates that have been inactive for 12 months or more. Archived templates are deleted after 28 days unless unarchived.

Per-user marketing template message limits — A process that limits the number of marketing message templates a given WhatsApp user may receive from any business. Time-to-live If a message sent to a WhatsApp user cannot be delivered, the system will continue attempting delivery for a period known as the time-to-live (TTL). You can customize the TTL for templates upon template creation. See Time-to-live for more information. Quality rating Template quality rating is a system used to evaluate the quality of message templates, based on usage, customer feedback, and engagement. This rating helps maintain a high-quality messaging ecosystem and helps ensure that you are sending relevant and well-received messages.

See Template quality rating for more information about quality ratings, how they can affect a template's status, and how you can be notified of changes to template quality scores. Delivery sequence of multiple messages When sending a series of messages, the order in which messages are delivered is not guaranteed to match the order of your API requests. If you need to ensure the sequence of message delivery, confirm receipt of a delivered status in a status messages webhook before sending the next message in your message sequence. Template management See Template management for a list of endpoints commonly used for getting, updating, and deleting templates.

Fonte: Documentação do WhatsApp Business Platform (Meta) — Modelos de mensagem