> 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-anunzi/api-calls/gestionar-agentes/voces-y-numeros.md).

# 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](/anunzi-ia-documentation/api-de-anunzi/api-calls/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](/anunzi-ia-documentation/api-de-anunzi/api-calls/crear-llamada-telefonica.md).