> ## 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.

# Mensagens Agendadas

> Agende envios de mensagens WhatsApp para um horário específico ou dispare via API para múltiplos destinatários.

# Mensagens Agendadas

A seção **Mensagens** gerencia envios em massa ou agendados via WhatsApp. Cada registro representa uma **campanha de mensagem** — com um ou múltiplos destinatários — programada para um horário específico ou disparada via API.

<Note>
  Esta seção é para mensagens **agendadas e campanhas**. Para o histórico de conversas individuais, acesse **Conversas**.
</Note>

***

## Abas

| Aba           | Descrição                                           |
| ------------- | --------------------------------------------------- |
| **Agendadas** | Mensagens programadas para envio futuro pelo painel |
| **API**       | Mensagens disparadas via API ou webhook externo     |

***

## Status das Mensagens

| Status        | Significado                                     |
| ------------- | ----------------------------------------------- |
| **Pendente**  | Aguardando o horário de envio                   |
| **Enviando**  | Envio em andamento                              |
| **Enviada**   | Envio concluído com sucesso                     |
| **Parcial**   | Alguns destinatários receberam, outros falharam |
| **Falhou**    | Nenhum destinatário recebeu                     |
| **Cancelada** | Cancelada antes do envio                        |

***

## Agendar uma Mensagem

<Steps>
  <Step title="Nova mensagem">
    Clique em **Nova Mensagem Agendada**. Defina um nome interno para a campanha.
  </Step>

  <Step title="Conteúdo">
    Escreva o texto da mensagem. Use variáveis para personalizar:

    * `{{nome}}` — nome do destinatário
    * `{{telefone}}` — número do destinatário
  </Step>

  <Step title="Destinatários">
    Selecione quem receberá a mensagem:

    * **Todos os contatos** da instância
    * **Por tag** — contatos com uma etiqueta específica
    * **Lista manual** — cole os números separados por linha
  </Step>

  <Step title="Horário">
    Defina a data e hora exata de envio (fuso horário da instância).
  </Step>

  <Step title="Confirmar">
    Revise e confirme. A mensagem aparecerá com status **Pendente**.
  </Step>
</Steps>

***

## Informações por Campanha

| Informação    | Descrição                         |
| ------------- | --------------------------------- |
| **Nome**      | Identificação interna da campanha |
| **Status**    | Estado atual do envio             |
| **Horário**   | Data e hora agendada              |
| **Enviados**  | Destinatários que receberam       |
| **Pendentes** | Ainda na fila de envio            |
| **Falharam**  | Não receberam                     |

***

## Ações

| Ação         | Disponível para        | Descrição                         |
| ------------ | ---------------------- | --------------------------------- |
| **Cancelar** | Pendente               | Cancela antes do horário de envio |
| **Duplicar** | Todas                  | Cria cópia com horário +1 hora    |
| **Detalhes** | Todas                  | Abre o histórico por destinatário |
| **Excluir**  | Concluídas, canceladas | Remove o registro                 |

***

## Disparo via API

Mensagens disparadas via API aparecem automaticamente na aba **API** para rastreamento. Consulte a [documentação da API](/api/enviar-mensagem).

<Info>
  O Brainchat aplica um intervalo mínimo entre envios para proteger o número de banimento. Evite enviar para mais de 200 destinatários por hora.
</Info>

***

## Boas Práticas

<AccordionGroup>
  <Accordion title="Horários recomendados">
    Envie em horário comercial: **9h às 18h**, segunda a sexta. Mensagens fora desse horário têm taxas de resposta menores.
  </Accordion>

  <Accordion title="Consentimento">
    Envie apenas para contatos que consentiram em receber comunicações. Disparos não solicitados violam as [políticas de uso](/legal/termos) e as diretrizes do WhatsApp/Meta.
  </Accordion>
</AccordionGroup>