API Keys de cuenta

La API Key de cuenta es tu credencial para la API de Anunzi. 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

API Keys: generas una key con un nombre de referencia y ves cómo usarla.

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	https://panel.anunzi.net/api/v1/…	Contactos, agentes, historial de llamadas, mensajería, campañas, créditos y webhooks.
Llamadas de voz	https://calls.anunzi.net/…	Crear y controlar llamadas en tiempo real y configurar tus agentes de voz.

---

Ejemplos

Listar contactos con una etiqueta (plataforma)

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)

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)

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":"[phone]","to_number":"[phone]","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.