Skip to main content
Uma campanha envia um template da Meta aprovado para todos os leads que passam num filtro (coluna, tags, propriedades). Serve para avisos, reativação de base, lançamentos e lembretes em massa. Três coisas definem como ela funciona:
  • O envio roda no navegador. Feche a aba e o envio para.
  • Não há agendamento. A campanha sai quando alguém clica em Iniciar Campanha.
  • Só existe na conexão oficial. Com conexão não oficial (QR Code), o menu Campanhas some.

​
Onde fica no painel

Menu Campanhas (admin, editor e gestor). A tela lista as campanhas com filtros, template e status (Criada, Em andamento, Concluída (Nx)), e os botões executar, editar, ver relatório e excluir.

​
Como configurar

Nova Campanha abre um assistente em dois passos.

​
1. Nome e template

​
2. Filtros de leads

  • Filtro de tag: o lead tem a tag.
  • Filtro de propriedade: o lead tem a propriedade preenchida, com qualquer valor. Não dá para filtrar por um valor específico.
  • As variáveis do template viram filtros de propriedade sozinhas. Um template com {{cidade}} já entra com o filtro “tem cidade”, para não mandar a mensagem para quem não tem o valor. {{nome}} não precisa: sem nome, vai “Cliente”.
A contagem de leads atualiza a cada mudança de filtro. Ao concluir, a campanha fica salva com o status Criada. Nada é enviado ainda. O filtro considera todos os leads do projeto, inclusive os que nunca conversaram (importados por CSV) e os com atendimento encerrado.

​
Como executar

Clique em executar (▶) na linha da campanha. Antes de começar, a tela mostra: Se Faltam enviar passa do limite do número, a tela avisa Limite diário ultrapassado e só as primeiras mensagens, até o limite, são enviadas. Iniciar Campanha começa o envio:
1

Conferência da mídia

Se o template tem mídia no cabeçalho, a Zatten confere se o arquivo pode ser baixado. Se não puder, a campanha não começa e a tela diz o que fazer.
2

Envio em lotes

Os leads saem em lotes de 10 mensagens em paralelo, com uma pausa de 100 milissegundos entre lotes. A Fila de Envio mostra cada lead: pendente, processando, enviado ou erro.
3

Pausar e retomar

Pausar termina o lote atual e para. Retomar continua só com quem ainda não recebeu. Enquanto o envio roda, a janela não fecha: a tela pede “Pause a campanha antes de fechar”.
4

Fim

Quando a fila acaba, a campanha vira Concluída e não pode ser executada de novo nem editada.

​
Relatório

Ver relatório mostra os números da campanha (Enviadas, Entregues, Lidas, Falhas) e a lista de mensagens com lead, telefone, status, data e hora, o erro de cada falha (Ver erro) e um atalho para o chat do lead. O histórico de execuções mostra cada vez que a campanha rodou (cada pausa e retomada é uma execução), com total e processadas.

​
Como funciona por trás

  • Cada mensagem é um envio de template pela API do projeto, marcado com a campanha. Por isso, as regras do envio de template valem: variável sem valor no lead, template não aprovado ou mídia inacessível fazem aquela mensagem falhar. Veja Templates do WhatsApp.
  • “Já enviado” é quem tem uma mensagem desta campanha registrada, qualquer que seja o status. A mensagem só é registrada depois que a Meta aceita o envio. Lead cujo envio falhou na hora (por exemplo, variável sem valor) volta para a fila numa retomada. Já uma mensagem aceita e depois marcada como falha na entrega conta como enviada: esse lead não recebe de novo nesta campanha.
  • Durante o envio, a campanha cria uma chave de API temporária (“Campaign … - Auto Generated”), que aparece em Chaves de API e é apagada ao pausar ou terminar.
  • O lead que responde cai na conversa normal: abre a janela de 24h e o agente responde, se a IA estiver ligada para ele.

​
Pelo MCP e pela API

Campanhas não viajam no template do projeto: o MCP não lê nem cria campanhas. Para disparar em massa fora do painel, por exemplo com agendamento, use a API do dia a dia num servidor seu:
  • POST /api/v1/messages/template para cada lead, com a chave de API do projeto;
  • espace as chamadas (a API não tem limite fixo publicado, mas respeite o Retry-After se vier 429) e respeite o limite de mensagens da Meta;
  • controle você mesmo quem já recebeu.
Veja Mensagens, Limites e o playbook Campanhas.

​
Armadilhas

  • Fechar a aba, desligar o computador ou perder a internet interrompe o envio. Deixe a aba aberta até Concluída. Se cair no meio, abra a campanha e Retomar: quem já recebeu não recebe de novo. Se a chave temporária ficar em Chaves de API, exclua.
  • Sem agendamento. “Mandar amanhã às 9h” só com alguém clicando às 9h, ou pela API.
  • Concluída não roda de novo. Para mandar o mesmo template a quem entrou no filtro depois, crie outra campanha. Atenção: “já enviados” é por campanha; a nova manda de novo para quem recebeu a anterior. Separe o público com uma tag (por exemplo, marque quem recebeu).
  • Passou do limite, o resto não sai. Acima do limite do número, só as primeiras mensagens saem e a campanha termina como concluída. Divida o público em campanhas menores que o limite, em dias diferentes.
  • O limite da Meta é por portfólio de negócios. Ele é compartilhado por todos os números do mesmo portfólio e conta pessoas diferentes contatadas fora da janela em 24 horas móveis. Outras campanhas, follow-ups e envios pela API do mesmo portfólio gastam o mesmo limite.
  • Lead sem o valor da variável falha. Mantenha os filtros de propriedade que o painel adiciona.
  • Falha na entrega não volta para a fila. Lead com mensagem desta campanha marcada como falha (depois de aceita pela Meta) conta como “já enviado”. Para tentar de novo, crie outra campanha só para esses leads (por exemplo, marcando-os com uma tag a partir do relatório).
  • Qualidade e bloqueios. Mandar para quem não pediu derruba a qualidade do template e do número, o que pode pausar o template e travar o aumento de limite. A própria tela recomenda evitar várias campanhas seguidas.
  • Some na conexão não oficial. Trocar a conexão do projeto para QR Code esconde o menu e bloqueia a página.
  • Estimativa não é cobrança. O valor da tela é uma referência fixa. O preço real depende da categoria, do país e das regras atuais da Meta.

​
Perguntas frequentes

Não pelo painel. Use a API (POST /api/v1/messages/template) a partir de um agendador seu.
Não. O que já saiu fica registrado. Abra a campanha e clique em Retomar: ela continua só com quem ainda não recebeu.
O template foi criado fora da Zatten e a mídia dele está num endereço da Meta que expira. Edite o template em WhatsApp → Templates e suba a mídia pelo painel.
A Meta sobe a faixa sozinha quando o negócio é verificado ou manda mensagens de boa qualidade usando pelo menos metade do limite. Veja a página de limites de mensagens.
O agente, se a IA estiver ligada para aquele lead. Se a campanha pede atendimento humano, filtre por uma coluna com Desativar IA ou prepare o agente para o assunto.

​
Para saber mais