Elige una interfaz
Las claves REST y MCP deben permanecer en un servidor confiable o en la configuración secreta del cliente MCP. Nunca incluyas ninguna de ellas en JavaScript entregado al navegador. Una clave publicable es visible en el navegador, está destinada a Chat web y no es una credencial REST general. La opción
requestContact del SDK v0.1.44 no está soportada en sitios públicos no confiables mientras esté pendiente el refuerzo del backend; consulta Chat web.
URL Base
Las solicitudes REST directas se autentican con el header
X-API-Key. Consulta Autenticación para saber cómo elegir, obtener y administrar una clave.
Inicio Rápido
1. Obtener tu API key
Crea y administra las claves REST en Configuración → Claves API dentro de Nexor. Consulta Autenticación para conocer todos los pasos. Las claves REST comienzan connxr_live_ y están diseñadas para integraciones entre servidores.
2. Crear un lead
workflow_id identifica a un agente activo, Nexor crea el lead y lo inscribe en ese agente. La respuesta incluye workflow_run si la inscripción funciona o una advertencia si el lead se creó, pero la inscripción falló.
Qué puedes hacer
- Crear y gestionar leads. Agrega leads individualmente o de forma masiva, actualiza su información y almacena metadata personalizada.
- Asignar agentes. Inscribe leads en agentes automatizados de alcance impulsados por IA con cadencias multicanal.
- Rastrear conversiones. Registra resultados de negocio como reservas y ventas cerradas con metadata de campos personalizados.
- Enviar mensajes. Envía mensajes de WhatsApp (texto o template), emails o activa llamadas telefónicas con IA a cualquier lead.
Límites de Tasa
El tráfico externo estándar de la API tiene un límite de 300 solicitudes por minuto por dirección IP. Las solicitudes que superen ese límite reciben429 Too Many Requests.
Las keys MCP tienen además un límite propio de 600 solicitudes por minuto. Las keys REST no están sujetas a ese segundo límite. Para ellas solo aplica el límite por IP.
Las respuestas de límite por IP y de límite por clave MCP incluyen Retry-After en segundos. Respétalo en lugar de reintentar con un temporizador fijo. Cuando funciona el limitador por clave MCP, también agrega X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset a la respuesta.
Especificación OpenAPI
La especificación OpenAPI está disponible en/openapi.json.
La especificación actual publica 259 operaciones REST para clientes a partir de un inventario fijado de 307 operaciones de rutas públicas. Las otras 48 se omiten de forma intencional porque corresponden a administración interna o infraestructura, transporte para navegador, alias de compatibilidad, experimentos con feature flag u operaciones cuyo comportamiento actual no es lo bastante seguro o confiable para presentarlo como un contrato soportado. Dieciocho entradas obsoletas o excluidas del conjunto de referencia anterior ya no aparecen en la navegación.