> For the complete documentation index, see [llms.txt](https://anunzi-ai.gitbook.io/anunzi-docs/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-docs/api-widgets/api.md).

# Introducción

Anunzi ofrece una API REST que te permite integrar la plataforma con tus propias aplicaciones, CRMs o flujos de automatización. A través de la API puedes controlar agentes, iniciar llamadas, consultar conversaciones y mucho más, de forma programática.

***

## ¿Para qué usar la API?

* 🔗 **Integrar con tu CRM** — envía contactos directamente a campañas o agentes.
* 📞 **Iniciar llamadas desde tu sistema** — dispara llamadas de voz sin usar el panel.
* 📊 **Consultar registros** — descarga historial de llamadas, transcripciones y resultados para análisis.
* 🤖 **Automatizar flujos** — conecta Anunzi con herramientas como Zapier, Make o scripts propios.

***

## Autenticación

Todas las solicitudes a la API deben incluir un token de autenticación en el encabezado HTTP:

```
Authorization: Bearer TU_TOKEN_AQUÍ
```

Existen dos tipos de token:

| Tipo                     | Dónde encontrarlo                  | Alcance                                      |
| ------------------------ | ---------------------------------- | -------------------------------------------- |
| **API Token de cuenta**  | Configuración de tu cuenta         | Acceso general a la API principal            |
| **API Token del agente** | Ficha del agente → sección Resumen | Acceso a los datos específicos de ese agente |

***

## Base URL

Todas las solicitudes se realizan a:

```
https://panel.anunzi.net
```

***

## Secciones de la API

La documentación técnica completa está organizada en las siguientes secciones:

* **Agentes** — crear, listar, actualizar y eliminar agentes de voz.
* **Llamadas** — iniciar llamadas, consultar registros y transcripciones.
* **Acciones** — configurar acciones que el agente puede ejecutar durante una llamada.
* **Bases de conocimiento** — subir y gestionar documentos que el agente consulta.
* **Números** — listar los números de teléfono disponibles en tu cuenta.
* **Voces** — consultar las voces disponibles para tus agentes.
* **WebSocket** — integración en tiempo real para escuchar eventos de llamadas en vivo.

***

## Consultar llamadas desde el panel

Si lo que necesitas es exportar o analizar los registros de llamadas de un agente específico usando su token, consulta la guía:

* [Consultar llamadas del sistema →](/anunzi-docs/api-widgets/consultar-llamadas.md)

***

> 💡 Si eres partner de Anunzi, puedes usar la API para construir integraciones personalizadas para tus clientes o automatizar la creación de agentes en nombre de sus cuentas. Contáctate con el equipo de Anunzi para conocer los alcances disponibles para cuentas partner.