# 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

| Operação | Quando usar |
|---|---|
| [Criar campanha simples](/endpoint/post/sender~simple) | Enviar o mesmo conteúdo para vários destinatários |
| [Criar campanha avançada](/endpoint/post/sender~advanced) | Definir conteúdo ou tipo de mensagem individualmente para cada destinatário |

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](/endpoint/get/sender~listfolders) mostra os lotes e seus estados.
- [Listar mensagens da campanha](/endpoint/post/sender~listmessages) detalha o que pertence a um `folder_id`.
- [Consultar estado e métricas](/endpoint/get/sender~stats) 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](/endpoint/post/sender~edit) 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](/endpoint/post/sender~cleardone) e [limpar todas as campanhas](/endpoint/delete/sender~clearall) 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](/docs/message-queues).