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

# Construye sobre iZap

> La plataforma para desarrolladores de automatización de negocios centrada en WhatsApp: una API REST, OAuth 2.0 y un servidor MCP de Analytics para tus agentes.

iZap ejecuta la automatización de negocios centrada en WhatsApp: los asistentes
de IA atienden las conversaciones con los clientes, los pedidos y las citas.
**Aquí es donde construyes sobre esa base**: llama a la API REST o contrólala
desde un agente de IA mediante el servidor MCP. La misma lógica de negocio y la
misma autenticación OAuth 2.0, en todas partes.

<Columns cols={2}>
  <Card title="Obtén un token de acceso y haz tu primera llamada" icon="rocket" href="/es/quickstart" horizontal cta="Empezar el inicio rápido" arrow>
    De cero a una solicitud autenticada en pocos minutos.
  </Card>

  <Card title="Abre el Dashboard" icon="gauge" href="https://dash.izap.ai" horizontal cta="Ir a dash.izap.ai" arrow>
    Gestiona asistentes, negocios y el acceso a la API.
  </Card>
</Columns>

## Tu primera llamada

Intercambia tus credenciales por un JWT y envíalo como token Bearer en cada
solicitud.

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://api.izap.ai/api/v1/auth/jwt/login" \
       -H "Content-Type: application/x-www-form-urlencoded" \
       -d "username=$IZAP_EMAIL&password=$IZAP_PASSWORD"
  # -> {"access_token":"<JWT>","token_type":"bearer"}

  curl "https://api.izap.ai/api/v1/businesses" \
       -H "Authorization: Bearer $IZAP_TOKEN"
  ```

  ```python Python theme={null}
  import os, httpx

  base = "https://api.izap.ai"
  tok = httpx.post(
      f"{base}/api/v1/auth/jwt/login",
      data={"username": os.environ["IZAP_EMAIL"], "password": os.environ["IZAP_PASSWORD"]},
  ).json()["access_token"]

  r = httpx.get(f"{base}/api/v1/businesses", headers={"Authorization": f"Bearer {tok}"})
  print(r.json())
  ```

  ```typescript TypeScript theme={null}
  const base = "https://api.izap.ai";

  const login = await fetch(`${base}/api/v1/auth/jwt/login`, {
    method: "POST",
    headers: { "Content-Type": "application/x-www-form-urlencoded" },
    body: new URLSearchParams({
      username: process.env.IZAP_EMAIL!,
      password: process.env.IZAP_PASSWORD!,
    }),
  });
  const { access_token } = await login.json();

  const res = await fetch(`${base}/api/v1/businesses`, {
    headers: { Authorization: `Bearer ${access_token}` },
  });
  console.log(await res.json());
  ```
</CodeGroup>

<Note>
  Para aplicaciones de terceros, usa el flujo OAuth 2.0 authorization code + PKCE
  en lugar de guardar credenciales. Consulta
  [Autenticación](/es/api-reference/authentication).
</Note>

<Tip>
  Sáltate el código repetitivo: `npx @izap/wizard` genera un cliente REST, MCP,
  de webhooks o SSE funcional en tu stack. Consulta el
  [asistente de configuración](/es/api-reference/wizard).
</Tip>

## Lo que puedes construir

<Columns cols={3}>
  <Card title="API REST" icon="code" href="/es/api-reference/introduction">
    Chats, negocios, plantillas y transmisiones en `/api/v1`. JSON de entrada y
    de salida, versionada y predecible.
  </Card>

  <Card title="Analytics MCP" icon="robot" href="/es/api-reference/mcp">
    Apunta Claude, ChatGPT o tu propio agente a `{origin}/mcp` y llama
    directamente a las herramientas de analítica y de gestión de asistentes.
  </Card>

  <Card title="Autenticación" icon="key" href="/es/api-reference/authentication">
    Un único servidor OAuth 2.0 para la API y el MCP. JWT Bearer para
    servidor a servidor, authorization code + PKCE para aplicaciones
    interactivas.
  </Card>
</Columns>

## Controla iZap desde un agente

Registra el Analytics MCP como servidor HTTP remoto y tu agente podrá llamar a
las herramientas de iZap con el mismo token que la API REST.

```json theme={null}
{
  "mcpServers": {
    "izap": {
      "type": "http",
      "url": "https://api.izap.ai/mcp",
      "headers": { "Authorization": "Bearer ${IZAP_TOKEN}" }
    }
  }
}
```

<Card title="Ver el catálogo completo de herramientas del MCP" icon="list-check" href="/es/api-reference/mcp" horizontal arrow>
  Gestión de asistentes, estadísticas de mensajes, analítica de conversaciones y
  búsqueda por palabra clave.
</Card>

## Entornos

| Entorno | Origen de la API | URL del MCP |
| - | - | - |
| Producción | `https://api.izap.ai` | `https://api.izap.ai/mcp` |
| Staging | `https://api-staging.izap.ai` | `https://api-staging.izap.ai/mcp` |

<Note>
  La API REST está versionada en `/api/v1`; los cambios incompatibles pasan a
  una nueva ruta de versión. La referencia interactiva de **Endpoints** en la
  pestaña de referencia de la API se genera a partir de la especificación
  OpenAPI curada y es la fuente autorizada para los formatos de solicitud y
  respuesta.
</Note>

## Sigue adelante

<Columns cols={3}>
  <Card title="Inicio rápido" icon="rocket" href="/es/quickstart">
    El recorrido completo, del token a la primera llamada.
  </Card>

  <Card title="Estado de la API" icon="signal" href="https://api.izap.ai/status">
    Estado en vivo de la API de producción.
  </Card>

  <Card title="AI Trainer" icon="graduation-cap" href="https://trainer.izap.ai/trainer">
    Entrena y mejora tus asistentes de WhatsApp.
  </Card>
</Columns>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.