> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getnexor.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Primeros Pasos

La API de Nexor está centrada en los leads. Creas y gestionas leads, los asignas a agentes automatizados, rastreas sus conversiones y les envías mensajes a través de canales, todo impulsado por agentes de IA para llamadas, mensajería y alcance multicanal.

## URL Base

| Entorno        | URL                                  |
| -------------- | ------------------------------------ |
| **Producción** | `https://api.getnexor.ai/api/public` |

Cada solicitud se autentica con el header `X-API-Key`. Consulta [Autenticación](/docs/es/api/authentication) para saber cómo obtener y administrar tu key.

## Inicio Rápido

### 1. Obtener tu API key

Tu key vive en el dashboard de Nexor en Settings, luego Integrations. Consulta [Autenticación](/docs/es/api/authentication) para los pasos completos. Las keys tienen el prefijo `nxr_live_`.

### 2. Crear un lead

```bash theme={null}
curl -X POST https://api.getnexor.ai/api/public/leads \
  -H "Content-Type: application/json" \
  -H "X-API-Key: nxr_live_your_api_key" \
  -d '{
    "first_name": "Tony",
    "last_name": "Stark",
    "email": "tony.stark@gmail.com",
    "phone": "+1234567890",
    "workflow_id": "your-workflow-uuid"
  }'
```

El lead será automáticamente inscrito en la secuencia de cadencia del agente y comenzará a recibir alcance impulsado por IA.

## 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

Toda solicitud tiene un límite de **300 solicitudes por minuto por dirección IP**. Las que superen ese límite reciben `429 Too Many Requests`.

Las keys MCP tienen además un límite propio de **120 solicitudes por minuto** (mayor en algunos planes). Las keys REST no están sujetas a ese segundo límite: para ellas el único que aplica es el de IP.

Cualquier `429` incluye `Retry-After` en segundos — respétalo en lugar de reintentar con un temporizador fijo. Las respuestas a keys MCP incluyen además `X-RateLimit-Limit`, `X-RateLimit-Remaining` y `X-RateLimit-Reset` en cada solicitud, para que puedas frenar antes de que te bloqueen.

## Especificación OpenAPI

La especificación completa OpenAPI está disponible en [`/openapi.json`](/openapi.json) para uso con clientes de API y generadores de código.