Saltar al contenido principal

​
Resumen

Un Engagement Funnel es un flujo interactivo estructurado de varios pasos que guía a un contact por la recolección de datos, decisiones y engagement. Es el motor detrás de landing flows, lead forms, quizzes y bots conversacionales (WhatsApp / web chat). Un funnel es un grafo ordenado de layers (pasos); cada layer contiene components (mensajes, inputs, botones, llamadas a endpoints, formularios de auth). A medida que un contact avanza, una session registra cada respuesta, el camino recorrido y la finalización. Para ver cómo encajan los Funnels en la plataforma, consulta Conceptos básicos.

​
Dónde encontrarlo

Los Engagement Funnels están en Orchestration → Engagement Funnels, construidos en un canvas visual donde los layers son nodos y la navegación entre ellos son las aristas.

​
Layers

Un funnel es una secuencia de layers tipados. El type de cada layer determina su rol:
TipoPropósito
StartEl punto de entrada — el primer layer que ve el contact. Lleva el initial data del funnel.
IntermediateUn paso normal que recolecta datos y/o muestra contenido, y luego navega.
ResultFinalización / salida. Alcanzarlo completa la session y puede disparar una automation.
FatalisticUna respuesta sin salida (error o acceso denegado), sin navegación de salida.
ActionEjecuta acciones del lado del servidor (auth, llamada API, checkpoint, …) y luego avanza automáticamente — nunca se muestra al contact. Ver Funnel rules.
SubfunnelDelega a otro funnel y mapea datos de entrada y de vuelta. Ver Funnel rules.
Cada layer lleva una lista ordenada de components — los bloques con los que interactúa el contact. El catálogo completo (mensajes, inputs, botones, endpoint, auth) está en la página de Funnel components.

​
Canales

El mismo modelo de funnel se renderiza en distintos canales. Los canales conversacionales renderizan un component a la vez; web renderiza el layer completo de una vez:
CanalConversacionalNotas
WebNoPaleta completa de components y botones de navegación.
SMSNoSolo texto, con un conjunto limitado de apariencias de mensaje e input.
WhatsAppSíUn component a la vez; formatos de mensaje estructurados. La autenticación es implícita (el canal prueba el número de teléfono).
Web chatSíUn component a la vez; mismo conjunto de components que WhatsApp.
Regla multicanal: si algún layer usa una funcionalidad que un canal no soporta, ese canal se deshabilita para todo el funnel a menos que se configure una alternativa para él en cada layer. Por ejemplo, un input de subida de archivos necesita una alternativa apta para SMS para que el funnel siga disponible en SMS.

​
Initial data

El start layer de un funnel puede definir la estructura de su initial data — campos que se pueden proveer cuando el funnel arranca, para pre-llenar la session desde fuentes externas. Esos valores quedan disponibles en todo el funnel, incluido en condiciones. Fuentes comunes:
  • Parámetros de URL — valores de query/GET/POST como tags UTM o códigos de referido.
  • Session previa — datos del run anterior del contact.
  • Dispositivo y locale — idioma, tipo de dispositivo, OS, navegador.
  • Contexto personalizado — valores que tú pasas, como IDs de afiliado o campaña.
Por ejemplo, mostrar un welcome message distinto cuando utm_source = "facebook", o ajustar el layout cuando device_type = "mobile".

​
Versionado y publicación

Todo funnel está versionado por idioma × entorno × status (draft / published):
  • La estructura se comparte entre los idiomas de un entorno — editar el tipo, el orden o las reglas de un layer se propaga a cada draft de idioma de ese entorno.
  • El contenido es por idioma — solo el texto/contenido de los components varía por idioma.
  • Publish copia un draft a published (tras validar) y registra un release inmutable; unpublish quita la version published pero conserva el draft.
  • A los contacts solo se les sirve la version published de su idioma/entorno resuelto.

​
Sessions

Una session trackea el run de un contact por un funnel. Registra los datos acumulados (enviados y autocompletados), el layer actual, el historial de layers visitados y un status:
StatusSignificado
in_progressEl contact sigue avanzando por el funnel.
completedEl contact alcanzó un result layer.
closedCerrada por un usuario o por una acción del sistema.
abandonedSe fue sin completar.
La reanudación permite que un contact continúe donde lo dejó — vía storage o cookies del navegador (web), número de teléfono o id de contact (mensajería), o un magic link (email / SMS). Con la reanudación activa, un contact puede navegar hacia atrás para revisar o editar respuestas anteriores. El timeout de la session es configurable por funnel; tras inactividad, la session expira.

​
Estadísticas

Los funnels trackean eventos de engagement — visitas, conversiones, finalizaciones, finalizaciones por layer y clics de botón — que se agregan en métricas:
  • Tasa de conversión — conversiones ÷ sessions.
  • Tasa de finalización — sessions completadas ÷ sessions.
  • Tasa layer a layer — cuántas sessions llegaron a cada layer (análisis de drop-off).
  • Rendimiento multicanal — tasas de conversión por canal.

​
Properties

PropertyTipoRequeridoDescripción
titlestringSíNombre visible.
slugstringSíIdentificador.
descriptionstringNoDescripción opcional.
channelenumNoweb, whatsapp, web_chat o sms. Por defecto web.
configobjectNoConfig a nivel de funnel — disponibilidad/control de acceso y los layers de inicio y fatalistic.
versionsarrayAutoLas versions por idioma/entorno/status.

​
Seeds

Los funnels viajan entre entornos como Seeds estructurales. Un item funnels lleva el funnel más sus versions, y cada version lleva sus layers y sus components: 
[
  {
    "object_type": "funnels",
    "data": {
      "title": "Cotiza tu auto",
      "slug": "cotiza-tu-auto",
      "description": "Captura de leads para un préstamo con garantía de auto.",
      "channel": "web",
      "versions": [
        {
          "language": "es",
          "environment": "production",
          "status": "draft",
          "layers": [
            {
              "title": "Cotiza tu auto",
              "slug": "cotiza-tu-auto",
              "type": "start",
              "requires_auth": false,
              "components": [
                {
                  "title": "Instrucciones",
                  "slug": "instrucciones",
                  "type": "message",
                  "message_type": "compound",
                  "content": {
                    "message": { "header": "¡Cotiza tu auto!", "body": "<p>Dinos qué auto tienes.</p>" }
                  }
                },
                {
                  "title": "Año",
                  "slug": "anio",
                  "type": "input",
                  "input_type": "text",
                  "config": { "appearance": "short", "mandatory": true }
                },
                {
                  "title": "Continuar",
                  "slug": "continuar",
                  "type": "button",
                  "button_type": "navigation",
                  "config": { "action": "jump_to_layer", "default_target": "ingresa-tu-numero" }
                }
              ]
            }
          ]
        }
      ]
    }
  }
]

​
Gobernanza y permisos

Solo un super admin o un Master puede crear, editar, publicar y eliminar funnels.

​
Acceso por API

Los funnels tienen dos superficies de API: una User API para el builder (CRUD de funnels, layers y components, más versionado y publish/unpublish), y una Contact API para el runtime player (obtener el funnel publicado, enviar respuestas y navegar). Consulta la API reference.

​
En profundidad

Funnel components

El catálogo completo — mensajes, inputs, botones, endpoint y auth.

Funnel rules

Control de acceso, skip conditions, jump conditions, autofill, subfunnels y action layers.

​
Relacionado

Events & Automation

Lo que dispara un result layer o un checkpoint.

Conversations

El runtime conversacional para WhatsApp y web chat.

Contacts

Quién avanza por un funnel, y dónde caen sus datos.