Integración con n8n

n8n es una herramienta para crear flujos automáticos. Hay dos formas de usarla con Deskwoot. Con un nodo Webhook en n8n, los eventos de Deskwoot, como una conversación nueva, un mensaje nuevo de un cliente o una valoración CSAT, inician tus flujos de n8n, así puedes pasarlos a tu CRM, a una hoja de cálculo o a tus propios sistemas. Además, el nodo de Deskwoot para n8n actúa en Deskwoot: tus flujos responden, agregan notas, asignan, agregan etiquetas y crean o actualizan contactos. También encuentras las dos formas en Configuración > Integraciones > n8n.

Qué plan necesitas

El nodo Webhook recibe sus eventos de un webhook de Deskwoot. Los webhooks necesitan el plan Startup o uno superior, y la prueba gratis los incluye. En el plan gratis Hacker, los webhooks no envían nada.

Un webhook solo envía datos desde Deskwoot hacia afuera. Para que n8n responda a los mensajes de los clientes como un bot, agrega un bot Custom Webhook en Configuración > IA > Más bots, que necesita un plan de pago (Startup o superior). Para responder a los mensajes de los clientes o actuar en Deskwoot desde n8n, usa el nodo de Deskwoot para n8n (más abajo). Cada conversación que n8n responde, como bot o con Reply, cuenta como 1 conversación de IA. Para todo lo que el nodo no hace, como resolver una conversación, llama a la API REST de Deskwoot con el nodo HTTP Request de n8n y un token de API. El nodo y la API REST necesitan un plan Enterprise de pago, y la prueba gratis no incluye acceso a la API. Cómo crear un token: Tokens de API y acceso para desarrolladores.

El nodo Webhook en n8n (Startup o superior)

Configúralo en n8n

1. En n8n, abre tu flujo y agrega un nodo Webhook como primer paso.
2. Pon HTTP Method en POST.
3. Deja Respond en Immediately, para que n8n le responda a Deskwoot al instante.
4. Copia la Production URL del nodo.

Configúralo en Deskwoot

1. Ve a Configuración > Webhooks. Solo los administradores ven esta página.
2. Haz clic en Agregar webhook.
3. Pega la Production URL en URL del endpoint.
4. En Suscribirse a eventos, marca los eventos que necesita tu flujo. Si no marcas ninguno, el webhook recibe todos los eventos.
5. Haz clic en Crear webhook.

Luego publica el flujo en n8n: n8n solo escucha en la Production URL cuando el flujo está publicado. A partir de ese momento, cada evento inicia una ejecución del flujo, y ves las ejecuciones en su pestaña Executions.

Qué llega a n8n

Cada evento llega como una solicitud POST con un cuerpo JSON. En la salida del nodo Webhook, el cuerpo contiene event (el nombre del evento), data (los datos del evento), timestamp y accountId. Los encabezados contienen x-deskwoot-event con el nombre del evento y x-deskwoot-signature. Si un webhook envía varios eventos, haz que el siguiente nodo revise event, por ejemplo un nodo If.

Puedes elegir estos eventos: Conversación creada, Conversación actualizada, Conversación asignada, Conversación resuelta, Mensaje creado, Contacto creado, Contacto actualizado y CSAT enviado. Los datos de cada evento están en la documentación de la API.

Para tener en cuenta

• Deskwoot espera 10 segundos como máximo. Si n8n no responde a tiempo o responde con un error, Deskwoot lo intenta una vez más después de 5 segundos. Con Respond en Immediately, un flujo largo nunca hace esperar a Deskwoot.
• n8n tiene que estar accesible desde internet por HTTPS. Deskwoot solo envía a direcciones HTTPS públicas. Si tienes n8n en tu propio servidor, necesita una dirección HTTPS pública, no una dentro de tu red.
• Usa la Production URL, no la Test URL. Deskwoot sigue enviando a la dirección que guardaste, así que tiene que ser la que n8n escucha mientras el flujo está publicado.

El nodo de Deskwoot para n8n (Enterprise)

El nodo de Deskwoot para n8n es un nodo de la comunidad llamado n8n-nodes-deskwoot. Incluye 2 nodos: el Deskwoot Trigger, que inicia un flujo cuando pasa algo en Deskwoot, y el nodo Deskwoot, que actúa en Deskwoot. Funciona con n8n en tu propio servidor. n8n Cloud solo ofrece nodos de la comunidad que n8n revisó, y este nodo todavía no es uno de ellos.

Instálalo e inicia sesión

1. En n8n, ve a Settings > Community Nodes, haz clic en Install, escribe n8n-nodes-deskwoot e instálalo. Solo el propietario y los administradores de tu n8n ven esta página.
2. En Deskwoot, ve a Configuración > Tokens de API y haz clic en Crear token. Marca los permisos Lectura y Escritura y crea el token. Cópialo: Deskwoot lo muestra una sola vez. Solo los administradores ven esta página.
3. En n8n, crea una credencial Deskwoot API. Pega el token en API Token. En Account ID, escribe el ID que la misma página de Deskwoot muestra como Tu ID de cuenta. Deja Base URL como está.
4. Guarda la credencial. n8n la prueba enseguida: muestra las bandejas de entrada de tu espacio de trabajo.

Si la prueba falla, el token se revocó o venció, el ID de cuenta pertenece a otro espacio de trabajo, el espacio de trabajo no tiene el plan Enterprise o al token le falta el permiso Lectura. Un token MCP para agentes de IA no funciona aquí: crea un token de la API REST en Configuración > Tokens de API.

Deskwoot Trigger

Elige uno de estos eventos en Event:

• Conversation Created: empieza una conversación, ya sea porque un cliente escribió o porque tu equipo la inició.
• Customer Message Received: un cliente escribe en una conversación. Las respuestas y las notas de tu equipo no cuentan.
• Conversation Assigned: una conversación tiene un nuevo responsable. El Round Robin en una conversación nueva y las reglas de automatización no lo activan.
• Conversation Resolved: una conversación se marca como resuelta.
• Contact Created: alguien del equipo agrega un contacto en Deskwoot, o una app lo agrega por la API. Los contactos que Deskwoot crea a partir de mensajes entrantes activan Conversation Created en su lugar.
• Conversation Rated: un cliente valora una conversación en la encuesta de satisfacción.

Cada evento llega como un solo elemento con campos simples. Una conversación llega con su ID, número, enlace, estado, asunto, canal, bandeja de entrada, responsable, equipo, etiquetas, el nombre, la dirección de correo y el número de teléfono del cliente, y el primer mensaje del cliente.

Cuando publicas el flujo, el trigger suscribe su Production URL al evento en Deskwoot, y cuando dejas de publicarlo, el trigger quita esa suscripción. Deskwoot firma cada evento y el trigger revisa la firma, así nadie más puede iniciar tu flujo a través de su URL. El trigger necesita:

• Un token que haya creado un administrador. Solo un token así puede activar los triggers de Deskwoot.
• n8n accesible desde internet por HTTPS. Si n8n funciona detrás de un proxy inverso, pon su dirección pública en la variable WEBHOOK_URL de n8n.

Nodo Deskwoot

Elige Resource y Operation:

• Conversation > Start: envía un primer mensaje a un contacto desde una de tus bandejas de entrada, por dirección de correo, número de teléfono o ID de contacto. Funciona donde una empresa puede escribir primero, como el correo o los SMS. Deskwoot rechaza un inicio que el canal no puede entregar (un chat en vivo, WhatsApp sin una plantilla aprobada, o un usuario de Telegram, LINE o X que nunca le escribió a esa bandeja de entrada), y el nodo muestra el motivo. La conversación nueva cuenta como 1 conversación de IA.
• Conversation > Reply: envía una respuesta al cliente por el canal de la conversación. Cada conversación que responde cuenta como 1 conversación de IA. Cuando se te acaban las conversaciones de IA y tu saldo prepago no alcanza para pagar otra, Deskwoot rechaza la respuesta en una conversación que todavía no se contó este mes.
• Conversation > Add Private Note: agrega una nota que solo ve tu equipo.
• Conversation > Assign: asigna una conversación a alguien del equipo, a un equipo o a ambos.
• Conversation > Add Label: agrega una de tus etiquetas a una conversación.
• Contact > Create or Update: actualiza el contacto que tiene esta dirección de correo, o lo crea si no existe.
• Contact > Find: devuelve un solo contacto, el que mejor coincide con una dirección de correo, un número de teléfono o un nombre.

Puedes tomar el ID de la conversación de la salida del Deskwoot Trigger. Las respuestas y las notas que vienen de n8n muestran el nombre de la persona que creó el token de API. El nodo también funciona como herramienta para los agentes de IA de n8n.

Preguntas frecuentes

¿Qué plan necesito?

Startup o superior para el webhook que inicia tus flujos, y la prueba gratis lo incluye. Un bot Custom Webhook, que permite que n8n responda a tus clientes, necesita un plan de pago (Startup o superior). El nodo de Deskwoot para n8n y la API REST necesitan un plan Enterprise de pago, y la prueba gratis no incluye acceso a la API. Cada conversación que n8n responde cuenta como 1 conversación de IA.

¿Por qué no se inicia mi flujo?

Revisa que el flujo esté publicado en n8n, que el webhook en Deskwoot tenga la Production URL y no la Test URL, que el evento esté marcado (o que no haya ninguno marcado) y que n8n esté accesible desde internet por HTTPS. En el plan gratis Hacker, los webhooks no envían absolutamente nada.

¿Puede n8n cambiar algo en Deskwoot?

Sí, con el nodo de Deskwoot para n8n en el plan Enterprise: responde, agrega notas privadas, asigna, agrega etiquetas, inicia conversaciones y crea o actualiza contactos. Para cualquier otra cosa, como resolver una conversación, llama a la API REST con el nodo HTTP Request de n8n, también en Enterprise. El webhook solo envía eventos hacia afuera. Sin Enterprise, un bot Custom Webhook en Configuración > IA > Más bots (Startup o superior) permite que n8n responda a los mensajes de los clientes como un bot. Cada conversación que n8n responde con Reply o como bot cuenta como 1 conversación de IA, mientras que las notas, las asignaciones, las etiquetas y los contactos nunca cuentan.

¿Por qué no puedo publicar un flujo con el Deskwoot Trigger?

Solo un token de API que haya creado un administrador puede activar los triggers de Deskwoot, porque un trigger recibe los eventos de todas las conversaciones, igual que un webhook. Crea un token como administrador y úsalo en la credencial Deskwoot API. Además, n8n tiene que estar accesible desde internet por HTTPS, y un espacio de trabajo puede tener como máximo 100 de estas suscripciones, sumadas con los triggers de la app de Deskwoot para Zapier.

¿Qué pasa si revoco el token?

Todos los triggers que activó ese token se detienen de inmediato, y las acciones del nodo fallan. Crea un token nuevo, actualiza la credencial Deskwoot API y luego deja de publicar el flujo y vuelve a publicarlo.

¿Cómo sé que un evento viene de verdad de Deskwoot?

Cada solicitud lleva un encabezado x-deskwoot-signature: sha256= seguido del HMAC SHA256 en hexadecimal del cuerpo sin procesar, firmado con el secreto del webhook. El Deskwoot Trigger lo revisa por ti. Para el nodo Webhook, el panel no muestra ese secreto, así que trata la Production URL como una contraseña: n8n le da una ruta aleatoria, y solo Deskwoot debería conocerla. Un webhook creado a través de la API REST devuelve su secreto una sola vez en la respuesta.

¿Funciona con n8n Cloud?

El nodo Webhook funciona en n8n Cloud y en n8n en tu propio servidor. El nodo de Deskwoot para n8n solo funciona con n8n en tu propio servidor, porque n8n Cloud solo ofrece nodos de la comunidad que n8n revisó. En tu propio servidor, n8n necesita una dirección HTTPS pública para que Deskwoot pueda llegar a él.

¿Puedo iniciar varios flujos?

Sí. Crea un webhook en Deskwoot para la Production URL de cada flujo, cada uno con sus propios eventos. Con el nodo de Deskwoot, cada flujo publicado con un Deskwoot Trigger obtiene su propia suscripción.

¿Qué pasa si n8n deja de funcionar un rato?

Los eventos de ese tiempo se pierden después del único reintento, porque Deskwoot no guarda nada más allá de eso. En Enterprise puedes ponerte al día con la API REST, por ejemplo, listando las conversaciones ordenadas por la actividad más reciente.