Skip to main content
Follow-ups automáticos permitem que seus agentes retomem conversas paradas sem intervenção manual. Você define quando e como a retomada acontece — seja após um intervalo de tempo, seja quando um evento específico ocorre — e a plataforma cuida do resto.
Lista de automacoes de follow-up

​
Como funciona

Cada automação de follow-up é composta por três partes: o trigger (o que inicia), a condição (filtro opcional para refinar quando agir) e as ações (o que executar). O engine de automação (automation-engine) avalia as regras continuamente e despacha execuções via automation-dispatcher.
Automações ficam em status draft até você ativá-las explicitamente. Somente automações com status active são avaliadas pelo scheduler.

​
Tipos de trigger disponíveis

TipoQuando dispara
cronEm um horário ou intervalo recorrente (expressão cron)
eventQuando um evento interno ocorre (ex.: conversa sem resposta, contato criado)
webhookQuando um payload HTTP externo chega no endpoint da automação

​
Criando uma automação de follow-up

1

Acesse Automacoes

No menu lateral, clique em Automações. Em seguida, clique em Nova Automação.
2

Defina nome e descricao

Escolha um nome claro para identificar a regra (ex.: “Follow-up 24h sem resposta WhatsApp”).
3

Escolha o tipo de trigger

Selecione cron, event ou webhook e preencha a configuração correspondente. Para follow-ups baseados em tempo, use cron com o intervalo desejado.
4

Adicione condicoes (opcional)

Filtre quais conversas ou contatos devem receber o follow-up — por canal, tag, status ou campo customizado.
5

Configure as acoes

Adicione as ações em sequência: enviar mensagem, atualizar campo do contato, chamar um agente, disparar webhook, etc.
6

Ative a automacao

Altere o status para active e salve. A automação entra em avaliação imediata.

​
Controle de falhas e retentativas

A Timely.ai implementa um mecanismo automático de retry com backoff configurável.
ParâmetroDescrição
max_retriesNúmero máximo de tentativas em caso de falha
retry_delay_secondsIntervalo entre retentativas
max_consecutive_failuresLimite de falhas consecutivas antes de pausar automaticamente
rate_limit_per_hourMáximo de execuções por hora (anti-spam)
rate_limit_per_dayMáximo de execuções por dia
Quando consecutive_failures atinge max_consecutive_failures, a automação é pausada automaticamente e seu status muda para error. Você recebe um alerta e pode revisar os logs antes de reativar.
Automações com status error precisam ser investigadas antes de reativar. Consulte os Automation Runs para identificar o passo que falhou.

​
Monitorando execuções (Automation Runs)

Cada disparo gera um Automation Run com registro completo da execução.

Status do run

pending, running, completed, failed, cancelled

Log por passo

Input, output, duração e erros de cada ação individualmente.

Creditos consumidos

Cada run registra o custo em créditos para controle de uso.

Idempotencia

Runs com a mesma idempotency_key não são executados duas vezes.
Para acessar os runs, abra a automação desejada e clique em Ver execuções. Você pode filtrar por status e carregar mais registros com paginação de 50 por página.
Defina rate_limit_per_day para evitar que uma automação de follow-up envie mensagens em excesso para o mesmo contato em um único dia — especialmente importante para canais como WhatsApp, que têm limites impostos pela Meta.