Integra N8N con ChatCielo vía Webhook POST: envío bidireccional de mensajes, automatizaciones CRM y flujos sin límites

N8N — Automatización Avanzada con ChatCielo

N8N es una plataforma de automatización open source que te permite crear flujos sin límites: conectar ChatCielo con tu CRM, ERP, hojas de cálculo, APIs y cualquier servicio vía Webhook POST. Si Typebot es para flujos conversacionales y los LLMs para respuestas inteligentes, N8N es para orquestar todo lo demás.

Con N8N, ChatCielo puede enviar cada mensaje a tu workflow, procesarlo con lógica, IA, bases de datos y responder de vuelta a ChatCielo para que el cliente reciba la respuesta en WhatsApp — todo en segundos y sin intervención humana.

1. Visión general de la integración

Cómo funciona

Cliente escribe en WhatsApp
        ↓
ChatCielo recibe el mensaje
        ↓
ChatCielo hace POST al Webhook de N8N (JSON con mensaje + variables)
        ↓
N8N procesa: lógica, CRM, IA, base de datos, APIs...
        ↓
N8N responde vía HTTP Response o hace POST de vuelta a la API de ChatCielo
        ↓
Cliente recibe la respuesta en WhatsApp

Qué puedes automatizar con N8N + ChatCielo

Caso de uso	Qué hace N8N	Resultado en ChatCielo
Consulta de pedido	Recibe `{{protocol}}`, consulta tu ERP/DB y devuelve estado	Cliente ve: "Tu pedido #48291 está en camino, llega mañana."
Lead scoring	Recibe `{{name}}` + mensaje, califica con IA y etiqueta	Deriva a Ventas si es lead caliente, a Soporte si es reclamo
Alta en CRM	Crea contacto en HubSpot / Pipedrive / Google Sheets	Contacto registrado automáticamente sin copiar/pegar
Cotización automática	Calcula precio según variables + stock en tu API	Envía cotización en PDF o mensaje con total
Recordatorio y seguimiento	Programa follow-up en 24h si el cliente no responde	Mensaje automático de seguimiento vía ChatCielo
Traducción y resumen	Traduce, resume o analiza sentimiento con IA	Agente humano recibe resumen + etiqueta de prioridad

2. Configuración en ChatCielo — Webhook POST

Ve a Canales > Tu canal > Integración / Automatización > N8N (Webhook).

Campo	Qué poner	Ejemplo
Webhook URL	URL del nodo Webhook de tu workflow N8N	`https://tu-n8n.com/webhook/chatcielo-entrada`
Método	`POST`	Siempre POST para enviar datos del mensaje
Headers (opcional)	Autenticación si tu webhook la requiere	`X-API-Key: tu_clave_secreta`
Eventos	Qué dispara el webhook	`Mensaje entrante` (recomendado)

Payload que ChatCielo envía a N8N

Cada mensaje genera un POST con JSON similar a este:

{
  "event": "message.received",
  "channelId": "12",
  "protocol": "48291",
  "phoneNumber": "+54 11 1234 5678",
  "name": "María González",
  "email": "maria@ejemplo.com",
  "pushName": "María",
  "message": {
    "id": "wamid.HBgN...",
    "type": "text",
    "text": "Hola, quiero saber el estado de mi pedido",
    "timestamp": "2026-05-13T14:30:00Z"
  },
  "contact": {
    "id": "12345",
    "name": "María González",
    "phoneNumber": "+54 11 1234 5678",
    "email": "maria@ejemplo.com"
  }
}

Variables disponibles en el payload

Variable	Descripción	Ejemplo
`{{protocol}}`	ID de la atención	`48291`
`{{phoneNumber}}`	Número con código país	`+54 11 1234 5678`
`{{name}}`	Nombre del contacto	`María González`
`{{email}}`	Email si existe	`maria@ejemplo.com`
`{{channelId}}`	Canal de origen	`12`
`{{message.text}}`	Texto del mensaje	`Hola, quiero saber...`

Regla de oro: solo una automatización por canal. Si activas N8N vía webhook en un canal, no actives simultáneamente Typebot u otra IA directa en ese mismo canal. Si necesitas combinar, haz que N8N sea la automatización principal y que N8N llame a la IA internamente.

3. Envío bidireccional de mensajes

N8N y ChatCielo se comunican en dos direcciones:

Cada mensaje del cliente dispara tu workflow.

ChatCielo hace POST al webhook de N8N con el JSON del mensaje. En N8N, el nodo Webhook (método POST) recibe el payload y lo pasa al siguiente nodo.

Configuración del nodo Webhook en N8N:

HTTP Method: POST
Path: chatcielo-entrada (o el que definas)
Response Mode: Response Node o Last Node (recomendado: Response Node para controlar la respuesta)

4. Automatizaciones CRM — ejemplos prácticos

Ejemplo 1: Consulta de estado de pedido (ERP)

Webhook (POST) → Set (extrae protocol) → HTTP Request (consulta ERP con protocol)
→ IF (pedido encontrado) → Respond to Webhook ("Tu pedido está en camino...")
→ ELSE → Respond to Webhook ("No encontré tu pedido, te derivo con un asesor. Protocolo {{protocol}}.")

Ejemplo 2: Alta automática en Google Sheets + etiqueta

Webhook → Set (extrae {{name}}, {{phoneNumber}}, {{email}}) → Google Sheets (Append Row)
→ HTTP Request (etiqueta en ChatCielo: "lead-nuevo") → Respond to Webhook ("¡Gracias {{name}}! Te contactamos en breve.")

Ejemplo 3: Calificación con IA + derivación

Webhook → OpenAI / Claude (prompt: "Clasifica este mensaje como: venta, soporte o reclamo. Mensaje: {{$json.message.text}}")
→ Switch (por clasificación) → Si venta → HTTP Request (asigna a departamento Ventas)
→ Si reclamo → HTTP Request (asigna a Soporte + prioridad alta)
→ Respond to Webhook (respuesta acorde a la clasificación)

5. Buenas prácticas

Tiempo de respuesta: N8N debe responder al webhook en menos de 10 segundos. Si tu flujo tarda más (consulta lenta a ERP), responde de inmediato con "Un momento, consulto tu información..." y luego envía el resultado vía POST a la API de ChatCielo (Opción B).
Idempotencia: si el webhook se dispara dos veces por reintento, verifica message.id para no duplicar acciones en tu CRM.
Logs: activa Execution log en N8N para auditar cada ejecución y depurar errores.
Seguridad: protege tu webhook con Header Auth o Basic Auth y valida el header en el nodo Webhook de N8N.
Pruebas: usa el botón Execute Workflow en N8N + cURL (ver tutorial) antes de vincular en producción.

¿Listo para crear tu primer workflow? Sigue el tutorial paso a paso: Crear un proyecto en N8N con Webhook, Set/Code, respuesta y prueba con cURL.

N8N — Automatización Avanzada