> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brainchat.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Disparos

> Envios em volume de WhatsApp e e-mail numa página só: agende para um contato, uma etiqueta ou uma tabela, acompanhe o envio e veja o resultado de cada destinatário.

Abra em **Conversas → Disparos** no menu lateral. A página tem as abas **Envios**, **Templates**, **Métricas** e **Logs**. Quem usa WhatsApp e e-mail troca entre os dois no seletor **WhatsApp | E-mail** do topo. Cada aba só aparece para quem tem acesso àquela área.

| Aba | WhatsApp | E-mail |
| - | - | - |
| **Envios** | Mensagens programadas e campanhas | Campanhas de e-mail |
| **Templates** | [Templates de WhatsApp](https://docs.brainchat.app/atendimento/templates.md) | [Templates de e-mail](https://docs.brainchat.app/atendimento/templates-email.md) |
| **Métricas** | Enviados, entregues, lidos, respondidos e falhas, comparados com o período anterior e por campanha | Enviados, entregues, abertura (estimada), cliques, falhas, devolvidos e descadastros |
| **Logs** | **API** (mensagens do seu sistema) e **Templates enviados** | Cada e-mail enviado, filtrado por situação (enviados, falhas, devolvidos, na fila) e origem |

## Lista

![Lista de mensagens programadas com abas de status, filtros e busca](https://mintcdn.com/stegia/2sx_YUniIgU9qCdN/images/atendimento/mensagens.png?fit=max\&auto=format\&n=2sx_YUniIgU9qCdN\&q=85\&s=374deefe86de60f4d832a6ffb93fc533)

Lista de envios

Filtre pelo **Nome da campanha**, pelo status (**Todas**, **Pendentes**, **Enviadas**, **Falhas**, **Canceladas**), pelo tipo (template, texto ou agente de IA), por campanhas ou individuais e pelo período. Cada mensagem mostra destinatários na fila, quantos estão sendo enviados e o próximo envio.

| Status | Significado |
| - | - |
| **Pendente** | Aguardando a data e hora |
| **Enviando** | Em andamento |
| **Enviada** | Todos os destinatários receberam |
| **Parcial** | Parte dos envios falhou |
| **Falhou** | Nenhum envio deu certo |
| **Cancelada** | Cancelada antes de terminar |

Ações por mensagem: **Ver detalhes**, **Editar**, **Cancelar envio**, **Duplicar** e **Excluir**.

## Nova mensagem

![Tela Nova mensagem programada com as etapas Destinatários, Conteúdo e Agendamento e a escolha Por Contato, Por Etiqueta ou Por Tabela](https://mintcdn.com/stegia/2sx_YUniIgU9qCdN/images/atendimento/mensagem-nova.png?fit=max\&auto=format\&n=2sx_YUniIgU9qCdN\&q=85\&s=8bb8e7b948e165577de53a3be58c2c5f)

Nova mensagem programada (contato de teste borrado)

**1. Escolha os destinatários**

* **Por Contato**: marque contatos da lista.
* **Por Etiqueta**: todos os contatos com as etiquetas escolhidas.
* **Por Tabela**: qualquer tabela da organização (inteira ou um **Recorte** salvo) e o **Campo do telefone**. Antes de adicionar, a tela mostra os números **Prontos**, **Corrigidos** (DDI 55 ou zero na frente), de **Outro país**, **Repetidos** e **Sem número válido**.

**2. Escolha o conteúdo**

* **Template aprovado**: obrigatório na API Oficial para quem está fora da janela de 24 horas. Preencha as **Variáveis**.
* **Texto livre**: com mídia opcional (imagem ou PDF de até 10 MB).
* **Agente IA**: o agente começa a conversa com cada contato, usando os dados dele como contexto.

**3. Defina data, horário e ritmo**

Em **Configurações de Envio**, escolha o intervalo entre envios (o valor varia entre **Mínimo** e **Máximo**) e o **Horário permitido de envio**. Fora do horário, o envio pausa e retoma no próximo horário permitido.

**4. Agende**

Confira a **Pré-visualização** e salve. Antes de confirmar, a tela mostra o **tempo estimado** e o horário previsto de término, calculados pelo ritmo real do canal, e avisa se o envio passar do horário permitido.

> [!WARNING]
>
> **Ritmo de envio:** pela API Oficial com template, dá para usar **Usar ritmo rápido (2 a 5 s)**. Pelo WhatsApp Business (QR Code) ou com agente, o intervalo mínimo é de 30 segundos: intervalos baixos podem levar ao bloqueio do número. Veja [Boas práticas no WhatsApp](https://docs.brainchat.app/organizacao/boas-praticas-whatsapp.md).

## Personalizar pela linha da tabela

Nos envios **Por Tabela**, use `{{linha.campo}}` no texto ou numa variável do template: cada pessoa recebe o valor da própria linha (nome do produto, data do pedido, vendedor responsável…).

## De onde vieram os destinatários

Em **Origem dos destinatários → Ver a conta**, o detalhe do envio mostra o caminho dos registros da tabela até a lista final e por que cada pessoa ficou de fora: número inválido, **Repetidos (mesmo número, com ou sem o 9)**, acima do limite de um disparo ou já na lista por outra origem. Um envio por tabela aceita até 50 mil destinatários.

## Cancelar no meio e retomar

**Cancelar envio** funciona também com o envio em andamento: quem ainda não recebeu fica como **parado**. Depois, **Retomar envio** (no menu da linha ou no detalhe) continua só com essas pessoas.

## Resultado de cada destinatário

No detalhe do envio, filtre por **Enviados**, **Entregues**, **Lidos**, **Responderam**, **Não responderam**, **Clicaram no botão**, **Resposta automática**, **Falharam**, **Parados** e **Na fila**, busque por nome ou telefone e veja o resumo dos **Botões clicados**. **Exportar** baixa a lista em planilha (abre no Excel). "Respondeu" conta respostas em até 72 horas.

## A Fila fica para quem precisa de atendimento

* Template programado não abre atendimento.
* Envio para um contato novo deixa a conversa em **Fechadas**, sem responsável. Quando o cliente responde, ela abre normalmente.
* Respostas automáticas do cliente (mensagens de ausência) são marcadas como tal e não entram na Fila.

## Agendar a partir da conversa

No campo de mensagem da conversa, **Agendar mensagem** programa o envio só para aquele contato. Os agendamentos do contato aparecem no cabeçalho da conversa e na [ficha do contato](https://docs.brainchat.app/atendimento/contatos.md), onde podem ser cancelados.

## Disparos pela API

Mensagens enviadas pelo seu sistema aparecem em **Logs → API**. Veja [Enviar mensagem](https://docs.brainchat.app/api/enviar-mensagem.md).

> [!NOTE]
>
> Envie só para quem autorizou receber. Disparos não solicitados violam as políticas do WhatsApp/Meta e os [Termos de Uso](https://docs.brainchat.app/ajuda/legal.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.