Campanha com modelo de WhatsApp: parâmetros, mídia no cabeçalho e validação

Monte uma transmissão de WhatsApp com modelos aprovados pela Meta: preencha as variáveis do corpo, adicione imagem ou vídeo no cabeçalho e passe na validação sem erros de envio.

Jun 26, 2026

As campanhas de WhatsApp no Omnifox usam modelos aprovados pela Meta. Um modelo é uma mensagem pré-aprovada que pode ter variáveis ({{1}}, {{2}}...), um cabeçalho de texto ou mídia e botões. Este artigo mostra como preencher esses parâmetros corretamente para que a transmissão saia sem rejeições.

Requisitos

  • Disponível em todos os planos (a partir do Lite), com limites mensais conforme o plano: transmissões por mês, destinatários por envio e destinatários por mês.
  • Um canal de WhatsApp oficial (Cloud API ou Coexistence) conectado e ativo. O canal de WhatsApp por QR não permite transmissões.
  • Lembre-se de que a Meta cobra à parte cada mensagem de modelo enviada.
  • Pelo menos um modelo aprovado pela Meta nesse canal. Modelos pendentes ou rejeitados não aparecem no seletor.
  • Permissão Gerenciar transmissões no seu perfil.

Passos

  1. No menu lateral, abra Transmissões e clique em Criar transmissão.
  2. Passo 1 - Canal: escolha seu canal de WhatsApp. O Omnifox detecta o tipo automaticamente como Modelo de WhatsApp.
  3. Passo 2 - Público: defina quem vai receber (todos, por grupos, por etiquetas ou por campo personalizado). O contador de destinatários estimados atualiza sozinho.
  4. Passo 3 - Mensagem: dê um nome à transmissão (apenas referência interna) e selecione o modelo de WhatsApp. Você verá a Pré-visualização do modelo.
  5. Preencha os Parâmetros do modelo:
    • Cabeçalho (texto): se o cabeçalho tiver variáveis, digite cada valor.
    • Cabeçalho (imagem/vídeo/documento): cole uma URL pública do arquivo no campo de mídia do cabeçalho. Ela precisa estar acessível na internet (não pode ser um link privado ou local).
    • Corpo: preencha cada variável {{N}}. Você pode personalizar com {{first_name}}, {{last_name}}, {{company}} etc.
    • Botões de URL: se o modelo tiver um botão de URL dinâmica, informe o valor que será substituído no link.
  6. Passo 4 - Agendamento: escolha Enviar agora ou Agendar para depois (data e hora).
  7. Passo 5 - Revisão: confirme canal, público e mensagem e clique em Enviar transmissão (ou Agendar transmissão).

Verificação

Ao confirmar, o Omnifox leva você à tela de detalhes da transmissão, onde acompanha o status e o progresso das entregas. Cada destinatário mostra o resultado à medida que a Meta confirma a entrega.

Se não funcionar

  • Nenhum modelo aparece: confirme que ele está aprovado pela Meta e vinculado ao canal selecionado.
  • Não avança para o passo 4: a validação exige que todas as variáveis {{N}} do corpo e do cabeçalho de texto tenham valor, e que a URL de mídia esteja preenchida quando o cabeçalho for imagem/vídeo/documento. Revise os campos marcados em vermelho.
  • A Meta rejeita o envio com um erro genérico: quase sempre é uma variável vazia ou uma URL de mídia inacessível. Verifique se o link abre em uma janela anônima.
  • Você atingiu um limite do plano: existem limites de transmissões por mês, de destinatários por envio e de destinatários acumulados no mês. Ao atingi-los, o botão de envio é bloqueado com um aviso.

Dicas

  • Hospede as imagens do cabeçalho em um armazenamento estável (evite links temporários que expiram), pois a Meta baixa o arquivo no momento do envio.
  • Teste o modelo em você mesmo criando um público de um único contato antes de disparar a campanha completa.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp