Docs

Engine Builder

The Engine Builder is where you design a conversation visually. You lay out phases on a canvas, fill them with cards, wire logic gates between them, and choose where the chat begins. This is the full reference.

Un motor es una conversación diseñada como diagrama. Lo construyes en un lienzo a partir de unos pocos componentes, lo pruebas en el simulador y luego lo publicas. Esta página cubre cada parte del constructor. Si eres nuevo, revisa primero Personas — cada motor funciona como una persona.

Conceptos clave

Algunas palabras aparecen en todo el constructor. Apréndalas y lo demás encajará solo.

  • Fase — una etapa de la conversación. Una fase es un mensaje de apertura (cómo la IA arranca esa etapa) más un deck de cartas que puede jugar mientras la conversación está en esa fase. Un motor típico tiene varias fases: apertura en frío, calentamiento, una invitación.
  • Deck — el conjunto de cartas asignadas a una fase. En cada turno el motor juega una carta del deck, elegida mediante un sorteo ponderado aleatorio, para que la misma fase se sienta diferente cada vez.
  • Carta — un movimiento concreto: chatear, hacer una pregunta, enviar una foto, dejar un enlace, cerrar. Cada carta tiene sus propios ajustes (ver la referencia de cartas más abajo).
  • Puerta / transición — una regla que mueve la conversación de una fase a otra, o dispara una reacción. Algunas puertas están en línea entre dos fases; otras flotan y observan toda la conversación.
  • Dato — un detalle que el motor aprende sobre el lead (su nombre, ciudad, intereses). Los datos se extraen del chat a medida que avanza y pueden insertarse de vuelta en los mensajes con una etiqueta.
  • Puntos de inicio — los nodos que indican dónde comienza una conversación: la IA escribe primero, el usuario escribe primero, o un evento externo.
  • Observadores flotantes — puertas que no están conectadas entre dos fases específicas. Observan toda la conversación y se activan cuando se cumple su condición (por ejemplo, aparece un dato, o el lead acepta un enlace).

El lienzo

El constructor es un lienzo con zoom de nodos conectados por aristas. Arrastras piezas desde el lateral, sueltas cartas sobre las fases y trazas líneas para cablear el flujo.

Paleta de nodos

  • Inicio — los nodos de inicio de conversación (AI Opener, Chat Entrante, Disparador de Evento).
  • Fases — añade un nuevo nodo de fase al lienzo.
  • Reglas — las puertas lógicas y observadores que cablear entre o alrededor de las fases.

Biblioteca de cartas

La biblioteca de cartas lista todos los tipos de carta. Arrastra una carta sobre una fase para añadirla al deck de esa fase. El mismo tipo de carta puede aparecer en múltiples fases con diferentes ajustes.

Cableado de aristas

Arrastra desde el manejador de salida de un nodo hasta otro nodo para crear una arista. Las aristas son la forma en que un punto de inicio llega a su primera fase y en que las puertas hacen avanzar el chat.

Auto-organizar

Los grafos cableados a mano se vuelven desordenados. El botón Auto-organizar (la varita, arriba a la derecha del lienzo de flujo) reorganiza todo el grafo en un diseño ordenado de izquierda a derecha sin nodos superpuestos, y luego ajusta la vista. Las nuevas posiciones se guardan al guardar el motor. Ejecútalo antes de terminar cualquier motor.

Tipos de carta

Las cartas son los movimientos que un motor puede hacer dentro de una fase. Estos son los tipos integrados, por sus nombres en la biblioteca:

  • Chat Casual (CHAT) — mensaje de forma libre. Esta es la única carta que respeta completamente tus Instrucciones personalizadas, así que es tu herramienta principal para dirigir el tono.
  • Buscador de Datos (PROBE) — pregunta por el siguiente dato que falta, apuntando automáticamente al detalle que el motor aún necesita.
  • Enviar Foto (PHOTO) — envía la foto más adecuada del archivo de la persona, seleccionada automáticamente a partir de la descripción de cada foto.
  • Foto de Verificación (VERIFICATION) — pide al lead que envíe una foto de prueba / verificación de sí mismo.
  • Dejar el Enlace (LINK_DROP) — deja tu enlace de funnel. Requiere una URL de funnel establecida en los ajustes globales.
  • Finalizar / Cerrar (CLOSE) — cierra y termina la conversación.
  • Reaccionar (REACT), Provocar / Coquetear (TEASE), Abrirse (SHARE), Conectar (RELATE) — ritmos integrados rápidos que mantienen la conversación con toque humano. Ver la advertencia más abajo — estos cuatro ejecutan una línea fija.

Atención

Reaccionar, Provocar / Coquetear, Abrirse y Conectar ejecutan una línea fija e integrada e ignoran el campo Instrucciones. Cualquier cosa que escribas en esas cuatro cartas (y cualquier etiqueta) no se utiliza. Si necesitas un texto personalizado, usa una carta Chat Casual en su lugar.

Puertas y transiciones

Las puertas deciden cuándo avanza o reacciona la conversación. Hay dos formas: contadores en línea cableados entre dos fases, y observadores flotantes que observan todo el chat.

Contador en línea

  • Después de N Mensajes (MESSAGE_COUNT) — cableado fase → puerta → fase. Cuenta los turnos y hace avanzar la conversación una vez alcanzado el umbral. El umbral es 1–20. Esta es la forma estándar de avanzar un chat a través de sus fases.

Observadores flotantes

  • Verificador de Datos (FACT_EXISTS) — se activa cuando se ha extraído un dato específico de la conversación.
  • Verificador de Conversión (CONVERSION_CHECK) — se activa según si el lead aceptó o rechazó el último enlace que dejaste.
  • Detector de Señales (DETECTOR) — un observador interno que respalda la defensa contra acusaciones de bot. No se ofrece en la paleta; no lo colocas tú mismo.

Puntos de inicio

Cada motor necesita saber cómo comienza un chat. Añade uno o más nodos de inicio y cablea cada uno a la fase donde comienza esa ruta.

  • AI Opener / Outreach — la IA envía el primer mensaje (outreach en frío). Úsalo para funnels proactivos.
  • Chat Entrante / Predeterminado — el usuario escribe primero (el DM entrante normal). Un motor debe tener exactamente un inicio de Chat Entrante / Predeterminado.
  • Disparador de Evento — inicia un chat cuando se activa un evento externo específico. Necesita un id de evento (por ejemplo, story_reaction).
  • Seguimiento — vuelve a conectar con un lead que ha quedado en silencio, atrayéndolo de vuelta a la conversación.

Atención

Las etiquetas de prompting no se completan en el AI Opener. Un {name} escrito en el opener se mostraría literalmente al lead. Escribe el AI Opener con palabras normales.

Datos y la pestaña Conocimiento

La pestaña Conocimiento es donde gestionas los datos que el motor recopila. Hay dos tipos:

  • Datos del sistema — detalles integrados que el motor siempre intenta aprender (como el nombre y la ubicación del lead).
  • Datos personalizados — tus propios campos, específicos de tu funnel.

Cada dato está asignado a una fase — la etapa durante la cual el motor debe intentar aprenderlo. La carta Buscador de Datos persigue entonces el dato que aún falta para la fase actual.

Atención

Cada dato puede pertenecer a exactamente una fase. Si quieres que el motor aprenda algo en una etapa diferente, mueve el dato — no puedes asignarlo a dos fases al mismo tiempo.

El inspector de nodos

Haz clic en cualquier nodo para abrir el inspector a la derecha. Lo que puedes editar depende del nodo, pero los campos comunes son:

  • Instrucciones / directiva — orientación en lenguaje natural sobre lo que debe hacer la IA. En una carta dirige el mensaje; en una fase es el propósito de la fase. (Recuerda que las cuatro cartas rápidas la ignoran.)
  • Opener de fase — el mensaje de apertura de una fase: cómo la IA inicia la conversación cuando entra en esa etapa.
  • Peso (1–100) — la probabilidad de que una carta sea seleccionada de su deck en un turno dado. Mayor peso = se juega con más frecuencia.
  • Límite de uso (0–20) — el número máximo de veces que una carta puede jugarse en una conversación. 0 significa ilimitado.
  • Espera entre usos — cuántos turnos esperar antes de que una carta pueda jugarse de nuevo, para que no se repita consecutivamente.

Etiquetas de prompting

Dentro de las Instrucciones de una carta puedes escribir una etiqueta y el motor sustituye el valor real antes de enviar el mensaje. Las etiquetas disponibles:

Detalles de la persona

  • {name} — el nombre de la persona
  • {age} — la edad de la persona
  • {origin} — de dónde es la persona
  • {city} — la ciudad de la persona
  • {job} — el trabajo de la persona
  • {hobbies} — los pasatiempos e intereses de la persona
  • {bio} — la biografía de la persona
  • {style_tags} — los rasgos de estilo de escritura de la persona
  • {time} — la hora actual del día, para que la persona pueda sonar consciente de si es de mañana o de noche

Tu funnel

  • {platform} — la app en la que estás escribiendo mensajes
  • {funnel_platform} — tu funnel o plataforma de destino

Acciones

  • {photo} — envía la foto más adecuada del archivo, seleccionada automáticamente por descripción
  • {link} — deja tu enlace de conversión, con evasión de filtros aplicada

Específico de la carta

  • {fact} — en una carta Buscador de Datos: el siguiente detalle a conocer sobre el lead
  • {vibe} — en una carta Enviar Foto: el estado de ánimo actual de la foto, casual o atrevido
  • {context} — en una carta de entrada / opener: el primer mensaje entrante al que reacciona el opener

Ajustes globales y de identidad

Los ajustes de todo el motor se encuentran en la pestaña Identidad / ajustes globales:

  • Plataforma de mensajería — la app en la que se desarrolla la conversación (impulsa la etiqueta {platform} ).
  • Límite de turnos (1–100, predeterminado 60) — el número máximo de turnos antes de que la conversación se detenga.
  • Máximo de burbujas de mensaje (1–5) — en cuántas burbujas separadas puede dividirse una sola respuesta.
  • Plataforma de funnel — tu plataforma de destino (impulsa {funnel_platform}).
  • URL del funnel — el enlace que envía la carta Dejar el Enlace.
  • Enmascaramiento de enlace — se aplica automáticamente para evadir filtros de enlaces cuando se deja el enlace.
  • Valor de lead — cuánto vale un lead convertido, utilizado por la analítica para estimar los ingresos.

Rechazos y defensa anti-bot

Puedes diseñar cómo maneja el motor los momentos incómodos — un lead que se resiste, o que acusa a la IA de ser un bot. Cada escenario empareja un disparador con una respuesta, que puede ser un texto o una imagen, para que la conversación se recupere con elegancia en lugar de atascarse.

Validación y publicación

El constructor verifica tu motor mientras trabajas e informa los problemas en el panel de Problemas. Dos niveles importan:

  • Los errores bloquean la publicación. No puedes publicar un motor que no supera la validación.
  • Solo los errores de límite duro bloquean Guardar. Puedes guardar un trabajo en progreso que aún tiene problemas menores y volver a él.
  • El panel de Problemas salta al nodo cuando haces clic en un problema, para que puedas corregirlo en el lugar.

Atención

Una fase debe tener al menos una carta y un mensaje de apertura. Una fase vacía no superará la validación.

Atención

Las puertas y los nodos de inicio no pueden renombrarse. Solo las fases y los disparadores de evento aceptan un nombre personalizado — deja que el constructor nombre automáticamente todo lo demás.

Atención

Publicar en el marketplace requiere una validación completamente limpia — es más estricto que Guardar. Resuelve todos los errores en el panel de Problemas antes de publicar.

CRUD de motores y el marketplace

  • Nuevo — comienza un motor nuevo desde un lienzo en blanco.
  • Copiar (clonar) — duplica un motor existente para iterar sin tocar el original.
  • Renombrar — renombra uno de tus propios motores.
  • Eliminar — elimina un motor de tu propiedad.
  • Publicar / retirar — comparte un motor limpio en el marketplace, o retíralo.

Próximos pasos

Con un motor construido, estás listo para ponerlo a trabajar. Lee sobre la persona en la que funciona en Personas, comienza desde un funnel probado en Plantillas del marketplace, pruébalo en Pruebas y el simulador, y conéctalo en vivo con Ir en vivo.

Engine Builder — FluidTalk Documentation | FluidTalk