Mensagem em massa

Campanhas organizam vários envios sob um mesmo identificador, com agendamento, intervalo e controle próprios. Use esse fluxo quando o trabalho precisa ser acompanhado como um lote — ele é separado da fila de mensagens diretas com async: true.

Escolha o tipo de campanha

Configure os intervalos de envio e, quando necessário, scheduled_for. Preserve o folder_id retornado: ele identifica a campanha nas consultas e ações seguintes.

Para publicar no status dos grupos em vez de mandar no chat, use groupStatus: true (na campanha simples, para todos; na avançada, por mensagem). Só vale para grupos (@g.us) e para texto, imagem ou vídeo.

Acompanhar a execução

• Consultar campanhas mostra os lotes e seus estados.
• Listar mensagens da campanha detalha o que pertence a um folder_id.
• Consultar estado e métricas apresenta o ritmo atual e o próximo envio agendado.

Mensagens processadas não significam necessariamente entregues ou lidas. Para confirmação por destinatário, acompanhe os eventos e estados das mensagens.

Pausar, continuar ou excluir

Use Controlar campanha com o folder_id:

• stop pausa os envios ainda não realizados;
• continue retoma uma campanha pausada;
• delete remove a campanha e seus envios ainda não realizados, preservando o histórico do que já foi enviado.

Consulte o estado novamente depois da ação. Não recrie a campanha apenas porque uma resposta demorou: primeiro verifique se o lote já existe.

Limpeza

Limpar campanhas concluídas e limpar todas as campanhas têm escopos diferentes. Confira a operação e a instância antes de usar qualquer limpeza.

Para envios pontuais que apenas precisam sair da requisição principal, use Filas de mensagem.