Coletar leads

Como configurar uma automacao para pedir email, telefone e follow antes de entregar o link, usando a maquina de estados do lead-collector.

"Coletar lead" transforma uma automacao simples em um funil guiado. Em vez de mandar o link imediatamente, o UltronChat pede email, telefone ou follow antes — e so libera o conteudo quando o usuario responder.

O que voce pode coletar

No formulario da automacao:

Collect email — pede o email do usuario; valida formato.
Collect phone — pede o telefone; valida formato (BR).
Require follow — verifica via API se o usuario segue sua conta; pede para seguir se nao esta seguindo.

Voce pode marcar qualquer combinacao das tres — inclusive so uma.

Como a maquina de estados funciona

Quando o gatilho aciona e collect_email = true, por exemplo, o UltronChat cria uma lead session com:

automation_id, connection_id, platform_user_id
current_state = 'waiting_email'
expires_at = now + 24h

E envia a mensagem de introducao (que voce configura) pedindo o email.

A partir dai o bot ignora o agente de IA normal e assume a conversa ate completar o fluxo.

Diagrama de estados

[started]
  │ envia mensagem introducao + primeira pergunta
  ▼
[waiting_email]   (se collect_email)
  │ valida email
  │ 3 tentativas
  ▼
[waiting_phone]   (se collect_phone)
  │ valida phone
  │ 3 tentativas
  ▼
[waiting_follow]  (se require_follow)
  │ chama API para checar seguidor
  │ pede p/ seguir se nao segue
  ▼
[completed] → envia mensagem de sucesso + link

Se em qualquer etapa o usuario:

Responde algo invalido — o bot envia uma mensagem de "tentar de novo" (configuravel) e permanece no mesmo estado. Maximo 3 tentativas por etapa; depois marca como abandoned.
Nao responde em 24h — sessao expira e vira abandoned.
Desiste no meio — sessao permanece ate expirar; lead final fica como partial (so com dados coletados ate entao) se atingiu pelo menos uma etapa.

Mensagens que voce controla

Para cada etapa existe uma mensagem configuravel. Veja Mensagens personalizadas para detalhes:

msg_intro_dm — primeira mensagem no direct apos o comentario.
msg_ask_email — pergunta do email.
msg_ask_phone — pergunta do telefone.
msg_ask_follow — pede para seguir.
msg_invalid_email — mensagem quando o email digitado nao e valido.
msg_invalid_phone — idem para telefone.
msg_waiting_follow — enquanto checa se seguiu.
msg_success — mensagem final, com o link/conteudo prometido.

Lead final

Quando a sessao chega a completed, o UltronChat:

Cria um registro em leads com status:
- complete — se todos os dados configurados foram coletados com sucesso.
- partial — se alguma etapa foi pulada (por ex. a pessoa seguiu mas nao mandou email valido).
Envia a msg_success.
Grava automation_logs.status = success.

O lead aparece em /dashboard/[connectionId]/leads imediatamente. Veja Exportar leads em CSV (em breve).

Exemplo — automacao de ebook com email + follow

Gatilho: contains, keywords [ebook, quero]
Aplica a todos os posts

Responder comentario: ✓
  Variacoes: ["Te mandei no direct!", "Chegou por DM!"]

Enviar DM: ✓
Collect email: ✓
Collect phone: ✗
Require follow: ✓ (Instagram)

msg_intro_dm: "Oi! Para receber o ebook, preciso de duas informacoes:"
msg_ask_email: "Qual e o seu melhor email?"
msg_invalid_email: "Hmm, esse email nao parece valido. Tenta de novo?"
msg_ask_follow: "Quase la! Antes, de um follow na nossa conta: @suaconta"
msg_success: "Valeu! Aqui esta seu ebook: https://exemplo.com/ebook"

Quando NAO usar coleta

Se voce quer entregar o conteudo imediatamente com friccao zero (campanhas onde conversao > qualificacao).
Se voce nao tem uma sequencia de email/CRM para aproveitar os dados (coletar sem plano e desperdicio).

Proximo passo

Mensagens personalizadas — configurar cada texto da maquina de estados.