Pular para o conteúdo principal

O que é Follow-up?

Follow-up é um sistema de reengajamento automático que envia mensagens para leads após um período de inatividade. Cada assistente pode ter sua própria configuração de follow-up.

Follow-up com IA

A IA gera a mensagem automaticamente baseada no contexto da conversa e no prompt configurado.

Follow-up com Template

Para intervalos acima de 24h, utiliza templates oficiais do WhatsApp Business (Meta/Gupshup).

Como funciona

1

Gatilho por Status

O follow-up é ativado quando o lead muda para um dos status configurados em trigger_status_ids.
2

Aguarda Intervalo

O sistema aguarda o intervalo definido no step (ex: 30 minutos, 2 horas, 1 dia).
3

Envia Mensagem

Dependendo do intervalo: gera com IA (< 24h) ou envia template oficial (>= 24h).
4

Avança Steps

Se o lead não responder, avança para o próximo step até completar todos (máx. 3 steps).

Modelo do Follow-up Config

{
  "id": "uuid",
  "tenant_id": "uuid",
  "assistant_id": "uuid",
  "trigger_status_ids": ["uuid-status-1", "uuid-status-2"],
  "steps": [
    {
      "interval": "PT30M",
      "prompt": "Envie uma mensagem amigável perguntando se o lead precisa de ajuda"
    },
    {
      "interval": "PT2H",
      "prompt": "Reforce o valor do produto e ofereça uma demonstração"
    }
  ],
  "official_steps": [
    {
      "channel_id": "uuid",
      "channel_name": "WhatsApp Business",
      "app_id": "gupshup_app_12345",
      "steps": [
        {
          "interval": "P1D",
          "template_name": "reengajamento_v1",
          "template_language": "pt_BR",
          "template_params": ["{{LEAD_FIRSTNAME}}", "Leavo"]
        }
      ]
    }
  ],
  "is_active": true,
  "created_at": "2024-01-15T10:00:00Z"
}

Formato de Intervalo (ISO 8601)

IntervaloFormatoDescrição
30 minutosPT30MMínimo permitido
2 horasPT2H
1 dia e 12 horasP1DT12H
1 diaP1DRequer template oficial
1 semanaP1WRequer template oficial
Steps com intervalo >= 24 horas devem obrigatoriamente ter template_name configurado, pois a janela de conversa do WhatsApp exige templates aprovados.

Regras

  • Máximo de 3 steps por configuração
  • Intervalo mínimo de 30 minutos por step
  • Uma configuração por assistente (único)
  • Cada canal oficial pode ter seus próprios steps com templates