Requiere una API key con acceso a la API v2 — disponible en los planes Standard y Premium (ver Introducción a la API).
Conectar tu cuenta
- En ChatNorris, ve a Configuración → API Keys y crea una key. Anótala: solo se muestra una vez.
- En Zapier, busca la app ChatNorris al crear un Zap.
- Pega la API key en el campo API Key de la conexión. Zapier prueba la conexión contra
GET /api/v2/projecty, si es válida, muestra el nombre de tu organización. - Puedes reutilizar la misma conexión en varios Zaps.
Triggers
Los triggers funcionan por polling: Zapier consulta la API en el intervalo que le corresponda según tu plan de Zapier, y deduplica automáticamente los resultados ya vistos.
El campo Agent es un desplegable que trae la lista real de tus agentes (usa
chatbots:read internamente); déjalo vacío para escuchar todos los agentes de la organización.
New Conversation también dispara para conversaciones creadas a través de la propia API (canal
api) — por ejemplo, si otra integración usa la acción Send Message para iniciar una conversación nueva.Acción: Send Message
Envía un mensaje a un agente y espera su respuesta — el mismoPOST /api/v2/chatbots/:id/chat de la API.
La acción devuelve
reply (la respuesta del agente) y conversation_id, que puedes encadenar en el resto del Zap — por ejemplo, para reenviar la respuesta por email o Slack, o para volver a usarla como Conversation ID en un paso posterior y mantener el hilo.
Requiere el scope chat:write.
Scopes que necesita la API key
Si tu Zap combina varios de estos usos, crea la API key con la unión de los scopes correspondientes (o con
* para no tener que administrar scopes por Zap).
Límites conocidos
- No existe un trigger de “nuevo mensaje” dentro de una conversación — solo nueva conversación y nuevo lead.
- No hay una acción para actualizar un lead existente: la API pública v2 no expone ese endpoint todavía.
- Los datos de un lead vienen con los campos base (nombre, email, teléfono, fecha) más
contact_properties(empresa, cargo, ciudad, etc.) ycustom_fields; no vienen aplanados campo por campo salvo que los mapees manualmente en el Zap.
Ver también
- Introducción a la API — autenticación, scopes y formato de respuesta.
- n8n — alternativa self-hosted u open-source a Zapier, con más operaciones (base de conocimiento incluida).

