What's new, 17 November 2026: A WhatsApp call nobody answered is followed up with a Call back notification in Bitrix24 and, when you turn it on, an automatic message to the caller. Outside the 24-hour window the message box becomes the template picker.
WASync · Developers

Modelos do WhatsApp (WABA)

Crie modelos de mensagem da WhatsApp Business API no WASync, acompanhe a aprovação pela Meta e envie-os pelo chat do CRM, pelas regras de automação do Bitrix24 e pelos Chat Flows.

Um modelo é uma mensagem que a Meta aprovou previamente. É o único tipo de mensagem que um número da WhatsApp Business API (WABA) pode enviar a um cliente que não escreveu para você nas últimas 24 horas. Esta página explica como criar um no WASync, o que acontece na Meta e todos os lugares de onde você pode enviá-lo.

O que é um modelo e quando você precisa de um

O WhatsApp dá a uma empresa uma janela de atendimento ao cliente de 24 horas. Ela abre quando o cliente escreve para você e permanece aberta por 24 horas após a última mensagem dele.

  • Dentro da janela você pode enviar qualquer texto livre, arquivo ou mensagem de voz.
  • Fora da janela (o cliente nunca escreveu, ou escreveu há mais de 24 horas) só sai um modelo aprovado. Quando o cliente responde, a janela abre novamente por 24 horas.

No WASync Chat e na aba WhatsApp de um registro do CRM, uma janela fechada transforma a caixa de mensagem no seletor de modelos, e enquanto a janela está aberta um indicador no cabeçalho do chat mostra quanto tempo ainda resta. Veja Modelos em números Business API.

Todo modelo pertence a uma de três categorias, que a Meta usa na análise e na cobrança:

CategoriaUse para
UtilidadeUma atualização sobre algo que o cliente já iniciou: confirmação de agendamento, status de pedido, fatura, entrega, lembrete de pagamento.
MarketingOfertas, promoções, novidades, retomar o contato com um cliente antigo.
AutenticaçãoCódigos de uso único, com texto definido pela Meta. O WASync ainda não consegue criar esses.

As mensagens de modelo são cobradas pela Meta por mensagem de modelo, por categoria (marketing, utilidade, autenticação). Modelos de utilidade enviados dentro de uma janela de atendimento ao cliente de 24 horas aberta são gratuitos. A cobrança vai para a forma de pagamento da sua conta na Meta, não passa pelo WASync. Criar ou enviar um modelo para aprovação não custa nada.

Requisitos

  • Um número WABA conectado ao WASync, no plano WABA. Veja Tipos de conexão para saber como ele difere de um número pareado por QR.
  • Para gerenciar modelos: um administrador, ou um membro da equipe com acesso de escrita a WhatsApp numbers & templates (matriz de acesso da equipe). Para ler a lista, basta acesso de leitura.
  • Para enviá-los: acesso ao número em Connections → Staff, como em qualquer mensagem.

Números pareados por QR não enviam modelos

Os modelos existem apenas na WhatsApp Business API oficial. Em um número pareado por QR, o botão de modelo não é oferecido, e um robô ou automação que tente enviar um falha com: This WhatsApp connection cannot send templates. Templates need a WhatsApp Business (Cloud API) number.

Criar um modelo

Abra o aplicativo WASync no Bitrix24, vá em Connections, abra o menu … do número WABA e escolha Message templates. A lista mostra cada modelo com seu idioma, categoria, status e, nos rejeitados, o motivo da Meta. Clique em + New template.

Para que serve a mensagem?

Escolha Inform a customer (Utilidade), Promote an offer (Marketing) ou Send a code (marcado como Coming soon). A escolha define a categoria para você. Seja honesto aqui: um texto promocional enviado como Utilidade é rejeitado ou movido para Marketing pela Meta.

Você também pode começar por um exemplo (Appointment reminder, Order is ready, Offer with an image, Let's pick up the conversation) e alterar tudo na etapa seguinte. Escolha o Message language. Um modelo tem um único idioma; para outro idioma, você cria outro modelo.

Escreva a mensagem

Escreva o texto como o cliente o receberá; a pré-visualização à direita é o que ele verá (até 1.024 caracteres).

  • Personalize. Clique em + Personalize para adicionar uma variável: uma comum (Customer name, Date, Time, Order number, Expiry date, Product or service, Amount), um campo do Bitrix24 ou um rótulo seu. Por trás dos panos, cada uma vira {{1}}, {{2}} e assim por diante. Não digite as chaves manualmente.
  • Exemplos para aprovação. A Meta quer um valor de exemplo realista para cada variável (por exemplo "Ana", "31 de outubro"). Use valores verossímeis, nunca dados reais de clientes. Eles não são enviados a ninguém.
  • Cabeçalho (opcional). Um título (até 60 caracteres, sem variáveis), ou uma Image (JPEG ou PNG, até 5 MB), Video (MP4, até 16 MB) ou PDF (até 16 MB). O arquivo que você envia é o exemplo que a Meta analisa. O WASync o guarda como arquivo padrão do modelo, assim os operadores não precisam informá-lo de novo.
  • Mais opções. Um rodapé (até 60 caracteres), até 3 botões de resposta rápida, um botão de link (uma URL fixa, sem variáveis), um botão de ligação e Include a WhatsApp call-permission request. Os rótulos dos botões são limitados a 25 caracteres. O pedido de permissão de chamada só está disponível quando as chamadas do WhatsApp estão ativadas no número (Ativar chamadas em um número): o WhatsApp aprova esse modelo mesmo assim, mas depois recusa todo envio feito por um número sem chamadas.

O WhatsApp rejeita uma mensagem que começa ou termina com uma variável, então coloque uma palavra antes da primeira e depois da última. O WASync verifica isso e as demais regras antes de você poder continuar.

Envie para aprovação

Dê ao modelo um Template name que sua equipe reconheça (só a sua equipe o vê). O WASync gera o nome técnico exigido pela Meta: letras minúsculas, dígitos e _, único neste número e idioma. A lista de verificação mostra o que foi validado. Clique em Send to WhatsApp for approval. Nada é enviado aos clientes.

Não existe rascunho: a lista espelha o que a Meta tem, então um modelo só existe no WASync depois de enviado.

Depois de enviar

O modelo aparece na lista como Pending. A Meta o analisa: normalmente em alguns minutos, às vezes em algumas horas e, ocasionalmente, em até um dia. O WASync recebe o veredito da Meta automaticamente e atualiza o status. Resync from Meta busca o estado atual caso você queira conferir na hora.

StatusSignificado
PendingA Meta está analisando. Ainda não pode ser enviado.
ApprovedPronto. É o único status que pode ser enviado.
RejectedA Meta recusou. O motivo aparece no cartão. Corrija o texto e crie um novo modelo.
PausedA Meta pausou. Os envios falham até ele ficar ativo novamente.
Disabled, In appeal, Pending deletion, Deleted, Limit exceededEstados da própria Meta, exibidos como recebidos.

O ✕ em um cartão exclui o modelo, e também o exclui na Meta.

O arquivo padrão de um modelo com mídia

Um modelo com cabeçalho de imagem, vídeo ou PDF precisa desse arquivo em todo envio. A Meta guarda a cópia dela apenas para a análise, então o WASync guarda o exemplo que você enviou como arquivo padrão do modelo. Para um modelo aprovado antes disso, ou criado na Meta, use Set default image (ou video, document) no cartão dele; Change e Remove também estão lá. Sem um arquivo padrão, quem envia escolhe o arquivo a cada vez.

Modelos criados na Meta

Os modelos que você criou no WhatsApp Manager não aparecem no WASync até você clicar em Resync from Meta na lista de modelos. A sincronização os importa com seus botões e cabeçalho, atualiza todos os status e marca um modelo como Deleted quando ele deixa de existir na Meta. É seguro executá-la a qualquer momento.

Enviar um modelo

As três formas abaixo enviam apenas modelos Approved, apenas de um número WABA, e recusam um contato que pediu para parar de receber mensagens. Se um cliente responde com um pedido de parada, o WASync o marca como optado por sair; um administrador pode remover essa marca quando a pessoa pedir para ser contatada novamente.

Pelo chat

Na aba WASync de um lead, negócio ou item de Smart Process, e no WASync Chat, clique no ícone de modelo ao lado da caixa de mensagem (Send a Meta-approved template). Quando a janela de 24 horas está fechada, a própria caixa de mensagem lista os modelos aprovados e você preenche as variáveis dentro da mensagem; os passos abaixo descrevem a janela que se abre a partir do ícone.

  1. Pesquise por nome, idioma ou texto e escolha um modelo.
  2. Preencha todas as variáveis. A primeira vem preenchida com o primeiro nome do contato quando ele é conhecido; edite como precisar. A pré-visualização mostra a mensagem pronta.
  3. Se o modelo tem cabeçalho de mídia, escolha o arquivo: o arquivo padrão do modelo (pré-selecionado quando existe) ou envie outro. Send fica desativado até você escolher um arquivo.
  4. Opcionalmente, marque Also ask permission for a WhatsApp call after sending (oculto quando o modelo já pede permissão de chamada).
  5. Clique em Send. A mensagem aparece na conversa e na linha do tempo do registro, com o texto final.

Pelas regras de automação do Bitrix24

Abra a etapa do lead, negócio ou Smart Process → Automation rules → Add automation e escolha Send WhatsApp Template (WABA) no grupo WASync. Ela é executada para cada registro que chega a essa etapa, um registro por vez.

  • WABA Connection: o número que envia.
  • Template: só os modelos aprovados desse número aparecem.
  • Variables: uma linha para cada {{n}}. Clique em ⋯ para abrir Insert Field e escolher campos do CRM, ou digite texto. Uma linha pode combinar vários campos e texto fixo. Os campos são lidos do registro em que a regra é executada.
  • Header image / video / document: em um modelo com mídia, escolha File or link (envie um arquivo, ou cole um link ou um campo que contenha um) ou Template's example (o arquivo padrão guardado pelo WASync).

O destinatário é o telefone do cliente do registro. Um negócio que ainda não tem contato é verificado de novo em segundo plano antes de o WASync desistir.

Quando algo impede um envio, o motivo é registrado na linha do tempo do registro em vez de falhar em silêncio: uma variável que ficou vazia, um modelo que não está mais aprovado, um arquivo de cabeçalho ausente, um contato que optou por sair ou um problema de licença. Variáveis vazias impedem o envio porque a Meta rejeita parâmetros vazios.

Depois de instalar ou atualizar o WASync, recarregue a página de automação uma vez: o Bitrix24 mantém as definições dos robôs em cache até a página ser recarregada.

Pelos Chat Flows

No editor de fluxos, uma etapa Message tem uma seção chamada WhatsApp Business template (window closed). Escolha o número, um modelo aprovado, preencha cada variável (um campo do CRM como {{NAME}} ou texto fixo) e, em um modelo com mídia, o arquivo do cabeçalho.

O modelo é usado apenas quando o número é WABA e a janela de 24 horas está fechada, por exemplo na primeira mensagem a um cliente que nunca escreveu. Se a janela está aberta, a etapa envia o texto normal. Se a janela está fechada e a etapa não tem modelo, ela falha com On a WhatsApp Business number the first message must use an approved template. Os arquivos anexados à etapa não são enviados junto com um modelo. Uma variável vazia é substituída por um traço em vez de interromper a etapa. Se a Meta responde com um erro temporário, a etapa tenta de novo uma vez antes de falhar.

O que não está incluído: campanhas em massa

O WASync não tem módulo de campanhas em massa ou de transmissão: você não pode carregar uma lista e enviar um modelo para todos. O que ele faz é enviar um modelo por registro do CRM quando uma regra de automação é executada. Para mensagens a um segmento, coloque esses leads ou negócios em uma etapa (ou mova-os para lá) e deixe a regra Send WhatsApp Template (WABA) rodar nessa etapa.

Respeite os limites da Meta

  • Cada número tem um limite de mensagens que depende do seu nível de qualidade (a página Connections mostra o nível atribuído pela Meta, por exemplo 1.000 clientes por 24 horas). Os envios acima dele falham.
  • Envie mensagens apenas a pessoas que esperam receber notícias suas. Cada bloqueio ou denúncia reduz a classificação de qualidade; uma classificação menor reduz o limite, e um modelo com feedback ruim pode ser pausado.
  • Diga quem você é na primeira linha e explique como parar de receber. Respeite um pedido de parada: o WASync bloqueia modelos para contatos que optaram por sair.
  • Quando a Meta restringe ou limita o número, a página Connections e a janela de Templates exibem um aviso (Meta has blocked sending on this number ou Meta has limited sending on this number) com o que fazer e um link para o Meta Account Quality.

Solução de problemas

O que você vêO que fazer
Status Rejected, com um motivo no cartãoLeia o motivo da Meta. Causas comuns são um texto promocional em um modelo de Utilidade, uma variável no início ou no fim do texto, ou exemplos ausentes. Crie um modelo corrigido com outro nome.
Status PausedA Meta pausou o modelo, em geral por feedback ruim dos clientes. Melhore o texto ou crie um novo modelo. Não continue enviando um modelo pausado.
Aviso Meta has blocked / limited sending on this numberAbra o Meta Account Quality pelo botão do aviso e siga as etapas: forma de pagamento, verificação da empresa ou um recurso de contestação. Os envios e os novos modelos continuam bloqueados até a Meta liberar.
Access token expired or invalid na janela de TemplatesNa página Connections, execute Connect with Facebook nesse número para renovar o token.
Modelo ausente da lista ao enviarSó aparecem modelos Approved. Verifique o status e depois use Resync from Meta.
Erro de variável ao criar (isn't a valid variable, needs a CRM field and an example value)Adicione as variáveis com + Personalize, não digitando chaves, e dê um exemplo a cada uma. A numeração deve seguir 1, 2, 3, sem lacunas.
O robô não enviou, a linha do tempo diz empty variable(s)Um campo mapeado para uma variável estava vazio nesse registro. Preencha o campo no registro, ou troque a variável por outro campo ou por texto fixo.
This template has a … header, ou o envio está desativadoUm modelo com mídia precisa do arquivo. Escolha um arquivo no momento do envio, na regra ou na etapa, ou defina o arquivo padrão do modelo.
This WhatsApp connection cannot send templatesO número é pareado por QR. Use um número WABA.
This template asks for call permission, but WhatsApp calling is not enabled on this number, ou um modelo marcado como Needs calling não pode ser escolhidoAtive as chamadas do número em Connections → WhatsApp calls, ou envie outro modelo.
Templates to this contact are blocked: this contact asked to stop receiving messagesO contato optou por sair. Você ainda pode responder às mensagens que ele enviar. Um administrador só pode remover essa marca se a pessoa pediu para ser contatada novamente.
Esta página foi útil?

On this page