Campanhas
Campanhas permitem programar mensagens para uma lista de contatos ou um segmento. A tela possui duas abas com regras diferentes:
| Aba | Quando usar | Formato |
|---|---|---|
| API não oficial | Conexões Baileys ou WuzAPI. | Texto livre, até cinco variações, anexos, lista ou tag. |
| API oficial | Conexões oficiais do WhatsApp Business. | Template aprovado pela Meta, variáveis e mídia de cabeçalho. |
Filtros da tela
As abas oferecem filtros por nome, lista, data, conexão e status. Use Limpar para remover todos de uma vez.
Campanha pela API não oficial
Selecione a aba API não oficial para usar uma conexão Baileys ou WuzAPI.
Lista ou Tag
- Lista — público importado ou montado em Listas de Contatos.
- Tag — envia para contatos que possuem a classificação escolhida.
Use somente uma forma de segmentação por campanha e confira a quantidade de contatos antes de iniciar.
Variações de mensagem
As abas Msg. 1 a Msg. 5 permitem cadastrar textos diferentes. O sistema alterna as mensagens durante o envio. Pelo menos uma variação é obrigatória.
Variáveis de personalização
| Variável | Substitui por |
|---|---|
{{firstName}} | Primeiro nome do contato. |
{{name}} | Nome completo. |
{{ms}} | Bom dia, boa tarde ou boa noite. |
{{date}} | Data atual. |
{{hour}} | Hora atual. |
{{queue}} | Nome da fila. |
{{connection}} | Nome da conexão. |
{{protocol}} | Protocolo do ticket. |
{{CPF/CNPJ}} | Documento cadastrado, quando disponível. |
Exemplo: “Olá {{firstName}}, {{ms}}! Temos uma novidade para você.”
Campanha pela API Oficial
Selecione a aba API oficial. Esse fluxo usa o conteúdo de um template aprovado; por isso não possui as mesmas variações de texto livre da aba não oficial.
Antes de começar
- Tenha uma conexão da API Oficial configurada.
- Sincronize os templates da Meta.
- Use somente templates com status
APPROVED. - Prepare uma lista de contatos com números válidos e consentimento.
Personalizar as variáveis do template
Nos valores das variáveis, podem ser usados dados do contato:
{{name}}— nome completo;{{firstName}}— primeiro nome;{{number}}— número;{{email}}— e-mail.
Exemplo: para o template “Olá {{1}}, seu atendimento foi atualizado”,
preencha Body variável 1 com {{firstName}}.
Veja o processo completo em Templates Oficiais.
Status
| Status | Significado |
|---|---|
| Inativa | Criada, ainda disponível para preparação. |
| Programada | Aguardando a data e hora definidas. |
| Em andamento | Os envios estão sendo processados. |
| Cancelada | O processamento foi interrompido. |
| Finalizada | O processamento terminou. |
Ações disponíveis
Os ícones variam conforme a aba e o status:
- Pausar/Cancelar — interrompe uma campanha em andamento.
- Reiniciar — retoma uma campanha cancelada quando a opção estiver disponível.
- Editar — altera uma campanha antes do processamento, conforme o status.
- Duplicar — cria uma cópia reutilizável na aba não oficial.
- Relatório — abre o acompanhamento da campanha não oficial.
- Excluir — remove a campanha após confirmação.
Relatório da campanha não oficial
O relatório mostra progresso, contatos válidos, entregues, não enviados, conexão, lista, agendamento e conclusão.
Use Baixar não enviados para exportar os contatos que não receberam a mensagem e analisar o motivo antes de criar outro envio.
Boas práticas
- Faça primeiro uma campanha pequena com contatos de teste.
- Confirme conexão, lista, horário, variáveis e mídia.
- Não envie novamente para quem solicitou descadastro.
- Acompanhe erros e respostas durante o processamento.
- Em conexões não oficiais, configure pausas e intervalos em Configurações de Campanhas.
- Na API Oficial, acompanhe qualidade, limites e custos no ambiente da Meta.