Superchat se conecta a n8n mediante webhooks, lo que te permite activar flujos de trabajo automáticamente en función de eventos en Superchat, como la creación de un nuevo contacto o la apertura de una conversación. Este artículo cubre los pasos de configuración, un ejemplo práctico y consejos comunes para solucionar problemas.
Antes de empezar
Asegúrate de tener lo siguiente antes de comenzar:
Una cuenta activa de Superchat
Una instancia de n8n funcional (en la nube o autoalojada)
Conocimientos básicos sobre cómo crear flujos de trabajo y añadir nodos en n8n
Conectar Superchat a n8n
En n8n, crea un nuevo flujo de trabajo y añade un nodo Webhook como desencadenador
Establece el método HTTP en POST y copia la URL del Webhook de prueba
En Superchat, ve a Configuración → Integraciones → Webhooks y crea un nuevo webhook
Pega la URL del webhook de n8n en el campo URL y selecciona el(los) evento(s) que deseas que activen el flujo de trabajo
Regresa a n8n y haz clic en Escuchar evento de prueba
Activa el evento seleccionado en Superchat (por ejemplo, crea un nuevo contacto) para enviar una carga de prueba a n8n
Una vez que n8n reciba la carga, verás los datos entrantes en el editor: tu conexión está funcionando
URL de prueba vs. URL de producción
n8n genera dos URLs separadas para cada nodo Webhook: una URL de prueba y una URL de producción.
La URL de prueba solo recibe datos mientras hayas hecho clic en Escuchar evento de prueba en el editor de n8n. Es solo para desarrollo y depuración, y caduca después de 120 segundos.
La URL de producción es la que debes pegar en Superchat una vez que tu flujo de trabajo esté listo. Solo se activa después de guardar y activar tu flujo de trabajo usando el interruptor en la esquina superior derecha del lienzo de n8n. Si tu flujo de trabajo no está activado, los eventos de Superchat no activarán nada.
¿Qué datos envía Superchat?
Cuando se activa un evento de webhook, Superchat envía una carga JSON a n8n con detalles sobre el evento. Para una referencia completa de los campos incluidos para cada tipo de evento, consulta el Modelo de Objeto de Webhook de Superchat en la documentación para desarrolladores.
Para inspeccionar una carga en vivo durante el desarrollo, usa la URL de prueba, activa un evento en Superchat y visualiza la salida sin procesar directamente en el editor de n8n.
Ejemplo práctico: añadir un nuevo contacto de Superchat a Google Sheets
Este ejemplo crea una nueva fila en una hoja de Google Sheets cada vez que se crea un contacto en Superchat.
Configura el nodo Webhook como se describió anteriormente y envía un evento de prueba desde Superchat para que n8n tenga datos de muestra con los que trabajar
Añade un nodo Google Sheets y conéctalo al nodo Webhook
Establece la operación en Añadir fila
Selecciona tu hoja de cálculo y hoja de destino
Mapea los campos de la carga de Superchat a las columnas relevantes. Consulta el Modelo de Objeto de Webhook para conocer los nombres exactos de los campos
Haz clic en Probar paso para verificar que se crea una fila correctamente
Una vez confirmado, cambia el nodo Webhook a la URL de producción, guarda el flujo de trabajo y actívalo
Tu flujo de trabajo ahora se ejecutará automáticamente cada vez que se cree un nuevo contacto en Superchat.
Solución de problemas
El flujo de trabajo no se activa
Verifica que tu flujo de trabajo esté activado y que la URL de producción —no la URL de prueba— esté guardada en Superchat.
Los datos llegan, pero los campos están vacíos
Abre el panel de Ejecuciones en n8n (barra lateral izquierda) para inspeccionar la carga sin procesar recibida. Esto muestra exactamente lo que envió Superchat y ayuda a identificar cualquier problema de mapeo.
El evento de prueba no se recibe
Asegúrate de haber hecho clic en Escuchar evento de prueba en n8n antes de activar el evento en Superchat. La URL de prueba caduca después de 120 segundos; si ha expirado, haz clic nuevamente antes de reintentarlo.