Personalização com IA

A personalização com IA adiciona duas variáveis aos seus templates de email — `{{ai_hook}}` (uma abertura curta e baseada em curiosidade) e `{{ai_subject}}` (uma linha de assunto). Ambas são escritas por um LLM a partir dos dados do próprio site do lead, no idioma em que envia. Cada geração nova custa 6 crédito; acertos de cache e falhas nunca são cobrados. A funcionalidade está **desativada por padrão** para todos os clientes — ative-a nas definições antes que as sequências possam usar as variáveis.

Na plataforma de email, abra **Definições → Geral → Personalização com IA** e ative **Ativar variáveis de email geradas por IA**. O interruptor é guardado por cliente; a próxima sequência que lançar com `{{ai_hook}}` ou `{{ai_subject}}` em qualquer passo executará a geração. Até ativá-la, sequências com variáveis IA continuam a enviar — apenas substituem através dos fallbacks do seu template (ver secção formato e fallbacks abaixo).

Abra qualquer passo de sequência no editor. No editor de corpo/assunto, clique no seletor de variáveis (`{{ ... }}`) — sob a categoria **IA** verá **AI Hook** e **AI Subject Line**. Coloque-as onde se encaixam no seu texto: ``` Assunto: {{ai_subject}} Olá {{first_name}}, {{ai_hook}} — queria perguntar se viu como {{company_name}} se posiciona para… ``` O mesmo **toggle de IA por passo** no editor de passo (ao lado do seletor de variáveis) controla se os destinatários *desse* passo recebem uma geração nova. Desligado → valores existentes são reutilizados se presentes; caso contrário, o fallback do template substitui.

A geração **arranca ao lançar a sequência**, tal como os cold reports. No momento em que lança uma sequência com o opt-in ativo e um passo IA ativado, cada destinatário elegível é colocado na fila — contactos com bounce duro são saltados automaticamente. A frota de workers gera em segundo plano e escreve os valores num armazenamento por lead; ao enviar, é puxado o valor mais recente. Uma geração típica demora ~3 segundos por lead; um lançamento de 500 leads termina muito antes do email 1 estar agendado para sair. A UI de progresso na sequência mostra os contadores em fila/concluídos e um botão de cancelar se mudar de ideias.

Cada geração bem-sucedida de `ai_hook` ou `ai_subject` custa **6 crédito**. A card de pré-visualização de custo no diálogo de lançamento de sequência mostra o total estimado antes de confirmar, para que veja exatamente quanto lhe custará um lançamento de 500 leads. Acertos de cache — geração repetida para o mesmo lead dentro da janela de cache — e qualquer geração que falhe nas guardas de formato ou na chamada LLM custam **zero créditos**. O painel de faturação separa gastos IA por tipo de variável para acompanhar utilização por campanha.

Cada hook é verificado contra o formato antes de ser guardado: contagem de palavras, sem aberturas spam, sem estatísticas inventadas, deve referenciar algo que o LLM viu efetivamente no site do lead. Gerações que falham nas guardas são descartadas (grátis) e a cadeia de substituição assume. A cadeia é: 1. O valor IA guardado (da última geração bem-sucedida). 2. O fallback por template em `variable_fallbacks` se definiu um (ex. `{{ai_hook|default:"queria contactar"}}`). 3. Uma substituição vazia que deixa o texto envolvente limpo. Nenhum token `{{ai_hook}}` ou `{{ai_subject}}` chega alguma vez a um destinatário — se todas as camadas falharem, a variável torna-se espaço vazio e o resto da sua cópia mantém-se por si.

**"A minha sequência foi lançada mas os destinatários receberam campos IA vazios."** Verifique se o interruptor opt-in está ativo (Definições → Geral → Personalização com IA). Sem ele, a geração é saltada e a cadeia de fallback corre. **"Alguns destinatários têm hooks e outros não."** Destinatários que tiveram bounce duro previamente são saltados automaticamente ao lançar. Destinatários sem dados de domínio scrapaveis (LinkedIn privado, domínios estacionados) caem na cadeia de fallback. **"Quero cancelar a meio do lançamento."** A UI de progresso na sequência tem um botão de cancelar; gerações em voo terminam, em fila não disparam. **"Como sei qual valor foi usado?"** O painel de faturação mostra entradas por geração com o tipo de variável. O log de envios mostra o corpo de email renderizado, para que compare gerado vs enviado. Para qualquer coisa não coberta aqui, contacte o suporte a partir do hub de ajuda.