> 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.md).

# Introducción

Referencia de la API de Anunzi - una sola API Key para operar tu cuenta, tus agentes y tus llamadas de voz con el motor VPower.

Con la **API de Anunzi** integras tu cuenta con tus sistemas: CRM, ERP, formularios, automatizaciones (Zapier, Make, n8n) o tu propio software. **Una sola API Key** te da acceso a todo lo que haces desde el panel: contactos, agentes, llamadas, mensajes, campañas, créditos y webhooks.

***

## Empieza en 3 pasos

1. **Genera tu API Key** desde el panel: menú de tu usuario → **API Keys**. Más detalle en [API Keys de cuenta](/anunzi-ia-documentation/api-de-anunzi/api/api-keys.md).
2. **Envíala en cada solicitud**, en el encabezado:

   ```
   Authorization: Bearer anz_live_TU_API_KEY
   ```
3. **Elige el módulo** que necesitas en la tabla de abajo.

Cada operación queda **limitada automáticamente a tu cuenta** (y a las de tus clientes, si eres partner): no puedes ver ni modificar datos de otras cuentas.

***

## Qué puedes hacer

La API se organiza en dos partes, con la misma API Key:

| Parte                                                                      | URL base                            | Para qué                                                                                                                                         |
| -------------------------------------------------------------------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| [**Plataforma**](/anunzi-ia-documentation/api-de-anunzi/v1.md)             | `https://panel.anunzi.net/api/v1/…` | Contactos, agentes, historial de llamadas con auditoría, WhatsApp, campañas, créditos y webhooks.                                                |
| [**Llamadas de voz**](/anunzi-ia-documentation/api-de-anunzi/api-calls.md) | `https://calls.anunzi.net/…`        | Llamar en tiempo real: crear llamadas telefónicas y web, controlarlas, y configurar a fondo tus agentes de voz (prompt, modelo, funciones, voz). |

### ¿Cuál uso?

| Quiero…                                                                  | Usa                                                                                                                        |
| ------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------- |
| Crear o actualizar contactos, importar una lista, agregar notas          | [Plataforma → Contactos](/anunzi-ia-documentation/api-de-anunzi/v1/contacts.md)                                            |
| Que mi agente llame a alguien ahora mismo                                | [Llamadas de voz → Crear llamada telefónica](/anunzi-ia-documentation/api-de-anunzi/api-calls/crear-llamada-telefonica.md) |
| Poner un botón "hablar con el agente" en mi web o app                    | [Llamadas de voz → Crear llamada web](/anunzi-ia-documentation/api-de-anunzi/api-calls/crear-llamada-web.md)               |
| Lanzar una campaña de llamadas o WhatsApp a muchos contactos             | [Plataforma → Campañas](/anunzi-ia-documentation/api-de-anunzi/v1/campaigns.md)                                            |
| Enviar un WhatsApp (texto o plantilla)                                   | [Plataforma → Mensajería](/anunzi-ia-documentation/api-de-anunzi/v1/messages.md)                                           |
| Ver el historial de llamadas con resumen, datos extraídos y auditoría    | [Plataforma → Llamadas](/anunzi-ia-documentation/api-de-anunzi/v1/calls.md)                                                |
| Consultar el estado de una llamada puntual (en curso o terminada)        | [Llamadas de voz → Obtener llamada](/anunzi-ia-documentation/api-de-anunzi/api-calls/obtener-llamada.md)                   |
| Cambiar el prompt, el modelo, las funciones o la voz de un agente de voz | [Llamadas de voz → Agentes de voz](/anunzi-ia-documentation/api-de-anunzi/api-calls/gestionar-agentes.md)                  |
| Activar o pausar un agente                                               | [Plataforma → Agentes](/anunzi-ia-documentation/api-de-anunzi/v1/agents.md)                                                |
| Recibir un aviso cuando termina una llamada o entra un contacto nuevo    | [Plataforma → Webhooks](/anunzi-ia-documentation/api-de-anunzi/v1/webhooks.md)                                             |
| Ver mi saldo o (partner) asignar créditos a un cliente                   | [Plataforma → Créditos](/anunzi-ia-documentation/api-de-anunzi/v1/credits.md)                                              |

***

## Motor de voz VPower

Las llamadas de voz funcionan con **VPower**, el motor de voz de Anunzi. Todos los agentes nuevos se crean en VPower y los existentes se van pasando sin cambiar su `agent_id`, sus números ni las rutas de la API.

> ⚠️ **El motor de voz anterior está deprecado.** Sus agentes siguen funcionando mientras terminamos el pase, pero las funciones nuevas de la API (gestión de agentes, prompt, modelo, funciones, voces) solo están disponibles en VPower. Si tu integración usa llamadas web, revisa la [guía de migración a VPower](/anunzi-ia-documentation/api-de-anunzi/api-calls/migrar-a-vpower.md).

***

## Convenciones

* **Formato:** las solicitudes y respuestas son JSON (UTF-8).
* **Errores:** el código HTTP refleja el resultado: `400` datos inválidos · `401` API Key ausente o inválida · `402` sin créditos o prueba vencida · `403` fuera del alcance de tu cuenta · `404` no encontrado · `409` conflicto (por ejemplo, un agente que todavía no está en VPower) · `429` límite de solicitudes o de líneas simultáneas · `500` error del servidor.
* **Llamadas simultáneas:** cada plan tiene un límite de líneas en uso a la vez; si lo superas, la API responde `429`. Ver [Suscripción](/anunzi-ia-documentation/suscripcion/suscripcion.md).
* **Créditos:** las llamadas, mensajes y campañas que lanzas por API consumen créditos igual que desde el panel. Ver [Créditos](/anunzi-ia-documentation/creditos/creditos.md).

***

## Webhooks y eventos

Además de consultar la API, puedes **recibir eventos** en tu servidor:

* **Webhooks de la plataforma** (contacto nuevo, ticket, llamada finalizada): [Plataforma → Webhooks](/anunzi-ia-documentation/api-de-anunzi/v1/webhooks.md).
* **Webhook por agente de voz** (inicio, fin y análisis de cada llamada, a elección): se configura en la ficha del agente. Ver [Ficha del agente](/anunzi-ia-documentation/agentes-de-voz/agentes-de-llamada/ficha-del-agente.md).
* **Funciones de tu agente que llaman a tu API** durante la conversación: [Funciones webhook](/anunzi-ia-documentation/agentes-de-voz/agentes-de-llamada/funciones-webhook.md) y [Funciones de código](/anunzi-ia-documentation/agentes-de-voz/agentes-de-llamada/funciones-de-codigo.md).

***

## Partners

Si eres partner, tu API Key alcanza también las cuentas de tus clientes: puedes operar sus agentes, contactos y llamadas, y asignarles créditos desde [Plataforma → Créditos](/anunzi-ia-documentation/api-de-anunzi/v1/credits.md).

***

## Endpoints anteriores

Los endpoints autenticados con el token de cada agente siguen funcionando pero están deprecados: [Endpoints por token de agente (legacy)](/anunzi-ia-documentation/api-de-anunzi/token-de-agente.md).