> ## Documentation Index
> Fetch the complete documentation index at: https://ajuda.pandazap.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Campanhas: Agende, Filtre e Envie Mensagens em Massa
> Agende e execute campanhas em massa pelo WhatsApp no PanÐá Zap com até três variações de mensagem, filtros de contato e controles de envio.
As Campanhas permitem agendar mensagens em massa para listas de contatos segmentadas em uma data e horário específicos. Diferente do **Envio em Massa** — que dispara mensagens imediatamente —, as campanhas dão controle total sobre quando o envio começa, o ritmo de entrega e os limites diários de volume, protegendo seu canal contra sinalizações ou banimentos.
## Criar uma Campanha
Vá em **Comunicação e Marketing → Campanhas** e clique em **+ Nova Campanha**.
### Configurações Básicas
| Campo | Descrição |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Nome** | Rótulo interno para esta campanha |
| **Sessão / WhatsApp** | O canal (número do WhatsApp) de onde enviar |
| **Data/hora de início** | Quando o PanÐá Zap começa a disparar as mensagens |
| **Atraso entre mensagens (segundos)** | Pausa entre cada envio |
| **Janela de envio** | Restringe a entrega a horários específicos do dia; a campanha pausa automaticamente fora dessa janela e retoma no dia seguinte, se não tiver terminado |
| **Limite diário de mensagens** | Número máximo de mensagens enviadas por dia |
Configure o **atraso entre mensagens** para um mínimo de **15 segundos**. Usar atrasos menores aumenta significativamente o risco de o seu canal do WhatsApp ser sinalizado ou banido permanentemente por comportamento de envio em massa.
### Variações de Mensagem
Você pode escrever até **três variações de mensagem** por campanha. Cada contato recebe exatamente **uma** das três — selecionada aleatoriamente. Isso não é uma sequência de mensagens; é uma distribuição aleatória do tipo A/B/C entre o seu público.
Use redações diferentes para a mesma mensagem principal, reduzindo padrões de texto idêntico, o que diminui o risco de detecção de spam. Use `{{name}}` em qualquer variação para personalizar com o nome do contato.
Você também pode anexar um arquivo de mídia — imagem, vídeo ou PDF — que será enviado junto com a mensagem. O **painel de pré-visualização** mostra como cada variação é exibida em uma tela de celular.
Para **canais oficiais da API do WhatsApp Business (WABA)**, mensagens em texto livre não são permitidas em campanhas. Use `templateName` e `templateLanguage` para referenciar um template de mensagem WABA pré-aprovado.
### Adicionando Destinatários
Filtre seu público usando um ou mais dos seguintes critérios:
* **Tag** — contatos com uma tag específica
* **Estado** — contatos por DDD de estado brasileiro
* **Busca individual** — encontre e adicione contatos específicos por nome ou número
## Ciclo de Vida da Campanha
| Estado | Significado |
| --------------- | --------------------------------------------------- |
| **Pendente** | Criada, mas o horário de início ainda não chegou |
| **Agendada** | Horário de início confirmado e o envio está na fila |
| **Processando** | Enviando mensagens ativamente |
| **Pausada** | Pausada manualmente ou fora da janela de envio |
| **Cancelada** | O envio foi interrompido permanentemente |
| **Finalizada** | Todas as mensagens foram entregues |
Você só pode editar uma campanha enquanto ela estiver nos estados **Pendente**, **Agendada**, **Pausada** ou **Cancelada**. Para pausar, retomar ou cancelar uma campanha em andamento, abra o menu de ações de três pontos no card da campanha.
## Envio em Massa
Para disparo imediato sem agendamento, vá em **Comunicação e Marketing → Envio em Massa**. As seguintes abas estão disponíveis:
| Aba | Descrição |
| ------------------------ | -------------------------------------------------------------------------------- |
| **Template** | Envie templates aprovados pelo WABA para uma lista de contatos |
| **Variável de Template** | Envie templates WABA com variáveis por destinatário carregadas de um arquivo CSV |
| **Texto** | Envie mensagens em texto livre por canais QR Code (não WABA) |
| **Variável de Texto** | Envie mensagens em texto livre com variáveis por destinatário de um arquivo CSV |
| **WaVoIP** | Envie chamadas de voz com um arquivo de áudio anexado |
| **SMS** | Envie mensagens SMS pelo seu provedor de SMS configurado |
| **Relatório** | Veja o histórico completo de todos os envios em massa |
### Formato da Variável CSV
Para envios de **Variável de Template** e **Variável de Texto**, envie um arquivo CSV com um destinatário por linha:
```text theme={null}
number,var1,var2,var3
5511999990001,Maria,Plano Ouro,R$49
5511999990002,João,Plano Prata,R$29
```
* A primeira coluna é sempre o número de telefone do destinatário (código do país + DDD + número, sem espaços ou caracteres especiais).
* As colunas seguintes correspondem a `{{var1}}`, `{{var2}}`, `{{var3}}` e assim por diante no seu template de mensagem.
* Envolva qualquer valor que contenha vírgula entre **aspas duplas**: `"valor, com vírgula"`.
**Números de celular brasileiros:** DDDs menores que 30 (por exemplo, 11, 21) exigem o prefixo do 9º dígito. DDDs 30 ou maiores não usam o 9º dígito.