--- title: Agendar Follow-up description: Agende, a partir de qualquer ponto de um fluxo, um grupo de follow-ups da biblioteca para a conversa em execução. --- # Agendar Follow-up · `flow.follow_up.schedule` Para que serve É a versão "por fluxo" do agendamento de grupos de follow-up: em vez de vincular uma cadência de reengajamento a uma etapa do funil, você agenda um grupo da [biblioteca](/guia/atendimento/follow-ups) em qualquer ponto de um fluxo do Flow Builder — independente de o contato estar ou não em uma Jornada do Lead. O disparo, as guardas, a reancoragem por resposta e o cancelamento são exatamente os mesmos do agendamento pelo funil ou pelo chat; só muda o gatilho que dispara o agendamento. Este nó **não pausa o fluxo**. Ele só agenda a cadência — a execução do fluxo segue imediatamente para o próximo nó, sem esperar nenhum passo do grupo ser enviado. Tem uma única saída, sem ramificações; `scheduled` e `next_run_at` são variáveis preenchidas nessa mesma saída, não caminhos diferentes do fluxo. Quando usar - Um fluxo de captação encaminha o lead para um vendedor e você quer garantir uma cadência automática de lembretes caso ele não responda. - Um fluxo faz uma pergunta e você quer reengajar quem não respondeu com uma sequência de mensagens, sem esperar o lead entrar em um funil formal. - Você já tem grupos de follow-ups cadastrados na biblioteca e quer reusá-los em fluxos, sem reescrever a sequência em nós Enviar Mensagem com Delay. --- Passo a passo Arraste o nó **Agendar Follow-up** para o canvas, na seção **Jornada do lead** da paleta.
 No painel, escolha o **Grupo de follow-up** desejado na lista da biblioteca do workspace. (Opcional) Em **Esperar quanto tempo?**, defina um tempo de espera para a primeira mensagem, diferente do padrão cadastrado no primeiro passo do grupo. Use 0 para disparo imediato no próximo ciclo de sweep. Os demais passos mantêm seus delays originais. (Opcional) Escolha a **Unidade de tempo** (minutos, horas ou dias) — só se aplica junto com o tempo de espera acima. Salve e conecte a única saída ao próximo nó do fluxo — o agendamento não interrompe a execução. Campos | Campo | O que faz | Obrigatório | |-------|-----------|-------------| | Grupo de follow-up | Qual cadência da biblioteca disparar para o contato da conversa atual | Sim | | Esperar quanto tempo? | Substitui o tempo de espera padrão do **primeiro passo** do grupo só para este agendamento. Use 0 para disparo imediato. Os demais passos mantêm seus tempos de espera originais. | Não | | Unidade de tempo | Minutos, horas ou dias — usada junto com o tempo de espera acima | Não | A conversa e o contato **não são informados por você** — vêm automaticamente do contexto de execução do fluxo. O nó precisa executar dentro de um fluxo que tenha um **contato e uma conversa** associados, sem isso não há para quem agendar o grupo. A contagem do tempo de espera começa a partir da **última mensagem do lead**, do mesmo jeito que qualquer outro agendamento de follow-up (veja [Follow-ups → Cadência e âncora](/guia/atendimento/follow-ups#cadencia-e-ancora)). O grupo envia 1 mensagem por passo ativo da cadência. ## Saídas Uma única saída, preenchida com estas variáveis: | Variável | Conteúdo | |----------|----------| | `scheduled` | Booleano — `true` quando o agendamento foi criado com sucesso | | `next_run_at` | Data/hora prevista do próximo disparo | --- ## O que acontece no disparo O agendamento criado por este nó segue as mesmas regras de qualquer outro grupo: cada passo da sequência é revalidado no momento do seu disparo — horário de trabalho, janela de 24h do WhatsApp, Modo Atenção, assinatura ativa e status do grupo são todos revalidados, não só no momento em que o nó rodou. Veja a lista completa em [Follow-ups → Guardas antes de cada disparo](/guia/atendimento/follow-ups#guardas-antes-de-cada-disparo). Se o primeiro passo tiver o campo **Esperar quanto tempo?** configurado como 0 ("Imediato"), ele dispara na próxima checagem automática do sistema, em até 1 minuto, respeitando todas as guardas acima — nunca instantaneamente. ## Como cancelar Uma resposta do lead cancela/reancora automaticamente a sequência de passos criada por este nó, do mesmo jeito que cancela um grupo agendado pelo funil ou manualmente no chat — não é preciso nenhum nó adicional no fluxo para isso. Se o grupo for desativado ou excluído, os passos pendentes também não disparam. --- Exemplo Um lead entra na etapa "Proposta enviada" de um funil e um fluxo separado (fora da Jornada do Lead) precisa da mesma cadência de reengajamento. Um fluxo de captação de leads pergunta o interesse do contato e, se ele não escolher nenhuma opção, segue para um nó **Agendar Follow-up** com o grupo "Captação sem resposta" (com dois passos: primeiro em 2 horas, segundo em 1 dia): 1. `Enviar Mensagem (Botões)` → pergunta o interesse do lead. 2. `Esperar clique em botão` → aguarda a resposta. 3. Caminho "sem resposta" → `Agendar Follow-up` com Grupo de follow-up = "Captação sem resposta". 4. A execução **não espera** o agendamento — segue direto para o próximo nó do fluxo, que pode encerrar o atendimento ou seguir outro caminho. 5. Se o lead responder a qualquer momento, a sequência é cancelada automaticamente. Caso contrário, o primeiro passo é enviado após 2 horas respeitando horário de trabalho e janela do WhatsApp; o segundo passo é enviado 1 dia depois (reancorando conforme necessário se o lead tiver respondido no meio). Prefira reaproveitar um grupo já cadastrado na biblioteca a montar a sequência com múltiplos nós Delay + Enviar Mensagem: o grupo da biblioteca já vem com cancelamento/reancoragem por resposta, checagem de assinatura, Modo Atenção, horário de trabalho e status do grupo embutidos — uma sequência de Delays comuns não tem nada disso, além de ficar mais complexa de manter. Fluxos criados antes deste nó dedicado que agendavam follow-up pela **Ação na Plataforma** genérica continuam funcionando normalmente — nada quebra, não há migração necessária. Novos fluxos devem usar este nó dedicado. ## Saiba mais - [Follow-ups](/guia/atendimento/follow-ups) — biblioteca de grupos, guardas de disparo e os demais contextos de uso - [Jornada do Lead](/guia/agents/jornada-do-lead) — grupos de follow-ups vinculados a etapas do funil