​

Construyendo flujos

​

Descripción general

• Chatbots con tecnología de inteligencia artificial para WhatsApp, Web, Instagram y más
• Formularios de captura de clientes potenciales con ramificación condicional.
• Sistemas de clasificación de atención al cliente con transferencia humana.
• Flujos de trabajo de reserva y programación de citas.
• Asistentes de comercio electrónico con cobro de pagos.
• Secuencias de incorporación y encuestas interactivas.

​

Empezando

​

Creando un nuevo flujo

1. Navigate to Dashboard → Tools → ZappFlux → Flows
2. Click New Flow (or the + button)
3. Give your flow a name
4. Choose a starting template or start from blank
5. The flow editor opens automatically

​

Diseño del editor

​

Navegación del lienzo

• Pan: haga clic y arrastre en el espacio vacío del lienzo
• Zoom: rueda de desplazamiento o gesto de pellizcar (trackpad)
• Seleccionar bloque: haga clic en un bloque
• Mover bloque: haz clic y arrastra un bloque para reposicionarlo
• Conectar bloques: arrastre desde el controlador de salida (lado derecho) de un bloque al controlador de entrada (lado izquierdo) de otro.
• Eliminar conexión: haga clic en la flecha entre bloques y presione Eliminar

​

Tipos de bloques

​

💬 Burbujas: envío de contenido a los usuarios

​

Texto

• Contenido del mensaje (admite el formato Markdown)
• Interpolación de variables usando {{variable_name}}
• Retraso de escritura opcional (simula un tiempo de respuesta realista)

​

Imagen

• Fuente de la imagen: Sube un archivo (PNG, JPG, GIF, WebP) o ingresa una URL pública
• Texto alternativo para accesibilidad
• Título opcional debajo de la imagen.

​

Video

• Fuentes admitidas: YouTube, Vimeo o URL directa del archivo de vídeo
• Opción de reproducción automática
• Título/título del vídeo

​

Audio

• Fuente de audio: cargue un archivo (MP3, WAV, OGG) o ingrese una URL
• Se muestra como un widget de reproductor de audio estándar.

​

Insertar

• URL para incrustar (debe admitir la incrustación de iframe)
• Dimensiones (ancho y alto)
• Útil para incrustar calendarios, mapas o páginas de productos

​

📥 Entradas: recopilación de información de los usuarios

​

Entrada de texto

• Texto de marcador de posición que se muestra en el campo de entrada
• Variable para almacenar la respuesta.
• Límite de caracteres opcional
• Etiqueta del botón (“Enviar”, “Enviar” o texto personalizado)

​

Número

• Restricciones de valor mínimo y máximo
• Se muestra un mensaje de error si falla la validación.
• Variable para almacenar la respuesta.

​

Correo electrónico

• Validación de formato de correo electrónico incorporada (rechaza entradas con formato incorrecto)
• Mensaje de error personalizado para entrada no válida
• Variable para almacenar la respuesta.

​

Teléfono

• Selector de código de país (opcional; se puede bloquear para un país específico)
• Validación de formato
• Variable para almacenar la respuesta.

​

Fecha/Hora

• Modo: Sólo fecha, Sólo hora o Fecha + Hora
• Restricciones de fecha mínima y máxima
• Variable para almacenar el valor seleccionado.

​

Botones

• Hasta 10 opciones de botones
• Cada botón tiene una etiqueta y un valor opcional (puede diferir de la etiqueta de visualización)
• Modo de elección múltiple o única
• Variable para almacenar las opciones seleccionadas.

• Mantenga las etiquetas de los botones cortas (menos de 40 caracteres) para una representación consistente en todos los canales
• Utilice botones en lugar de entradas de texto libre siempre que sea posible para mejorar la calidad de los datos y reducir las respuestas ambiguas.

​

Elección de imagen

• Cada opción tiene una imagen (carga o URL) y una etiqueta
• Selección única o múltiple
• Variable para almacenar la(s) selección(es)

​

Carga de archivos

• Tipos de archivos aceptados (PDF, imágenes, documentos, etc.)
• Límite máximo de tamaño de archivo
• Variable para almacenar la URL del archivo cargado

​

Pago

• Stripe: tarjetas de crédito/débito, Apple Pay, Google Pay
• PayPal: saldo de PayPal, cuentas bancarias vinculadas, tarjetas

• Importe (fijo o extraído de una variable)
• Moneda
• Nombre/descripción del artículo
• Variable para almacenar el estado del pago y el ID de la transacción.

​

Calificación

• Tipo de calificación: Estrellas (1 a 5) o Número (1 a 10)
• Etiqueta opcional por valor de calificación
• Variable para almacenar la calificación.

​

⚡ Lógica: controlar el comportamiento del flujo

​

Establecer variable

• Nombre de la variable a configurar
• Valor: un valor estático, otra variable o una expresión JavaScript

• Inicializando variables de contador (set count = 0)
• Formato de valores (set full_name = "{{first_name}} {{last_name}}")
• Almacenamiento de marcas de tiempo o valores calculados

​

Condición

• Lado izquierdo: una variable
• Operador: igual, no igual, contiene, mayor que, menor que, está vacío, no está vacío
• Lado derecho: un valor u otra variable
• Se pueden encadenar múltiples condiciones con AND/OR

​

Redirigir

• URL de destino (estática o construida a partir de variables)
• Abrir en: misma pestaña o nueva pestaña
• Retraso opcional antes de la redirección.

​

Guion

• Bloque de código JavaScript personalizado
• Acceso a todas las variables de flujo a través de variables.variable_name
• Puede configurar variables usando setVariable('variable_name', value)

• Formato o análisis de cadenas complejas
• Cálculos matemáticos más allá de expresiones simples.
• Manipulación y formato de fechas.
• Llamar a las API del navegador (para flujos web)

​

Esperar

• Duración: segundos, minutos u horas.
• Mensaje opcional mostrado al usuario durante la espera.

​

Saltar

• Destino: un ID de bloque específico dentro del flujo actual, o un flujo completo.

• Volver a un menú después de que se completa una ruta
• Vincular a un subflujo reutilizable (por ejemplo, un flujo de preguntas frecuentes compartido)
• Creación de bucles circulares para la lógica de reintento.

​

Webhook

• Método: OBTENER, PUBLICAR, PONER, PATCH, BORRAR
• URL: punto final al que llamar (admite interpolación de variables)
• Encabezados: pares clave-valor (por ejemplo, Autorización, Tipo de contenido)
• Cuerpo: carga útil JSON (para métodos POST/PUT/PATCH)
• Mapeo de respuesta: extrae valores de la respuesta y los almacena en variables

• Envío de datos de leads a un CRM (HubSpot, Salesforce)
• Búsqueda de datos de usuario desde su propia base de datos.
• Activar un pedido en una plataforma de comercio electrónico
• Publicar datos en un webhook Zapier o Make

​

Enlace de flujo (subflujo)

• Seleccione el flujo objetivo de un menú desplegable
• Mapeo de variables: pasar variables del flujo actual al subflujo
• Una vez que se completa el subflujo, la ejecución regresa al siguiente bloque del flujo principal.

​

🔌 Integraciones: conectores nativos

​

OpenAI (ChatGPT)

• Selección de modelo (GPT-4o, GPT-4, GPT-3.5-turbo, etc.)
• Aviso del sistema (definir la personalidad y las limitaciones de la IA)
• Mensaje de usuario: la entrada para enviar al modelo (normalmente una variable que contiene el último mensaje del usuario)
• Variable de respuesta: donde se almacena la respuesta de la IA.
• Avanzado: temperatura, tokens máximos, modo historial de conversaciones

• Pase {{user_message}} a OpenAI y muestre la respuesta en una burbuja de texto
• Utilice un mensaje del sistema para limitar la IA a un dominio específico (por ejemplo, “Usted es un agente de servicio al cliente de Acme Corp. Solo responda preguntas sobre nuestros productos”).
• Habilite el modo de historial de conversaciones para mantener el contexto en múltiples intercambios

​

Hojas de cálculo de Google

• Acción: Insertar fila, Actualizar fila, Obtener fila o Obtener todas las filas
• Hoja de cálculo y selección de hojas (desde su cuenta de Google conectada)
• Mapeo de columnas: asigna variables de flujo a columnas de hoja de cálculo

​

Google Analytics

• Nombre del evento
• Parámetros personalizados (pares clave-valor, admite variables)

• flow_started — cuando un usuario comienza el flujo
• lead_captured — cuando se recopila información de contacto
• payment_completed — cuando se realiza un pago exitoso
• human_requested — cuando un usuario solicita un agente humano

​

Zapier / Hacer

• URL de webhook (desde tu escenario Zap o Make)
• Carga útil de datos: seleccione qué variables enviar

​

Chatwoot

• URL de la API de Chatwoot y token de acceso
• Bandeja de entrada para asignar la conversación
• Asignación de agente (opcional)
• Atributos personalizados para pasar a Chatwoot

​

Enviar correo electrónico

• Del nombre y dirección de correo electrónico
• Para abordar (soporta variables)
• Línea de asunto (admite variables)
• Cuerpo: HTML o texto plano (admite variables)
• Proveedor: credenciales SMTP o SendGrid configuradas desde Configuración de flujo

​

Acciones ZappWay

• Actualizar las variables del contacto actual.
• Asignar una conversación a un agente específico
• Agregar o eliminar etiquetas de un contacto
• Activar una notificación a la bandeja de entrada de ZappWay

​

Uso de variables en texto

"Hi {{user_name}}, your order #{{order_id}} has been confirmed!"

​

Tipos de variables

​

Variables del sistema

​

Ramificación de flujo y lógica condicional

​

Rama simple (botones)

[Button Block: "What do you need help with?"]
├── "Track my order" → [Order tracking path]
├── "Return a product" → [Returns path]
└── "Speak to a human" → [Chatwoot handoff]

​

Rama basada en condiciones

[Set Variable: plan = {{selected_plan}}]
[Condition: IF plan equals "Enterprise"]
├── YES → [Enterprise onboarding path]
└── NO  → [Standard onboarding path]

​

Condiciones anidadas

[Condition: IF score >= 8]
├── YES → [Promoter path (NPS)]
└── NO  → [Condition: IF score >= 5]
           ├── YES → [Passive path]
           └── NO  → [Detractor path]

​

Publicar un flujo

1. Termina de editar tu flujo
2. Haga clic en Publicar en la esquina superior derecha del editor.
3. Confirme el cuadro de diálogo si se le solicita.
4. Tu flujo ahora está disponible en su URL pública.

​

Modo de vista previa

1. Click the Preview button (play icon) in the toolbar
2. A live preview of the flow opens in a side panel or new tab
3. Interact with the flow exactly as an end user would
4. All blocks execute normally in preview, including integrations

​

Mejores prácticas

​

Solución de problemas

​

Problema: el flujo no responde a la entrada del usuario

• Se envían mensajes pero el flujo no avanza
• El bloque de entrada parece estar atascado

1. Verifique que el bloque de entrada tenga una variable asignada; es posible que los bloques sin una variable de destino no guarden las respuestas correctamente
2. Verifique que la salida del bloque esté conectada al siguiente bloque.
3. Obtenga una vista previa del flujo y verifique si hay errores en la consola del navegador.
4. Asegúrese de que el canal esté conectado correctamente en Configuración → Canales
5. Vuelva a publicar el flujo después de realizar correcciones.

​

Problema: el bloque de condición no se bifurca correctamente

• El flujo siempre toma la misma rama independientemente del valor de la variable.
• Comportamiento inesperado en lógica condicional.

1. Utilice el bloque Script antes de la condición para registrar el valor de la variable: console.log(variables.your_variable)
2. Verifique la distinción entre mayúsculas y minúsculas: “Pro” no es igual a “pro” en una comparación exactamente igual; usar minúsculas consistentemente
3. Verifique que la variable realmente se esté configurando antes de que se ejecute el bloque de condición.
4. Verifique si hay espacios en blanco iniciales o finales en el valor de la variable; use el bloque Script para recortarlo: setVariable('plan', variables.plan.trim())

​

Problema: el bloque de webhook devuelve un error

• El bloque de webhook muestra un indicador de error rojo
• Los datos de integración no se envían ni reciben

1. Haga clic en el bloque Webhook para ver la respuesta en el panel de propiedades; verifique el código de estado HTTP y el mensaje de error.
2. Verifique que la URL sea correcta y accesible desde Internet.
3. Verifique que los encabezados requeridos (por ejemplo, Authorization: Bearer your_token) estén incluidos
4. Valide la estructura del cuerpo JSON usando una herramienta como JSONLint
5. Pruebe el punto final del webhook de forma independiente utilizando Postman o curl antes de agregarlo al flujo.

​

Problema: el bloque OpenAI no genera respuestas

• El bloque de IA parece bloquearse o devuelve respuestas vacías
• Error “Clave API no válida” en el bloque

1. Verifique que la clave API de OpenAI esté guardada correctamente en Configuración de flujo → Integraciones → OpenAI
2. Verifique su cuenta OpenAI para detectar problemas de facturación: una cuota agotada hace que todas las llamadas API fallen
3. Asegúrese de que el modelo seleccionado en el bloque esté disponible en su plan OpenAI
4. Verifique que la variable de entrada del mensaje del usuario no esté vacía cuando se ejecuta el bloque.

​

Apoyo

• Correo electrónico: support@zappway.ai
• Incluye: nombre del flujo, capturas de pantalla de los bloques en cuestión y una descripción del comportamiento esperado versus real.

• ¿Qué tipo de bloque está causando el problema?
• El canal en el que estás probando.
• Si el problema ocurre en el modo de vista previa, en vivo o en ambos.
• Cualquier mensaje de error mostrado en el bloque o en la consola del navegador.

• API ZappFlux completa y referencia de bloque: docs.zappflux.zappway.ai