Skip to main content
ChatNorris publica un community node para n8n (n8n-nodes-chatnorris, código abierto, MIT). A diferencia de Zapier —donde armas la lógica pieza por pieza contra un puñado de triggers y una acción—, el node de n8n cubre la API v2 casi por completo: agentes, mensajes, conversaciones, leads y base de conocimiento, con paginación real y filtros por fecha.
Requiere una API key con acceso a la API v2 — disponible en los planes Standard y Premium (ver Introducción a la API).

​
Instalar el node

  1. En tu instancia de n8n, ve a Settings → Community Nodes → Install.
  2. Escribe el nombre del paquete: n8n-nodes-chatnorris.
  3. Confirma la instalación. Si usas n8n Cloud con nodes de la comunidad restringidos, pídele a tu administrador que lo habilite (más detalle en la documentación de n8n sobre community nodes).

​
Configurar la credencial

  1. En ChatNorris, ve a Configuración → API Keys y crea una key.
  2. En n8n, crea una credencial de tipo ChatNorris API.
  3. Pega la key en API Key. El campo Base URL viene con https://app.chatnorris.ai por defecto — solo lo cambias si usas un entorno propio.
  4. La credencial se autentica siempre con Authorization: Bearer <key> y se prueba contra GET /api/v2/project.

​
Scopes según lo que vayas a usar

El desplegable de agentes y ambos triggers usan chatbots:read, inclúyelo siempre en la key.

​
Node “ChatNorris” (acciones)

  • Las operaciones de listado soportan Return All o Limit, con paginación automática (100 items por página) — no hace falta armar un loop manual.
  • El adjunto de Send Message tiene que ser una URL devuelta por POST /api/v2/chatbots/:id/attachments (subir el archivo es un paso previo, no algo que resuelva este node por sí solo).
  • No hay operación para actualizar un lead: la API v2 no expone ese endpoint todavía.

​
Node “ChatNorris Trigger” (polling)

Eventos: New Lead y New Conversation, con un filtro opcional de agente.
  • Usa created_after y guarda un cursor en los datos estáticos del workflow. Recorre todas las páginas necesarias en cada poll para no perder nada entre una consulta y la siguiente, y deduplica por id.
  • Emite los items de más viejo a más nuevo.
  • La primera vez que activas el workflow, el trigger solo registra el punto de partida —no emite todo el histórico existente.
  • Un “Execute step” manual devuelve el item más reciente, útil para mapear campos sin esperar al próximo poll real.
  • New Conversation también incluye conversaciones creadas a través de la propia API (canal api), por ejemplo las que arranca la operación Send Message.

​
Workflows de ejemplo

  • Nuevo lead → CRM o aviso en chat interno: ChatNorris Trigger (New Lead) → tu CRM o Slack, usando {{$json.email}} y {{$json.contact_properties.company}}.
  • Responder desde otro canal: Webhook → ChatNorris (Message → Send) → responder con {{$json.reply}}, guardando el conversation_id para continuar el hilo en el siguiente mensaje.
  • Mantener la base de conocimiento al día: Schedule → ChatNorris (Knowledge Source → Add, URL) para indexar una página cada semana.

​
Ver también