# Voces y números

Consulta las voces que puedes asignar a tus agentes y los números de teléfono de tu cuenta.

---

## Listar voces

**GET** `/list-voices`

Devuelve el catálogo de voces del motor de voz VPower más las voces propias de tu cuenta (las que clonaste o agregaste desde el panel).

```bash
curl --request GET \
     --url https://calls.anunzi.net/list-voices \
     --header 'Authorization: Bearer anz_live_TU_API_KEY'
```

```json
[
  {
    "voice_id": "cartesia:f4d6bb07-f876-4464-ba70-cd48d8701890",
    "voice_name": "Adriana",
    "provider": "cartesia",
    "gender": "female",
    "accent": "Neutro",
    "language": "Español",
    "voice_type": "built_in",
    "preview_audio_url": "https://panel.anunzi.net/api/voice_preview.php?id=cartesia:f4d6bb07-…"
  }
]
```

| Campo | Descripción |
|-------|-------------|
| `voice_id` | Lo que usas en `voice_id` al [actualizar el agente](gestionar-agentes.md#actualizar-agente). |
| `voice_type` | `built_in` (catálogo) o `custom` (voz propia de tu cuenta). |
| `preview_audio_url` | Muestra de la voz en audio. Las del catálogo se escuchan sin iniciar sesión. |

---

## Obtener una voz

**GET** `/get-voice/{voice_id}`

Devuelve una voz con la misma forma.

---

## Listar números

**GET** `/list-phone-numbers`

Números de teléfono de tu cuenta y el agente que atiende cada uno.

```json
[
  {
    "phone_number": "+34910000000",
    "inbound_agent_id": "agent_3f9c1a7b2e4d5c6f",
    "outbound_agent_id": "agent_3f9c1a7b2e4d5c6f",
    "country": "ES",
    "phone_number_type": "Local"
  }
]
```

Para llamar desde uno de estos números, úsalo como `from_number` en [Crear llamada telefónica](crear-llamada-telefonica.md).