Skip to main content

API Pública v2

La API v2 de ChatNorris te permite integrar y automatizar tu plataforma de agentes IA desde cualquier aplicación externa. Puedes gestionar agentes, enviar mensajes, leer conversaciones, leads y más. Base URL:
El acceso a la API está disponible en los planes Standard y Premium. Para habilitarlo, necesitas una API key activa. En el plan Free, la sección de API keys aparece bloqueada — al intentar crear una key se te redirige a la página de planes.

Generar una API key

  1. Ingresa a tu cuenta y ve a Configuración → API Keys.
  2. Haz clic en + Nueva API key.
  3. Asígnale un nombre descriptivo (ej. “Integración CRM”).
  4. Selecciona los scopes que necesitas (ver más abajo).
  5. Copia la key generada — se muestra una sola vez. Guárdala en un lugar seguro.
Si pierdes la key, debes eliminarla y crear una nueva.
La API v2 es también la base de las integraciones externas listadas en la página de Integraciones, como Zapier: no hay una app dedicada, se conecta usando tu API key y los endpoints de esta referencia (por ejemplo chat:write para disparar respuestas del agente desde un Zap).

Autenticación

Todas las requests deben incluir la API key en el header Authorization como Bearer token:
Las requests sin key o con key inválida reciben 401 Unauthorized.

Scopes

Cada API key tiene uno o más scopes que limitan qué endpoints puede usar. Al crear la key, eliges los permisos que necesitas: Los endpoints de proyecto, miembros y uso no requieren scope específico — solo autenticación válida. Si la key no tiene el scope necesario, la respuesta es 403 INSUFFICIENT_SCOPE.

Formato de respuesta

Todas las respuestas son JSON con la siguiente estructura:

Éxito

Éxito con paginación

Error


Paginación

Los endpoints de listado soportan paginación mediante query params:

Códigos de error


Límite de tasa (Rate limiting)

La API permite 300 requests por minuto por API key. Cuando se supera el límite, la respuesta incluye el header Retry-After con los segundos que hay que esperar antes de reintentar.