Canais · Atualizado em 06/10/2026

Como consultar modelos de mensagem no Pipe

Veja a lista de modelos de mensagem do WhatsApp, entenda os status, escolha o fluxo de retorno, ative, sincronize e exclua modelos.

A página Modelos de mensagens reúne os modelos do WhatsApp dos canais conectados. Nela você vê o texto, o status de aprovação, define para onde a conversa segue quando o cliente responde e controla quais modelos podem ser enviados.

Quando usar

Um modelo é necessário quando a empresa precisa começar a conversa, por exemplo para avisar que um pedido saiu para entrega. Consulte a lista para saber se o modelo já foi aprovado, para escolher o bloco que trata a resposta e para tirar de circulação um texto antigo. Na Loja Girassol, o modelo confirmacao_pedido fica ativo; o promo_inverno, de uma campanha encerrada, é desativado.

Pré-requisitos

  • Um canal WhatsApp conectado (veja como conectar o WhatsApp).
  • Permissão para administrar canais e comunicação do projeto.

Passo a passo

  1. Na Gestão, abra o fluxo e entre em Atendimento.
  2. No menu lateral, abra Comunicação > Modelos de mensagens.
  3. Para localizar um modelo, digite no campo Pesquise pelo nome do modelo de mensagem.
  4. Se preferir, filtre por Fluxo de retorno ou por Status (Habilitado ou Desabilitado).
  5. Na coluna Mensagem, clique em abrir para ver o texto completo. As variáveis, como {{1}}, aparecem destacadas.
  6. Na coluna Fluxo de retorno, clique em Escolher (ou Alterar) e selecione o bloco do Builder que deve tratar a resposta. Nenhum remove a escolha.
  7. Na coluna Ativo, use o interruptor para ligar ou desligar o modelo no envio.
Tela de demonstração do Pipe

Colunas da lista

ColunaO que mostra
NomeNome do modelo, em minúsculas e sem espaços.
IdiomaIdioma do cadastro, como pt_BR.
MensagemPrévia do texto, com o link abrir para ler tudo.
Fluxo de retornoBloco do Builder escolhido, ou um traço quando não há. Se o bloco foi apagado, aparece Bloco removido com o código.
StatusAprovado, Pendente, Rejeitado ou Pausado.
AtivoInterruptor que liga ou desliga o envio do modelo.
(ícone de lixeira)Excluir o modelo.

Status

O Pipe mostra os status na ordem em que costumam acontecer:

StatusComo entender
PendenteO modelo foi enviado e aguarda a análise. Também é mostrado enquanto o modelo está em recurso ou em exclusão.
AprovadoO modelo pode ser usado no envio.
RejeitadoO modelo não foi aprovado. Veja o que conferir.
PausadoO modelo foi pausado, desabilitado ou atingiu um limite. Não pode ser enviado.

Sincronizar com a Meta

Os botões Sincronizar "nome do canal" com a Meta aparecem acima da lista, um por canal. Ao clicar, o Pipe consulta a Meta e atualiza a lista: o resumo mostra quantos modelos foram criados, atualizados e removidos, e quantos foram ignorados. Use quando um modelo criado fora do Pipe não aparecer.

Excluir um modelo

  1. Na linha do modelo, clique no ícone de lixeira (Excluir).
  2. Leia o aviso: a Meta apaga o modelo em todos os idiomas cadastrados com este nome.
  3. Confirme em Excluir.

Resultado esperado

A lista mostra o status atual de cada modelo, e o modelo ativo e aprovado fica disponível para envio no Desk e na mensagem ativa.

Boas práticas

  • Use nomes que descrevam o objetivo, como confirmacao_pedido e aviso_entrega.
  • Defina o fluxo de retorno de todo modelo que espera resposta, para que a resposta caia no bloco certo.
  • Desative, em vez de excluir, os modelos de campanhas passadas.

Limitações

  • A lista é paginada e filtra por nome, fluxo de retorno e habilitação; não filtra por status da Meta.
  • O status vem da Meta; o Pipe não decide a aprovação.
  • A lista não mostra um motivo de rejeição.
  • Um modelo de um canal sem fluxo com blocos não tem blocos para escolher no fluxo de retorno.

Problemas comuns

  • Nenhum modelo aparece: a lista mostra "Ainda não foram cadastrados modelos de mensagem válidos para este chatbot". Crie um modelo ou sincronize com a Meta.
  • Nenhum modelo encontrado para estes filtros: limpe a busca e os filtros.
  • Aparece Bloco removido: o bloco escolhido foi apagado do fluxo; escolha outro em Alterar.
  • Não é possível excluir: a mensagem de erro aparece na janela de confirmação; confira o canal e tente de novo.

Próximos passos

Perguntas frequentes

O que é um modelo de mensagem?

É um texto pré-cadastrado, com variáveis, que a empresa usa para iniciar conversas no WhatsApp. O texto que vale para o envio é o aprovado pela Meta.

O que é o fluxo de retorno?

É o bloco do Builder onde a conversa continua quando o cliente responde ao modelo.

O interruptor Ativo apaga o modelo?

Não. Ele só liga ou desliga o uso do modelo no envio: desativado, o modelo deixa de aparecer para envio.

Excluir apaga só um idioma?

Não. A Meta apaga o modelo em todos os idiomas cadastrados com o mesmo nome.

Meu modelo não aparece na lista. O que fazer?

Clique em Sincronizar com a Meta, no botão com o nome do canal, e confira o resumo de modelos criados, atualizados e removidos.