> For the complete documentation index, see [llms.txt](https://anunzi-ai.gitbook.io/anunzi-ia-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://anunzi-ai.gitbook.io/anunzi-ia-documentation/api-de-anunzi/api/api-keys.md).

# API Keys de cuenta

La **API Key de cuenta** es tu credencial para la [API de Anunzi](/anunzi-ia-documentation/api-de-anunzi/api.md). Una sola key cubre **toda tu cuenta**: la API de plataforma (contactos, agentes, llamadas, mensajería, campañas, créditos, webhooks) y la API de llamadas de voz. Si eres **partner**, la key también alcanza a las cuentas de tus clientes.

***

## Generar una API Key

<figure><img src="https://2698388972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB7CkCW0NVgMgpks83pD1%2Fuploads%2Fgit-blob-f280c01f15b8b5c579ebd2d2351bf88c4ce01a5d%2Fapi-keys.png?alt=media" alt="Pantalla API Keys"><figcaption><p>API Keys: generas una key con un nombre de referencia y ves cómo usarla.</p></figcaption></figure>

1. En el panel, abre el menú de tu usuario (arriba a la derecha) y entra en **🔑 API Keys**.
2. Escribe una **referencia** (por ejemplo, "Integración CRM") y toca **Generar API key**.
3. Copia la key en ese momento: por seguridad se muestra **una sola vez**. Si la pierdes, genera una nueva y revoca la anterior.

> Las keys tienen el formato `anz_live_…`. Se guardan cifradas: Anunzi nunca puede volver a mostrarte el valor completo, solo una pista (`anz_live_ab12…cd`).

La sección **API Keys** está disponible para todas las cuentas.

***

## Usar la API Key

Envía la key en el encabezado de autorización de cada solicitud:

```
Authorization: Bearer anz_live_TU_API_KEY
```

| Parte de la API                                                            | URL base                            | Para qué                                                                              |
| -------------------------------------------------------------------------- | ----------------------------------- | ------------------------------------------------------------------------------------- |
| [**Plataforma**](/anunzi-ia-documentation/api-de-anunzi/v1.md)             | `https://panel.anunzi.net/api/v1/…` | Contactos, agentes, historial de llamadas, mensajería, campañas, créditos y webhooks. |
| [**Llamadas de voz**](/anunzi-ia-documentation/api-de-anunzi/api-calls.md) | `https://calls.anunzi.net/…`        | Crear y controlar llamadas en tiempo real y configurar tus agentes de voz.            |

***

## Ejemplos

**Listar contactos con una etiqueta** (plataforma)

```bash
curl "https://panel.anunzi.net/api/v1/contacts/list.php?tag=VIP&limit=20" \
  -H "Authorization: Bearer anz_live_TU_API_KEY"
```

**Ver tu saldo de créditos** (plataforma)

```bash
curl "https://panel.anunzi.net/api/v1/credits/balance.php" \
  -H "Authorization: Bearer anz_live_TU_API_KEY"
```

**Crear una llamada telefónica** (llamadas de voz)

```bash
curl -X POST "https://calls.anunzi.net/v2/create-phone-call" \
  -H "Authorization: Bearer anz_live_TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from_number":"+14157774444","to_number":"+5491123456789","dynamic_variables":{"nombre":"Juan"}}'
```

> Cada operación queda limitada a los agentes y datos de tu cuenta (y de tus clientes, si eres partner). Un agente o una llamada de otra cuenta devuelve **403**.

***

## Alcance y seguridad

* Cada operación queda **limitada automáticamente a tu cuenta**. Si eres partner, alcanza también a tus clientes. No puedes operar sobre datos de otras cuentas.
* Tu integración solo usa la API Key de Anunzi: nunca maneja credenciales de otros servicios.
* Puedes **revocar** una key en cualquier momento desde la misma sección. Las integraciones que la usen dejan de funcionar al instante; genera una nueva para reemplazarla.
* Trata tu API Key como una contraseña: no la publiques ni la incluyas en código que corra en el navegador o en una app.

***

## Rotación

Para cambiar una key sin cortes:

1. Genera una **nueva** API Key.
2. Actualiza tu integración con la nueva key.
3. **Revoca** la key anterior.