---
title: Follow-ups
description: Biblioteca de grupos de cadência de reengajamento — organize sequências ordenadas de mensagens automáticas em grupos, agende pelo funil, por um fluxo ou manualmente no chat, com todas as guardas de bom senso já embutidas.
---

# Follow-ups

Todo lead que some no meio de uma negociação é uma venda em risco. Os **Follow-ups** são uma biblioteca de grupos de cadência de mensagens automáticas de reengajamento: você cria um grupo com uma sequência ordenada de passos ("Primeiro, após 6 horas: 'ainda tem interesse?'", "Depois, após 1 dia: 'vou aproveitar pra trazer mais uma opção'"), define o delay e o conteúdo de cada passo, e a plataforma cuida de agendar, disparar e cancelar toda a sequência sozinha — respeitando horário comercial, janela do WhatsApp, se o lead já respondeu e se a conversa está sob um humano.

<Secao icon="info">Para que serve</Secao>

- Reengajar leads que pararam de responder, sem depender de alguém lembrar de fazer isso manualmente.
- Reaproveitar o mesmo texto de follow-up em vários funis e fluxos diferentes, em vez de reescrever a mesma mensagem em cada lugar.
- Agendar um lembrete manual em uma conversa específica, direto do chat.

---

## Biblioteca de Grupos

Grupos de follow-ups vivem em uma tela própria da plataforma (**Follow-ups**), fora do Agent Builder — é uma biblioteca do workspace inteiro, não presa a um único agent ou pipeline. Cada grupo contém:

| Campo | O que é |
|---|---|
| Nome | Identifica o grupo na biblioteca e nas listas de uso |
| Ativo | Grupos inativos não disparam, mesmo que já estejam vinculados a etapas ou fluxos |
| Steps (sequência) | Lista ordenada e reordenável de passos automáticos; cada passo tem: |
|  | • **Atraso** — quanto tempo depois da âncora (última mensagem do lead) o passo dispara — número + unidade (minutos, horas ou dias); atraso 0 dispara imediatamente na próxima verificação automática (até 1 minuto) e é exibido como "Imediato" na UI |
|  | • **Conteúdo** — o texto enviado, até 500 caracteres, com botões para inserir <code v-pre>{{nome}}</code> e <code v-pre>{{primeiro_nome}}</code> |
|  | • **Horário de Trabalho** — opcional — vincula o disparo desse passo específico a um horário comercial já cadastrado na plataforma |
|  | • **Resolver conversa após envio** — fecha a conversa automaticamente assim que esse passo é enviado |

A tela lista, para cada grupo, onde ele está em uso (etapas de funil, fluxos, quantas conversas ativas têm agendamentos dele no momento) — assim você enxerga o impacto antes de editar ou desativar um grupo compartilhado. Criar ou editar o grupo é feito em um painel deslizante que permite reordenar os steps dentro do grupo.

## Os 3 contextos de uso

O mesmo grupo de follow-ups da biblioteca pode ser agendado de três formas diferentes:

1. **Pelo funil (Jornada do Lead)** — vinculado a uma ou mais etapas do pipeline, direto no mapa da jornada (beads com botão de vincular/desvincular por etapa) ou pelo campo de etapas no formulário do grupo; quando o lead entra naquela etapa e some, toda a sequência de steps do grupo é agendada automaticamente. Veja [Jornada do Lead](/guia/agents/jornada-do-lead#vincular-grupos-de-follow-up-pelo-mapa).
2. **Por um fluxo (Flow Builder)** — o nó [Agendar Follow-up](/guia/flow-builder/jornada-do-lead/agendar-follow-up) (`flow.follow_up.schedule`), na seção **Jornada do lead** da paleta, agenda um grupo da biblioteca em qualquer ponto de um fluxo, independente de funil. Fluxos antigos que já disparavam esse agendamento pela Ação na Plataforma genérica continuam funcionando.
3. **Manualmente no chat** — o atendente agenda um grupo de follow-ups para aquela conversa específica, pelo popover **Agendar follow-up** na barra de ações; a tela mostra uma prévia da cadência inteira.

## Cadência e âncora

Quando um grupo é agendado, toda a sua sequência de steps é "ancorada" à **última mensagem do lead** na conversa — nunca a última mensagem enviada pela plataforma. Um primeiro passo com "6 horas" significa 6 horas depois de o lead ter escrito pela última vez; um segundo passo com "1 dia" significa 1 dia depois dessa mesma âncora, não depois do primeiro passo. Um passo com atraso 0 ("Imediato") dispara na próxima verificação automática a partir dessa mesma âncora, dentro de até 1 minuto. Essa âncora é a mesma para todos os steps do grupo até que o lead responda.

Assim que o lead responde, a sequência inteira do grupo é reancorrada àquela nova mensagem dele: os steps ainda não disparados terão seus delays recalculados a partir dessa nova última mensagem. Isso garante que a cadência se adapta naturalmente ao ritmo da conversa — se o lead responde no meio do grupo, os próximos passos "reiniciam" a partir dessa resposta.

## Guardas antes de cada disparo

Antes de enviar qualquer passo do grupo, a plataforma revalida um conjunto de condições — nada é dado como certo no momento em que o grupo foi agendado, porque muita coisa pode mudar até a hora do envio:

- **O grupo ainda está ativo?** Se o grupo foi desativado ou excluído depois de ser agendado, os passos pendentes não disparam — o agendamento é silenciosamente cancelado no momento do disparo.
- **O lead já respondeu?** Se respondeu após a âncora atual, o step não dispara (a sequência já foi reancorrada por essa resposta).
- **A etapa mudou?** No caso de grupos vinculados a uma etapa do funil, se o lead já saiu daquela etapa, os disparos dos passos desse agendamento são ignorados — a mudança de etapa já cria o agendamento correto para a nova etapa, se houver um grupo vinculado a ela.
- **A conversa está aberta e sem um humano no comando?** Conversa fechada não recebe passos do grupo; se um atendente assumiu a conversa (Modo Atenção) e a opção "pausar follow-ups com humano" está ativa no funil, todos os agendamentos pendentes ficam **suspensos** — não disparam enquanto a conversa estiver em Modo Atenção. Quando o humano devolve a conversa à automação, os agendamentos voltam a estar **ativos**; se o horário de disparo já tiver passado durante a pausa, o passo dispara imediatamente (sem reancoragem, apenas seguindo seu atraso original a partir da âncora antes da pausa).
- **A assinatura do workspace está em dia?** Sem plano pago ativo, os passos ficam suspensos — sem perder o progresso, retomam automaticamente quando a assinatura volta a ficar em dia.
- **A janela de 24 horas do WhatsApp está aberta?** Se estiver fechada, esse envio específico é pulado (sem template aprovado, a mensagem não sai) e a sequência segue adiante normalmente para o próximo passo.
- **Está dentro do Horário de Trabalho configurado para esse passo?** Fora do horário, o envio é **adiado** para o próximo horário aberto — sem pular o passo da cadência, só empurrando o horário do disparo.

Se você editar um grupo depois de ele já estar agendado para alguém, a mudança vale automaticamente — o conteúdo de cada passo é sempre recarregado no momento do seu disparo, não fica "congelado" no instante em que o grupo foi agendado. Se desativar o grupo, os passos pendentes não disparam.

## Uso no chat

Na tela de Conversas, o botão **Agendar follow-up** na barra de ações abre um popover: você escolhe um grupo da biblioteca, e a tela mostra uma prévia da cadência inteira (todos os passos do grupo em sequência). Após confirmar, a conversa exibe um indicador do agendamento (ex.: "Grupo agendado - próximo passo em 1 dia") com a opção de cancelar manualmente a qualquer momento — ao cancelar, todos os passos pendentes do grupo são cancelados. Como em qualquer outro contexto, o grupo também é cancelado automaticamente se o lead responder antes.

<Dica>

O vínculo entre um grupo e uma etapa do funil é sempre explícito — não existe aplicação automática por categoria. Só dispara follow-up a etapa que tem um grupo vinculado a ela; uma etapa sem vínculo não recebe nenhum follow-up pelo funil, mesmo sendo uma etapa da categoria `principal`. Um grupo sem nenhuma etapa vinculada simplesmente não roda pelo funil, mas continua disponível para uso nos outros dois contextos: agendamento manual no chat e pelo nó [Agendar Follow-up](/guia/flow-builder/jornada-do-lead/agendar-follow-up) no Flow Builder.

</Dica>

<Cuidado>

O tipo de conteúdo disponível na v1 é apenas texto simples. Follow-ups com mídia ou template estão fora do escopo atual.

</Cuidado>

---

<Secao icon="circle-check">Exemplo</Secao>

Um grupo chamado "Proposta sem resposta" é criado com dois passos:
1. **Passo 1** — Atraso: 6 horas, Conteúdo: "Olá <code v-pre>{{primeiro_nome}}</code>, ainda tem interesse na proposta que te enviei?"
2. **Passo 2** — Atraso: 1 dia, Conteúdo: "Aproveito pra deixar mais uma opção que discutimos — dá um toque se quiser conversar?"

O grupo é vinculado à etapa "Proposta enviada" do funil de vendas:

1. O lead recebe a proposta e para de responder.
2. 6 horas depois da última mensagem dele, se a conversa ainda estiver aberta, sem humano no comando, dentro da janela do WhatsApp e do horário de trabalho, o primeiro passo é enviado automaticamente.
3. Se o lead responder a qualquer momento durante os próximos passos, a sequência inteira é cancelada/reancorrada — não faz sentido mandar o segundo passo para quem respondeu ao primeiro.
4. Se a sequência não for interrompida, 1 dia depois da última mensagem do lead o segundo passo é enviado.
5. Se o lead responder "sim, ainda quero" depois de qualquer passo, o agent retoma a conversa normalmente a partir da instrução da etapa atual.

## Saiba mais

- [Jornada do Lead](/guia/agents/jornada-do-lead) — vincule grupos de follow-ups a etapas do funil
- [Nó Agendar Follow-up](/guia/flow-builder/jornada-do-lead/agendar-follow-up) — agende um grupo de follow-ups a partir de um fluxo
- [Controle da IA no chat](/guia/atendimento/controle-da-ia-no-chat) — como o Modo Atenção pausa a IA (e os agendamentos) quando um humano assume
