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
- Ingresa a tu cuenta y ve a Configuración → API Keys.
- Haz clic en + Nueva API key.
- Asígnale un nombre descriptivo (ej. “Integración CRM”).
- Selecciona los scopes que necesitas (ver más abajo).
- Copia la key generada — se muestra una sola vez. Guárdala en un lugar seguro.
Autenticación
Todas las requests deben incluir la API key en el headerAuthorization como Bearer token:
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 headerRetry-After con los segundos que hay que esperar antes de reintentar.

