# Endpoints por token de agente (legacy)

> 💡 Esta sección documenta los endpoints originales, autenticados con el **token de cada agente**. Para la API completa y organizada por módulos (contactos, agentes, llamadas, mensajería, campañas, créditos, webhooks), usá la **[API de plataforma v1](v1/README.md)** con tu [API Key de cuenta](api-keys.md). Estos endpoints siguen funcionando y aceptan también la key de cuenta.

La **API de la plataforma** de Anunzi te permite integrar tu cuenta con tus propias aplicaciones, CRMs o flujos de automatización. Desde aquí consultas los datos operativos de tu cuenta —registros de llamadas del sistema, contactos y notas, y tickets de soporte— de forma programática.

> 📞 Para **controlar llamadas de voz** (crear, listar, detener, etc.), consulta la sección [**API de Llamadas (voz)**](../api-calls/README.md).

***

## ¿Para qué usar la API de la plataforma?

* 🔗 **Integrar con tu CRM** — consulta contactos y notas para sincronizarlos con tu sistema.
* 📊 **Consultar registros** — descarga el historial de llamadas del sistema, transcripciones y resultados para análisis.
* 🎫 **Gestionar soporte** — crea y consulta tickets desde tus propios flujos o agentes.
* 🤖 **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 credencial:

| Tipo                     | Dónde encontrarlo                  | Alcance                                                        |
| ------------------------ | ---------------------------------- | ------------------------------------------------------------- |
| **API Key de cuenta** (`anz_live_…`) | Menú del usuario → **API Keys** | Toda tu cuenta (y, si sos partner, la de tus clientes). Recomendada para integraciones. Ver [API Keys de cuenta](api-keys.md). |
| **API Token del agente** | Ficha del agente → sección Resumen | Acceso a los datos de ese agente (lo usan las herramientas del propio agente). |

***

## Base URL

Todas las solicitudes se realizan a:

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

***

## Endpoints disponibles

| Recurso | Descripción | Guía |
| ------- | ----------- | ---- |
| **Llamadas del sistema** | Consulta y exporta el historial de llamadas de un agente (registros, transcripciones y resultados). | [Consultar llamadas del sistema →](consultar-llamadas.md) |
| **Contactos y notas** | Consulta contactos y sus notas asociadas. | [Consultar contactos y notas →](consultar-contactos.md) |
| **Tickets de soporte** | Crea, consulta y actualiza tickets desde tus flujos o agentes. | [Crear ticket →](crear-ticket.md) · [Consultar estado →](consultar-ticket.md) · [Agregar nota →](actualizar-ticket.md) |

> Para **crear, listar o controlar llamadas de voz** en tiempo real, usa la [**API de Llamadas (voz)**](../api-calls/README.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.