> 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-la-plataforma/agents.md).

# Agentes

Consultá y configurá los agentes de tu cuenta. Base: `https://panel.anunzi.net/api/v1/agents/`.

| Método | Ruta             | Descripción                                                        |
| ------ | ---------------- | ------------------------------------------------------------------ |
| `GET`  | `list.php`       | Lista los agentes de la cuenta (y de tus clientes si sos partner). |
| `GET`  | `get.php?id=`    | Configuración de un agente.                                        |
| `POST` | `update.php?id=` | Actualiza campos de configuración.                                 |
| `POST` | `status.php?id=` | Activa o pausa el agente.                                          |

`id` es el `agent_id` del agente.

***

## Listar

```bash
curl "https://panel.anunzi.net/api/v1/agents/list.php?channel=whatsapp" \
  -H "Authorization: Bearer anz_live_TU_API_KEY"
```

Filtro opcional `channel` (`voice` | `whatsapp` | `email`). Devuelve id, label, canal, dirección, estado, número.

## Obtener configuración

`GET /api/v1/agents/get.php?id=AGENT_ID` — devuelve label, canal, número, descripción, zona horaria, webhook, cantidad de funciones y el `system_prompt`.

## Actualizar

`POST /api/v1/agents/update.php?id=AGENT_ID` — campos opcionales:

```json
{ "label": "Ventas AR", "description": "…", "system_prompt": "…", "webhook_url": "https://tu.app/webhook", "timezone": "America/Argentina/Buenos_Aires" }
```

> `system_prompt` aplica a agentes de **WhatsApp/chat**. La configuración de voz (voz, funciones) se gestiona por la [API de Llamadas](/anunzi-ia-documentation/api-de-llamadas-voz/api-calls.md) o el panel. `webhook_url` es el webhook por agente para eventos de llamada.

## Activar / pausar

`POST /api/v1/agents/status.php?id=AGENT_ID` con `{ "active": true }` o `{ "active": false }`.