Documentación / Flujos
El editor de flujos
Un flujo es un grafo: los disparadores lo inician, los nodos definen lo que ocurre y las conexiones deciden el camino que sigue cada suscriptor. Abre cualquier bot en la consola y elige Editor para editar su flujo en el lienzo.
Trabajar en el lienzo
Arrastra nodos de la paleta al lienzo y conéctalos arrastrando desde el conector de un nodo hasta otro. Al seleccionar un nodo se abre su configuración; cada tipo de nodo tiene su propio formulario (un disparador de palabra clave pide el modo de coincidencia, un disparador programado pide el intervalo y la hora, un nodo HTTP pide la URL y el método).
El borrador que editas es privado: los suscriptores solo experimentan el flujo publicado . Esa separación significa que puedes modificar un bot en producción con seguridad: nada cambia para tu audiencia hasta que pulses Publicar.
Familias de nodos
| Familia | Nodos | Para qué sirve |
|---|---|---|
| Disparadores | Comando (/start…) · Palabra clave (contiene / exacta / regex) · Pulsación de botón · Consulta en línea · Miembro se une · Programación (cada hora → anual, intervalos personalizados) · Webhook entrante · Pedido pagado | Dónde comienza un flujo. Todo flujo necesita al menos un disparador. |
| Mensajes | Texto · Multimedia (foto / video / documento / audio) · Teclado en línea · Teclado de respuesta · Encuesta · Ubicación · Editar mensaje · Eliminar mensaje · Indicador de escritura | Lo que envía el bot. Los botones llevan valores que pueden volver a entrar en los flujos como disparadores de pulsación de botón. |
| Lógica | Condición · Switch (ramificación múltiple) · División A/B · Retraso · Puerta · Salto (a otro nodo) · Establecer variable · Fin | Ramificación y ritmo. Las divisiones A/B dividen la audiencia en grupos etiquetados para que flujos posteriores puedan dirigirse a cada rama. |
| Datos | Solicitud HTTP · Pregunta (recopilar una respuesta) · Fuente RSS · Establecer atributo · Notificar webhook | Comunicación con el exterior: consultar APIs, guardar atributos de suscriptores, enviar eventos. |
| Crecimiento | Enlace directo · Campaña de goteo · Pertenencia a segmento · Traspaso en vivo | Adquisición y fidelización. El goteo envía una secuencia programada; los segmentos alimentan las difusiones. |
| Tienda | Catálogo · Producto · Carrito · Pago · Pedidos | Vende productos físicos o digitales directamente en el chat, con un historial de pedidos por suscriptor. |
| IA | Respuesta de IA | Genera una respuesta a partir del contexto de la conversación. Disponible en productos marcados como habilitados para IA. |
| Reservas | Confirmar reserva · Cancelar reserva · Listar reservas | Flujos tipo cita: reserva franjas horarias y gestiónalas desde el chat. |
| Multimedia | Código QR | Genera códigos QR en línea, por ejemplo para entradas y referencias de pago. |
Qué nodos desbloquea tu línea
Los nodos bloqueados aparecen en la paleta con una insignia y una explicación con un clic de lo que se necesita. Si intentas usar un tipo de nodo bloqueado a través de la API, obtienes un error claro, nunca un fallo silencioso.
| Capacidad | Disponibilidad |
|---|---|
| Nodos básicos (disparadores, mensajes, lógica básica, datos) | Todas las líneas |
| Nodos avanzados: división A/B, Switch, solicitud HTTP, goteo, segmento, webhook entrante, programación, consulta en línea, encuesta | Línea Professional y superior |
| Nodos de tienda: catálogo, producto, carrito, pago, pedidos | Línea Professional y superior |
| Traspaso en vivo a un agente humano | Línea Enterprise |
| Respuesta de IA | Productos marcados como habilitados para IA (Core y superiores en Startup) |
Vista previa, registros, publicación, reversión
Vista previa. El panel de vista previa recorre el flujo como lo haría un suscriptor: envía la entrada del disparador y observa qué camino se sigue. Utiliza el mismo grafo que usa el entorno de ejecución, así que lo que ves en la vista previa es lo que se ejecuta.
Registros. La página de registros del bot muestra conversaciones y resultados de entrega reales a medida que ocurren, útil cuando un flujo publicado no se comporta como sugería la vista previa.
Publicación y versiones. Al publicar se guarda el borrador como una nueva versión numerada y se pone en producción. La página de Versiones lista cada versión publicada con quién la publicó y cuándo, y con un clic puedes revertir el bot a cualquier versión anterior: una mala publicación nunca está a más de un clic de deshacerse.
¿Nuevo por aquí? La guía de inicio rápido te lleva de principio a fin por tu primer bot en unos diez minutos.