Documentación
API de Anunzi.md

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

Pantalla API Keys
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":"+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.
Esc