Integra Typebot con ChatCielo: extrae URL, variables `{{name}}` `{{phoneNumber}}` y úsalo en ChatFlow con la regla de una automatización por canal

Typebot en ChatCielo

Typebot es un constructor de flujos conversacionales visuales con botones, formularios, lógica condicional y variables. A diferencia de los LLMs, Typebot no "improvisa" — sigue el flujo exacto que diseñas. En ChatCielo lo usas para captación, calificación, agendamiento y derivación estructurada, con la ventaja de que ChatCielo le envía automáticamente los datos del contacto.

Úsalo cuando necesites control total del guion (sin alucinaciones), flujos con botones y formularios, o cuando quieras combinar Typebot + IA: Typebot califica y la IA cierra.

1. Integración nativa de Typebot con ChatCielo

ChatCielo se conecta a Typebot vía URL de la instancia + nombre público del bot. No necesitas webhooks manuales: la integración es nativa y bidireccional.

Qué necesitas de Typebot

Dato	Dónde encontrarlo	Ejemplo
URL de la instancia	URL donde está alojado tu Typebot	`https://typebot.tudominio.com` o `https://app.typebot.io`
Nombre público del bot (Public name / ID)	Dentro del editor de Typebot > Share > Public URL	`mi-bot-ventas` o el ID largo `clx1a2b3c...`

Copia la URL de la instancia

Si usas Typebot Cloud, tu instancia es https://app.typebot.io. Si usas Typebot auto-alojado, es la URL donde lo instalaste, por ejemplo https://typebot.tuempresa.com.

Esta URL es la que ChatCielo usará para llamar a tu bot. No incluyas la ruta del bot, solo el dominio base.

Copia el nombre público / ID del bot

Abre tu bot en el editor de Typebot.
Haz clic en Share (Compartir) en la esquina superior.
Copia el Public URL — verás algo como https://app.typebot.io/mi-bot-ventas — el nombre es mi-bot-ventas.
Alternativamente, copia el Typebot ID desde Settings > General > Typebot ID (formato clx...).

El bot debe estar Publicado (Published). Si está en borrador, ChatCielo no podrá invocarlo. Haz clic en Publish en Typebot antes de probar.

2. Configuración en ChatCielo

Ve a Canales > Tu canal > Integración IA / Automatización > Typebot.

Campo	Qué poner	Ejemplo
URL de la instancia	Dominio base de tu Typebot	`https://app.typebot.io`
Nombre público / ID del bot	Nombre o ID copiado de Typebot	`mi-bot-ventas`
Mensaje de bienvenida (opcional)	Texto que ChatCielo envía al iniciar Typebot	`¡Hola {{name}}! Te ayudo en un momento.`

Pega los datos y guarda

En ChatCielo pega la URL de la instancia y el nombre público / ID. Haz clic en Guardar y luego en Probar conexión si está disponible. Deberías ver un mensaje de éxito.

Prueba desde un número externo

Envía un mensaje al número conectado al canal (tu propio celular). El flujo de Typebot debe dispararse automáticamente y responder con el primer bloque de tu bot.

3. Variables disponibles que ChatCielo envía automáticamente

Cuando ChatCielo invoca tu Typebot, inyecta automáticamente las variables del contacto y la conversación. Úsalas directamente en Typebot sin configuración adicional.

Variable en Typebot	Contenido	Ejemplo	Uso típico
`{{name}}`	Nombre del contacto	`María González`	Saludo personalizado: `¡Hola {{name}}!`
`{{phoneNumber}}`	Número de WhatsApp con código país	`+54 11 1234 5678`	Validación, CRM, recordatorio
`{{protocol}}`	Protocolo / ID de la atención	`48291`	Trazabilidad, derivación a humano
`{{email}}`	Email del contacto (si existe)	`maria@ejemplo.com`	Envío de cotización, registro
`{{pushName}}`	Nombre push de WhatsApp	`María`	Fallback si `{{name}}` está vacío
`{{channelId}}`	ID del canal	`12`	Lógica por canal
`{{agentName}}`	Nombre del agente asignado (si hay)	`Carlos`	Derivación personalizada

Cómo usarlas en Typebot

En cualquier bloque de texto de Typebot, escribe la variable entre llaves dobles. Ejemplo:

¡Hola `{{name}}`! 👋
Vi que nos escribes desde `{{phoneNumber}}`.
Tu protocolo es `{{protocol}}` — lo usaremos para dar seguimiento.
¿En qué puedo ayudarte hoy?

En Typebot, declara estas variables en Variables (panel lateral) para que estén disponibles en condiciones y lógica:

En Typebot ve a Variables > Create variable.
Crea name, phoneNumber, protocol, email (sin llaves, solo el nombre).
Marca como Prefilled si quieres que ChatCielo las envíe al iniciar.

Tip: usa {{name}} con fallback en Typebot: ¡Hola {{name}}! + condición If {{name}} is empty → "¡Hola!". Así evitas saludar con variable vacía si el contacto no tiene nombre guardado.

Variables de Typebot hacia ChatCielo (retorno)

Typebot puede devolver variables a ChatCielo al finalizar el flujo. Por ejemplo, si en Typebot capturas {{motivo}}, {{presupuesto}} o {{email}}, ChatCielo puede:

Guardarlas como etiquetas o campos del contacto.
Usarlas en ChatFlow para derivar al departamento correcto.
Mostrarlas al agente humano que toma la conversación después de Typebot.

Configura en Typebot el bloque final Set Variable y ChatCielo las recibirá automáticamente al cerrar el flujo.

4. Regla de oro: solo una automatización por canal

Regla de oro de ChatCielo: solo puede haber una automatización activa por canal a la vez. Si activas Typebot en un canal, no actives simultáneamente ChatGPT, Claude u otra IA en ese mismo canal — entrarán en conflicto y el cliente recibirá respuestas duplicadas.

Si necesitas combinar Typebot + IA, hazlo dentro del flujo: usa Typebot para calificar y ChatFlow/IA para cerrar, o viceversa — pero no dos automatizaciones directas en el mismo canal.

Configuración	Resultado
✅ Typebot activo en Canal A, ChatGPT activo en Canal B	Correcto — cada canal con su automatización.
✅ Typebot activo en Canal A + ChatFlow que deriva a humano	Correcto — ChatFlow es flujo, no automatización competidora.
❌ Typebot + ChatGPT activos en el mismo Canal A	Conflicto — respuestas duplicadas.
❌ Typebot + N8N webhook activos en el mismo Canal A	Conflicto — elige uno como automatización principal.

Cómo cambiar: ve a Canales > Tu canal > Automatización y desactiva la automatización anterior antes de activar la nueva. ChatCielo te advertirá si intentas activar dos a la vez.

5. Cómo llamarlo desde ChatFlow como nodo final

Typebot no solo funciona como automatización directa del canal — también puedes invocarlo desde ChatFlow como nodo final de un flujo. Esto te permite: ChatFlow califica → Typebot profundiza → humano cierra.

Patrón recomendado: ChatFlow + Typebot

Crea tu flujo en ChatFlow

Ve a ChatFlow > + Nuevo Flujo. Diseña tu flujo de entrada con nodos de Mensaje, Pregunta, Condición y Etiqueta.

Ejemplo de flujo:

Inicio → Mensaje de bienvenida → Pregunta: "¿Qué necesitas?" (botones: Ventas / Soporte / Reclamo)
       → Condición: si Ventas → Nodo Typebot
       → Condición: si Soporte → Derivar a IA o humano
       → Condición: si Reclamo → Derivar a humano

Agrega el nodo Typebot como nodo final

En ChatFlow, agrega un nodo de tipo Integración > Typebot (o Acción > Llamar Typebot según tu versión de ChatCielo) como último nodo de la rama.

Configura:

URL de la instancia: https://app.typebot.io
Nombre público / ID: mi-bot-ventas
Variables a enviar: {{name}}, {{phoneNumber}}, {{protocol}}, {{email}} (se envían automáticamente)

Typebot debe ser el nodo final de la rama en ChatFlow. No agregues nodos después de Typebot — el control pasa a Typebot y este gestiona el resto de la conversación hasta que termina o deriva a humano.

Configura el cierre de Typebot

En Typebot, diseña el bloque final para uno de estos cierres:

Derivar a humano: bloque ChatCielo / Close chat o mensaje final "Te conecto con un asesor" + ChatCielo detecta el fin y asigna a agente.
Finalizar y etiquetar: bloque Set Variable con {{motivo}}, {{calificacion}} y mensaje "¡Gracias {{name}}! Un asesor te contactará pronto. Protocolo {{protocol}}."
Volver a ChatFlow: si tu versión lo soporta, usa bloque Redirect para volver a ChatFlow (consulta soporte para esta opción).

Publica y prueba

En Typebot haz clic en Publish.
En ChatCielo guarda el ChatFlow y vincúlalo al canal en Canales > Tu canal > ChatFlow.
Envía un mensaje de prueba y recorre la rama que lleva a Typebot. Verifica que las variables {{name}} y {{protocol}} lleguen correctamente.

Ejemplo completo de flujo combinado

Cliente escribe "hola"
  → ChatFlow: "¡Hola {{name}}! ¿En qué te ayudo?" [Ventas] [Soporte] [Reclamo]
  → Cliente elige [Ventas]
  → ChatFlow deriva a Typebot "mi-bot-ventas"
    → Typebot: "¡Hola {{name}}! ¿Qué producto te interesa?" [Producto A] [Producto B]
    → Cliente elige Producto A
    → Typebot: "¿Cuál es tu presupuesto?" (captura {{presupuesto}})
    → Typebot: "Perfecto, un asesor te envía la cotización. Protocolo {{protocol}}."
    → Typebot cierra → ChatCielo asigna a agente de Ventas con variables {{presupuesto}} visibles

6. Buenas prácticas y solución de problemas

Problema	Causa	Solución
Typebot no responde	Bot no publicado	En Typebot haz clic en Publish.
Variables `{{name}}` vacías	Contacto sin nombre guardado	Usa fallback: `If {{name}} is empty → "¡Hola!"`. Pide el nombre en el primer bloque de Typebot.
Respuestas duplicadas	Dos automatizaciones en el mismo canal	Desactiva una. Solo una automatización por canal.
Typebot no recibe `{{phoneNumber}}`	Variable no declarada en Typebot	Crea la variable `phoneNumber` en Variables de Typebot como Prefilled.
El flujo se corta a mitad	Nodo Typebot no es nodo final en ChatFlow	Mueve Typebot al final de la rama, sin nodos después.
Error de conexión	URL de instancia incorrecta	Verifica que la URL sea solo el dominio base, sin `/mi-bot` al final.

¿Quieres potenciar Typebot con IA? Usa Typebot para calificar (botones, formularios) y luego deriva a ChatGPT o Claude para cerrar con tono humano, o a Dify para responder con tu base de conocimiento. La combinación Typebot + IA es el patrón más efectivo para conversión.

Typebot