Um engine é uma conversa projetada como um diagrama. Você o constrói em uma tela a partir de alguns componentes, testa no simulador e depois publica. Esta página cobre cada parte do builder. Se você está chegando agora, dê uma olhada em Personas primeiro — todo engine roda como um persona.

Conceitos fundamentais

Algumas palavras aparecem em todo lugar no builder. Aprenda-as e o resto se encaixa.

Fase — um estágio da conversa. Uma fase é uma mensagem de abertura (como o AI inicia aquele estágio) mais um deck de cards que ele pode jogar enquanto a conversa está nessa fase. Um engine típico tem algumas fases: uma abertura fria, um aquecimento, um convite.
Deck — o conjunto de cards vinculado a uma fase. A cada turno o engine joga um card do deck, escolhido por sorteio aleatório ponderado, para que a mesma fase pareça diferente toda vez.
Card — um único movimento: conversar, fazer uma pergunta, enviar uma foto, soltar um link, encerrar. Cada card tem suas próprias configurações (veja a referência de cards abaixo).
Gate / transição — uma regra que move a conversa de uma fase para outra, ou dispara uma reação. Alguns gates ficam inline entre duas fases; outros flutuam e observam a conversa inteira.
Fato — um detalhe que o engine aprende sobre o lead (nome, cidade, interesses). Fatos são extraídos do chat enquanto acontece e podem ser inseridos de volta nas mensagens com uma tag.
Pontos de início — os nós que indicam onde uma conversa começa: o AI enviando primeiro, o usuário enviando primeiro, ou um evento externo.
Observadores flutuantes — gates que não estão conectados entre duas fases específicas. Eles observam a conversa inteira e disparam sempre que sua condição é atendida (por exemplo, um fato aparece, ou o lead aceita um link).

A tela

O builder é uma tela com zoom de nós conectados por arestas. Você arrasta peças da lateral, solta cards nas fases e desenha linhas para conectar o fluxo.

Paleta de nós

Início — os nós de início de conversa (AI Opener, Chat Recebido, Event Trigger).
Fases — adiciona um novo nó de fase à tela.
Regras — os gates de lógica e observadores que você conecta entre ou ao redor das fases.

Biblioteca de cards

A biblioteca de cards lista todos os tipos de card. Arraste um card para uma fase para adicioná-lo ao deck daquela fase. O mesmo tipo de card pode aparecer em várias fases com configurações diferentes.

Conexão de arestas

Arraste a partir da alça de saída de um nó para outro nó para criar uma aresta. As arestas são como um ponto de início chega à sua primeira fase e como os gates avançam o chat.

Auto-arranjo

Grafos conectados manualmente ficam bagunçados. O botão Auto-arranjo (a varinha mágica, canto superior direito da tela de fluxo) reorganiza todo o grafo em um layout ordenado da esquerda para a direita, sem nós sobrepostos, e ajusta a visualização. As novas posições são salvas quando você salva o engine. Execute isso antes de finalizar qualquer engine.

Tipos de card

Cards são os movimentos que um engine pode fazer dentro de uma fase. Estes são os tipos integrados, pelos nomes da biblioteca:

Bate-papo Casual (CHAT) — mensagem de forma livre. Este é o único card que respeita completamente suas Instruções personalizadas, tornando-o seu carro-chefe para direcionar o texto.
Caçador de Fatos (PROBE) — pergunta pelo próximo fato que está faltando, mirando automaticamente no detalhe que o engine ainda precisa aprender.
Enviar Foto (PHOTO) — envia a foto mais adequada do cofre do persona, escolhida automaticamente pela descrição de cada foto.
Foto de Verificação (VERIFICATION) — pede ao lead que envie uma foto de prova / verificação de si mesmo.
Soltar o Link (LINK_DROP) — solta seu link de funnel. Requer uma URL de funnel definida nas configurações globais.
Encerrar / Fechar (CLOSE) — finaliza e encerra a conversa.
Reagir (REACT), Provocar / Flertar (TEASE), Abrir o Jogo (SHARE), Se Identificar (RELATE) — pequenas jogadas integradas que mantêm a conversa com aparência humana. Veja o aviso abaixo — esses quatro rodam uma linha fixa.

Atenção

React, Tease / Flirt, Open Up e Relate rodam uma linha fixa e integrada e ignoram o campo Instruções. Qualquer coisa que você digitar nesses quatro cards (e quaisquer tags) não é usada. Se precisar de texto personalizado, use um card Bate-papo Casual em vez disso.

Gates e transições

Os gates decidem quando a conversa avança ou reage. Existem dois formatos: contadores inline conectados entre duas fases, e observadores flutuantes que observam o chat inteiro.

Contador inline

Após N Mensagens (MESSAGE_COUNT) — conectado fase → gate → fase. Conta os turnos e avança a conversa assim que um limite é atingido. O limite é 1–20. Esta é a forma padrão de avançar um chat por suas fases.

Observadores flutuantes

Verificador de Fato (FACT_EXISTS) — dispara quando um fato específico foi extraído da conversa.
Verificador de Conversão (CONVERSION_CHECK) — dispara com base em se o lead aceitou ou rejeitou o último link que você soltou.
Detector de Sinal (DETECTOR) — um observador interno que apoia a defesa contra acusações de bot. Não está disponível na paleta; você não o coloca manualmente.

Pontos de início

Todo engine precisa saber como um chat começa. Adicione um ou mais nós de início e conecte cada um à fase onde aquele caminho começa.

AI Opener / Outreach — o AI envia a primeira mensagem (outreach frio). Use isso para funnels proativos.
Chat Recebido / Padrão — o usuário envia primeiro (o DM recebido normal). Um engine deve ter exatamente um início de Chat Recebido / Padrão.
Event Trigger — inicia um chat quando um evento externo específico dispara. Precisa de um id de evento (por exemplo, story_reaction).
Follow-up — reengaja um lead que ficou em silêncio, trazendo-o de volta à conversa.

Atenção

Tags de prompt não são preenchidas no AI Opener. Um {name} digitado no opener seria exibido literalmente ao lead. Escreva o AI Opener com palavras simples e diretas.

Fatos e a aba Conhecimento

A aba Conhecimento é onde você gerencia os fatos que o engine coleta. Existem dois tipos:

Fatos do sistema — detalhes integrados que o engine sempre tenta aprender (como o nome e a localização do lead).
Fatos personalizados — seus próprios campos, específicos para o seu funnel.

Cada fato é atribuído a uma fase — o estágio durante o qual o engine deve tentar aprendê-lo. O card Caçador de Fatos então persegue qualquer fato que ainda esteja faltando para a fase atual.

Atenção

Cada fato pode pertencer a exatamente uma fase. Se quiser que o engine aprenda algo em um estágio diferente, mova o fato — você não pode atribuí-lo a duas fases ao mesmo tempo.

O inspetor de nó

Clique em qualquer nó para abrir o inspetor à direita. O que você pode editar depende do nó, mas os campos comuns são:

Instruções / diretiva — orientação em linguagem simples sobre o que o AI deve fazer. Em um card, orienta a mensagem; em uma fase, é o propósito da fase. (Lembre-se que os quatro cards rápidos ignoram isso.)
Abertura de fase — a mensagem de abertura de uma fase: como o AI inicia a conversa ao entrar naquele estágio.
Peso (1–100) — a probabilidade de um card ser sorteado do seu deck em um determinado turno. Peso maior = jogado com mais frequência.
Limite de uso (0–20) — o número máximo de vezes que um card pode ser jogado em uma conversa. 0 significa ilimitado.
Espera entre usos — quantos turnos aguardar antes que um card possa ser jogado novamente, para que não se repita consecutivamente.

Tags de prompt

Dentro das Instruções de um card você pode digitar uma tag e o engine substitui pelo valor real antes de enviar a mensagem. As tags disponíveis:

Detalhes do persona

{name} — o nome do persona
{age} — a idade do persona
{origin} — de onde o persona é
{city} — a cidade do persona
{job} — o trabalho do persona
{hobbies} — os hobbies e interesses do persona
{bio} — a bio do persona
{style_tags} — os traços de estilo de texto do persona
{time} — a hora atual do dia, para que o persona soe ciente se é manhã ou noite

Seu funnel

{platform} — o app no qual você está enviando mensagens
{funnel_platform} — sua plataforma de funnel ou destino

Ações

{photo} — envia a foto mais adequada do cofre, escolhida automaticamente pela descrição
{link} — solta seu link de conversão, com evasão de filtros aplicada

Específicos do card

{fact} — em um card Caçador de Fatos: o próximo detalhe a descobrir sobre o lead
{vibe} — em um card Enviar Foto: o humor atual da foto, casual ou picante
{context} — em um card de entrada / opener: a primeira mensagem recebida à qual o opener reage

Configurações globais e de identidade

As configurações do engine ficam na aba Identidade / configurações globais:

Plataforma de mensagens — o app no qual a conversa é executada (alimenta a tag {platform} ).
Limite de turnos (1–100, padrão 60) — o número máximo de turnos antes da conversa ser encerrada.
Máximo de bolhas de mensagem (1–5) — quantas bolhas de mensagem separadas uma única resposta pode ter.
Plataforma de funnel — sua plataforma de destino (alimenta {funnel_platform}).
URL do funnel — o link que o card Soltar o Link envia.
Mascaramento de link — aplicado automaticamente para evitar filtros de link quando o link é solto.
Valor de lead — quanto vale um lead convertido, usado pelo analytics para estimar a receita.

Rejeições e defesa anti-bot

Você pode roteirizar como o engine lida com momentos difíceis — um lead resistindo, ou acusando o AI de ser um bot. Cada cenário emparelha um gatilho com uma resposta, que pode ser um texto ou uma imagem, para que a conversa se recupere com naturalidade em vez de travar.

Validação e publicação

O builder verifica seu engine enquanto você trabalha e reporta problemas no painel de Problemas. Dois níveis são importantes:

Erros bloqueiam a publicação. Você não pode publicar um engine que falha na validação.
Apenas erros de limite rígido bloqueiam o Salvamento. Você pode salvar um trabalho em andamento que ainda tem problemas menores e voltar a ele depois.
O painel de Problemas vai direto ao nó quando você clica em um problema, para que você possa corrigi-lo no lugar.

Atenção

Uma fase deve ter pelo menos um card e uma mensagem de abertura. Uma fase vazia não será validada.

Atenção

Gates e nós de início não podem ser renomeados. Apenas fases e event triggers aceitam um nome personalizado — deixe o builder nomear automaticamente todo o resto.

Atenção

Publicar no marketplace exige uma validação completamente limpa — é mais rigoroso do que Salvar. Elimine todos os erros no painel de Problemas antes de publicar.

CRUD de engine e o marketplace

Novo — comece um engine do zero a partir de uma tela em branco.
Copiar (clonar) — duplique um engine existente para iterar sem tocar no original.
Renomear — renomeie um dos seus próprios engines.
Excluir — remova um engine que você possui.
Publicar / despublicar — compartilhe um engine limpo para o marketplace, ou remova-o.

Próximos passos

Com um engine construído, você está pronto para colocá-lo em ação. Leia sobre o persona em que ele roda em Personas, comece de um funnel comprovado em Templates do marketplace, teste em Testes e o simulador, e conecte ao vivo com Colocar em produção.