# 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://api.anunzi.com
```

***

## 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 →](/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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.anunzi.net/api-widgets/api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.