# 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](../../api-calls/README.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 }`.