## Visão geral

**Mensagens agendadas** permitem preparar agora um envio que acontecerá depois na mesma conversa. O
módulo aceita uma mensagem única, uma sequência e recorrências no fuso escolhido. Ele usa o mesmo
conteúdo e as mesmas validações de canal do envio imediato.

O recurso é diferente de:

- **Campanhas**, que distribuem conteúdo para uma audiência ou vários contatos.
- **Follow-up**, que automatiza uma cadência de acompanhamento e suas condições.
- **Agenda**, que gerencia compromissos. Uma mensagem agendada não cria nem altera um compromisso.

## Pré-requisitos

- Recurso **Mensagens agendadas** habilitado na conta.
- Uma conversa existente e um canal apto a enviar o conteúdo.
- Agentes criam e gerenciam os próprios agendamentos. Para gerenciar os de outras pessoas ou alterar
  políticas da conta/inbox, é preciso ser administrador ou ter a permissão **Gerenciar mensagens
  agendadas**.
- Antes da primeira publicação, um administrador deve completar as políticas da conta.

## Passo a passo

1. Abra uma conversa e escreva a mensagem normalmente.
2. Ao lado de **Enviar**, no cabeçalho da conversa ou no painel lateral direito, abra o ícone de calendário
   e escolha **Agendar uma vez**, **Agendar uma sequência** ou **Agendar mensagens recorrentes**. O
   clique principal de **Enviar** continua enviando imediatamente.
3. Informe nome, data e hora. O fuso já vem preenchido com o fuso das **Configurações de agendamento
   de mensagens** (o da caixa, se ela tiver um próprio; senão o de **Padrões da conta**) e pode ser
   trocado pela busca de cidade; os atalhos de horário usam esse fuso. Em cada mensagem, escreva o
   texto, arraste uma mídia/arquivo ou abra o compositor de interativos e templates disponível para o
   canal. Em sequências, ordene os itens e defina o intervalo de cada um.
4. Em recorrências, escolha a frequência e um término: sem término, até uma data ou por quantidade.
   Para um padrão especial, abra **Configuração avançada** e comece por um dos exemplos explicados
   antes de editar a regra.
5. Revise a prévia. Ela mostra bloqueios, políticas efetivas, capacidade do canal e as próximas cinco
   ocorrências.
6. Confirme. O rascunho da conversa só é limpo depois que a criação for aceita.
7. Para acompanhar tudo, abra **Mensagens agendadas** no menu principal. Para a conversa atual, use a
   bandeja **Mensagens agendadas** no painel lateral.

> Captura sugerida: botão dividido de envio, diálogo de prévia e módulo global com o detalhe aberto.

## Configurações & opções

Na tela **Mensagens agendadas → Configurações**, selecione **Padrões da conta** ou **Uma caixa
específica**. Em uma conta nova, use **Aplicar configuração recomendada** para preencher uma base
segura e revise somente as exceções. As políticas ficam agrupadas por objetivo e podem ser buscadas
pelo nome. Em cada política da caixa, escolha **Usar padrão da conta** ou **Personalizar nesta
caixa**. Contadores mostram políticas personalizadas, herdadas e pendentes antes de salvar. O fuso de
uma caixa também pode ser herdado: abaixo do campo aparece se ele vem dos padrões da conta ou é próprio
da caixa, e **Voltar a herdar da conta** desfaz o fuso próprio.

As políticas controlam resposta do cliente, conversa resolvida, atraso de execução, tentativas após
falha, retomada, horário silencioso, sobreposição, troca de Inbox, remetente, variáveis, horário de
verão e limites de materialização/recuperação. A origem de cada valor fica visível. Se outra pessoa
salvar primeiro, recarregue a versão atual antes de repetir a alteração.

No detalhe de um agendamento você pode pausar, retomar, cancelar, arquivar, tentar novamente ou
reconciliar um resultado incerto. Em uma ocorrência é possível reagendar, pular, enviar agora ou
repetir. Sempre confirme o escopo: apenas esta ocorrência, esta e as próximas, ou todas as futuras.

Em **Editar agendamento** você altera o nome, o horário e o texto de cada mensagem de texto simples.
Os anexos dessa mensagem são mantidos. Ao salvar, uma nova versão é publicada e vale para os próximos
envios; o que já foi enviado não muda e o fuso publicado é preservado. Um agendamento pausado continua
pausado depois de editado. Agendamentos cancelados, concluídos ou arquivados não podem ser editados.
O texto é editado como texto simples, exatamente como será enviado. Uma mensagem com conteúdo
interativo, template ou vários blocos aparece somente para leitura: para trocá-la, cancele o
agendamento e crie um novo.

### Ações em lote

Marque agendamentos individuais ou use **Selecionar esta página**, no computador ou celular. Use
**Selecionar agendamentos filtrados (até 100)** para incluir registros de outras páginas com os filtros
atuais. A seleção é mantida ao mudar de página ou abrir um agendamento; alterar um filtro ou aba limpa
a seleção. Você pode selecionar apenas os agendamentos que tem permissão para gerenciar, exceto
rascunhos e arquivados. O limite é de 100 por ação, com aviso quando os resultados excedem esse limite.

O menu oferece somente ações compatíveis com todos os selecionados: pausar ativos, retomar pausados,
cancelar ativos/pausados/precisando de atenção ou arquivar esses estados e também concluídos/cancelados.
Retomar, cancelar e arquivar exigem confirmação. **Retomar** aplica a política publicada de cada
agendamento, que pode enviar mensagens vencidas, ignorá-las ou alterar suas datas; confira as
políticas individuais antes de confirmar. **Arquivar** cancela os envios pendentes, retira os
agendamentos das visões ativas e preserva o histórico.

Aguarde o término da operação antes de alterar a seleção. Se um agendamento mudou ou uma mensagem já
está em envio, toda a operação em lote é recusada. Use **Recarregar**, selecione novamente os
agendamentos e revise a ação; recarregar nunca repete a operação automaticamente. Limpe a seleção
durante uma busca de agendamentos filtrados para descartar o resultado pendente. Se a conexão falhar
antes da confirmação, o resultado é incerto: recarregue e confira os agendamentos antes de aplicar
outra ação.

### Mídias e conteúdo interativo

No próprio diálogo de agendamento, use **Escolher da biblioteca** para reaproveitar uma mídia da
conta, **Enviar do dispositivo** para um arquivo novo, ou arraste imagens, vídeos, áudios e documentos
para a mensagem. As opções acompanham a conversa: WhatsApp Cloud mostra **Templates e interativos
Cloud**; WhatsApp Web mostra **Interativo WhatsApp Web**; uma conversa em Coexistência mostra os dois
compositores, claramente separados. Outros canais não recebem ações incompatíveis. Templates de
conteúdo também encaminham ao compositor nativo quando o canal oferece esse recurso. Ao aplicar, a
prévia mantém o tipo e o conteúdo visíveis e oferece **Editar** ou **Substituir** no compositor nativo,
sem perder nome, data, fuso, recorrência ou políticas. Em uma sequência, **Duplicar
mensagem** copia o conteúdo completo; os detalhes técnicos ficam recolhidos por padrão.

Ao usar **Agendar novamente** em uma mensagem já enviada, o agendamento envia cada campo copiado exatamente como ele foi enviado: um trecho como `{{ contact.name }}` que esteja nessa mensagem segue como texto e não é resolvido como variável. Isso vale campo a campo (o texto, o corpo HTML de um e-mail, cada parâmetro de template): se você editar um deles no agendamento, só o campo editado passa a ter as variáveis resolvidas, e os que você não alterou continuam indo como foram copiados.

O campo que você edita é tratado por inteiro como texto seu. Se ele ainda contiver um `{{ ... }}` que veio da mensagem original, esse trecho também será resolvido como variável no envio. Antes de salvar, apague ou reescreva o que não deve ser interpretado.

No detalhe, expanda **Políticas da mensagem** para consultar os valores publicados e a origem de cada configuração. Ao retomar, a confirmação mostra o comportamento publicado da primeira mensagem, que define a retomada do agendamento; essa ação não troca a política publicada. Para usar outro comportamento, ajuste **Retomar envios vencidos** em **Configurações de agendamento de mensagens** (conta ou caixa); um agendamento já publicado adota o novo valor depois de ser editado e salvo, a menos que o agendamento ou a mensagem tenha um valor próprio. Se a política publicada não estiver disponível, o botão **Retomar** fica desabilitado e explica o motivo logo abaixo.

Em **Mensagens agendadas**, a busca consulta somente o nome do agendamento; ela não busca contatos nem o conteúdo da mensagem. Use o filtro compacto de status para uma visão rápida e abra **Mais filtros** para combinar caixa de origem, canal, criador, responsável atual, número público da conversa e período de próximo envio. Cada seletor mantém o nome do campo visível, por isso criador e responsável atual continuam distintos mesmo quando mostram a mesma pessoa. Os seletores de caixa e pessoas usam as opções disponíveis para sua conta. Se o carregamento dessas opções falhar, escolha **Tentar opções novamente**; um ID válido de um link salvo continua selecionado como indisponível em vez de ser removido.

O campo de conversa é o número público exibido na caixa de entrada, não um ID de contato. Ele e os IDs de caixa, criador e responsável aceitam apenas números inteiros maiores que zero. IDs ou datas inválidos, ou um período que termina antes de começar, são destacados e não recarregam a lista até serem corrigidos ou limpos. Limites salvos de próximo envio são comparados no instante exato, inclusive em microssegundos.

As alterações no formulário de filtros são rascunhos até você escolher **Aplicar filtros**. A contagem do resultado e os chips removíveis descrevem os filtros já aplicados na URL. Se um link salvo tem um filtro inválido e você o corrige, os resultados ficam ocultos até aplicar essa correção; conclua antes qualquer ajuste ainda destacado. Um rascunho permanece ao trocar de aba ou página; fechar o painel de filtros móvel sem aplicar restaura os valores da URL. Remover um chip remove somente aquele filtro aplicado; **Limpar filtros** mantém a aba atual e outras configurações do link. O período de próximo envio filtra a próxima ocorrência do agendamento, e não sua data de criação. Os limites inclusivos do dia usam o fuso da conta, inclusive nas transições de horário de verão. Se um link salvo preservar um horário mais restrito que o dia exibido, escolha **Usar o dia selecionado** naquele limite para substituir intencionalmente apenas esse limite pelo dia completo.


### Eventos do WhatsApp via aparelho

No compositor de interativos, abra **Evento**, preencha nome, descrição e horário do evento, e escolha uma opção de agendamento no menu ao lado de **Enviar**. O horário do agendamento controla quando o convite será enviado; início e término do evento continuam sendo os horários do encontro. Confira ambos na prévia. O evento mantém seu conteúdo nativo no envio agendado. Uma ocorrência em **Requer atenção** não é confirmação de envio: confira seu estado antes de tentar novamente, para evitar duplicações.

## Casos de uso

- Confirmar um retorno combinado com o cliente para amanhã.
- Enviar uma sequência curta de instruções no mesmo atendimento.
- Repetir um lembrete semanal sem criar uma campanha.
- Programar um template aprovado para quando a janela do WhatsApp exigir esse formato.

## Dicas, limites e boas práticas

- O alvo é sempre **uma conversa existente**; o módulo não aceita audiência, segmento ou vários
  contatos.
- Até 500 ocorrências por agenda são materializadas em uma janela de 30 dias. O restante é criado
  progressivamente.
- Anexos ficam vinculados ao agendamento. Não apague o arquivo de origem enquanto houver envios
  futuros.
- O canal é validado na prévia e novamente no vencimento. Desconexão, opt-out, janela fechada,
  template não aprovado ou permissão removida podem bloquear o envio depois da criação.
- Notificações são de exceção: falha ou estado **Requer atenção**. Um agendamento normal não gera
  alerta a cada ocorrência.
- Um efeito externo incerto nunca é repetido às cegas. Use **Reconciliar** depois de verificar o
  provedor.

## Solução de problemas

- **Não vejo a opção de agendar**: confirme a feature da conta e sua permissão.
- **A prévia mostra política incompleta**: um administrador precisa completar a configuração da
  conta ou o valor ausente no escopo indicado.
- **O canal aparece bloqueado**: abra o detalhe do bloqueio e corrija conexão, janela, template,
  anexo, opt-out ou acesso do remetente.
- **Recebi conflito ao salvar ou executar uma ação**: alguém ou um job alterou o registro. Recarregue
  o detalhe e repita a intenção sobre a versão atual.
- **O diálogo mostra outro fuso, como UTC**: confira o fuso em **Mensagens agendadas →
  Configurações** (conta e caixa) e salve. Um agendamento já existente mantém o fuso com que foi
  publicado.
- **A ocorrência está em Requer atenção**: confirme no provedor se houve envio e use
  **Reconciliar → Enviado, Falhou ou Cancelado**.

## Veja também

- [API e MCP de mensagens agendadas](/hc/ajuda/articles/api-developers-mensagens-agendadas-api-mcp-pt-br)
- [Entrega de lembretes por WhatsApp e e-mail](/hc/ajuda/articles/calendar-scheduling-entrega-por-whatsapp-e-email-pt-br)
- [Referência da API (Swagger/OpenAPI)](/hc/ajuda/articles/api-developers-swagger-reference-pt-br)