Campanha em Massa

📣 Campanhas em Massa — Guia Completo (Chat-Bot)

Envie mensagens do WhatsApp para múltiplos destinatários carregando um arquivo CSV. Ideal para marketing, cobranças, atualizações e notificações em larga escala.

Importante: este recurso automatiza envios em lote, otimizando tempo e esforço, mas exige atenção a limites técnicos, formatação de arquivos e boas práticas de envio.

🔔 Notas importantes — leia antes de prosseguir

1. Apenas contagem de aprovações exibida
   Após o processamento em massa, o sistema exibirá somente a quantidade de remetentes processados com sucesso. Não há lista detalhada de quais contatos falharam ou tiveram sucesso individualmente.

2. Sem relatório de entrega
   O processo não gera automaticamente um relatório de entrega (entregues/failed/read). Para análise detalhada, você deverá utilizar relatórios de campanha (quando disponíveis) ou exportar logs conforme o fluxo da plataforma.

3. Risco de timeout / falha do servidor
   O processamento de grande volume pode estourar limites de tempo ou memória do servidor (especialmente em hospedagens compartilhadas). Isso pode resultar em timeouts ou travamentos.

4. Timeout do PHP
   Se ocorrer timeout em PHP, será necessário aumentar o max_execution_time e, eventualmente, memory_limit no servidor. Estas alterações dependem do provedor/administrador — consulte sua equipe de infraestrutura.

5. Processamento em lote único (sem agrupamento)
   O sistema tenta processar todo o CSV em uma única operação. Ex.: um CSV com 5.000 registros será processado de uma vez — comportamento que depende da capacidade do servidor.

6. Arquivo CSV limpo é obrigatório
   Erros de formatação (cabeçalho ausente, colunas erradas, codificação incorreta) causam falhas. Use o arquivo de exemplo como base e valide antes do upload.

✅ Boas práticas iniciais (recomendadas)

• Divida grandes listas em arquivos menores (ex.: 500–1.000 registros por arquivo) para reduzir risco de timeout.

• Use servidores com recursos adequados (memória e tempo de execução).

• Valide CSV em UTF-8 e sem caracteres especiais inválidos.

• Garanta que todos os números de telefone tenham código do país e sinal +.

• Teste com um arquivo pequeno (10–20 contatos) antes de rodar um envio em massa completo.

• Monitore o consumo de API da Meta e limites de envio do WABA.

🧭 Passo a passo: criar e enviar uma nova Campanha em Massa

1) Acesse a tela de criação de campanha em massa

• Abra o módulo Campanhas → Nova Campanha (CSV / Mass).

• A interface mostrará campos para nome, upload CSV, seleção de modelo, mapeamento de variáveis e opções de agendamento.

2) Insira o nome da campanha

• Campo obrigatório. Use nomes claros e padronizados para facilitar auditoria.
  Ex.: Summer Sale 2025 ou Newsletter June.

3) Carregue o arquivo CSV com os destinatários 📥

Métodos de upload:

• Arrastar e soltar na área tracejada; ou

• Selecionar arquivo via botão de upload.

Atenção: somente arquivos .csv são permitidos.

Colunas obrigatórias do CSV (primeira linha = cabeçalho EXATO):

• FIRST NAME (PRIMEIRO NOME) — obrigatório

• LAST NAME (SOBRENOME) — obrigatório

• PHONE (TELEFONE) — obrigatório — com código do país e sinal + (ex.: +1 555 123 4567)

• EMAIL — opcional (recomendado)

• COUNTRY — opcional

Exemplo de linha de cabeçalho:

FIRST NAME,LAST NAME,PHONE,EMAIL,COUNTRY
Sample Data,Sample Data,+1 555 123 4567,abc@gmail.com,Sample Data

Codificação: UTF-8 (obrigatório para evitar caracteres inválidos).

Validação antes do upload:

• Confirme cabeçalhos exatos e presença das colunas obrigatórias.

• Remova linhas vazias.

• Use apenas números válidos no campo PHONE.

• Evite caracteres especiais não UTF-8.

4) Escolha o modelo de mensagem aprovado (obrigatório) 📄

• Selecione do menu suspenso o modelo previamente aprovado na sua conta WABA.

• Modelos possuem placeholders/variáveis (ex.: [variable 1], [variable 2]) que serão substituídos por dados do CSV ou por entradas manuais.

Observação: usar o modelo correto garante conformidade com políticas do WhatsApp.

5) Mapear variáveis dinâmicas (merge/mapping) 🔁

Como mapear:

• Após upload do CSV, associe cada placeholder do modelo à coluna correspondente do CSV.
  Ex.: [variable 1] → FIRST NAME; [variable 2] → ORDER_VALUE; [variable 3] → DUE_DATE.

Exemplo de mapeamento visual:

Nota: Você pode também inserir valores fixos manualmente para todos os registros (uso pontual), mas para envio em massa é recomendável usar o CSV.

6) Pré-visualize a mensagem (Live Preview) 👀

• A pré-visualização mostra como a mensagem ficará para cada destinatário com os valores substituídos.

• Revise amostras aleatórias do CSV para garantir que as substituições estejam corretas (formatos de data, moedas, espaços).

Exemplo de pré-visualização:

Olá John, a sua fatura para o projeto foi gerada. Valor: US$ 200. Vencimento: 05/07/2025.

7) Configurações de envio / Agendamento ⏰

Opções:

• Enviar agora — ignora agendamento e envia imediatamente.

• Agendar — selecione data e hora (verifique fuso-horário do sistema).

• Se nenhum agendamento for definido, a campanha permanece como rascunho até acionada.

Recomendação: para grandes volumes, prefira agendar fora de horários de pico ou fazer envios em lotes menores.

8) Iniciar envio em massa ▶️

• Após revisar, clique em Enviar Campanha (ou botão equivalente).

• O sistema iniciará processamento do CSV e realizará os envios conforme configurado.

O que será exibido após o processamento:

• Apenas o número total de remetentes processados com sucesso.

• Não haverá, nessa tela, o relatório detalhado por contato.

⚠️ Limitações técnicas e como mitigar

1. Timeout / Falhas

   • Divida o arquivo grande em vários arquivos menores.

   • Execute envios sequenciais (ex.: 5 arquivos de 1.000 registros).

   • Use servidor com recursos adequados (não hospedagem compartilhada).

2. Problema de PHP

   • Aumente max_execution_time e memory_limit (solicite ao provedor).

   • Utilize processamento em background (fila) se disponível na plataforma.

3. Sem relatório de entrega

   • Se precisar de detalhes de entrega, colete logs de API ou utilize relatórios posteriores oferecidos na área de Campanhas (quando houver).

   • Mantenha backups dos CSVs enviados para cruzamento externo.

4. Dados inválidos no CSV

   • Faça validação prévia (scripts locais, Excel ou Google Sheets).

   • Remova ou corrija números com formatação errada.

🧾 Pós-envio: acompanhamento e exportação

• Confirmação: a campanha será listada no histórico de campanhas com status e resumo.

• Exportar relatórios: quando disponível, utilize a função Exportar CSV em Campanhas → View → Exportar CSV para baixar métricas agregadas.

• Análise externa: use o CSV exportado com Excel/Google Sheets para análises adicionais.

📎 Campanhas baseadas em documentos (anexo/cabeçalho)

• Permite carregar um arquivo que será exibido como cabeçalho no WhatsApp (anexo).

• Tipos permitidos: .pdf, .doc, .docx, .txt, .xls, .xlsx, .ppt, .pptx.

• Tamanho máximo: 100 MB.

• O documento será exibido na pré-visualização e enviado junto à mensagem.

🔧 Dicas técnicas e de compliance

• Sempre teste com um grupo pequeno (10–20 contatos) antes de enviar a base total.

• Verifique se o conteúdo do modelo está em conformidade com políticas de mensagens comerciais do WhatsApp (evite spam).

• Mantenha logs dos envios e do CSV original para auditoria e reclamações.

• Use campos de opt-out/opt-in na sua base para respeitar preferências de clientes.

✅ Checklist rápido antes de enviar

• CSV com cabeçalho correto e codificação UTF-8

• Colunas obrigatórias preenchidas (FIRST NAME, LAST NAME, PHONE)

• Telefones com código do país e +

• Modelo aprovado selecionado

• Mapeamento de variáveis conferido

• Pré-visualização revista (amostras)

• Agendamento/Envio agora definido

• Backup do CSV salvo localmente

🔁 Navegação

Página anterior: Gerente de Campanha
Próxima página: Bot de Mensagens