> ## Documentation Index
> Fetch the complete documentation index at: https://help.chateea.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# API pública de la IA de voz

> Gestiona agentes, acciones y voces, y consulta los registros de llamadas de la IA de voz desde tus propios sistemas.

La API pública de la IA de voz te permite gestionar tus agentes desde tus propios sistemas: crear y actualizar agentes y acciones, consultar el catálogo de voces y obtener registros y transcripciones de llamadas. Es útil si tienes un equipo técnico o un desarrollador que quiere integrar la IA de voz con tus aplicaciones, informes o procesos internos.

> [!NOTE]
>
> Para obtener las credenciales de acceso, la URL base y la documentación técnica de la API de Chateea, escribe a soporte de Chateea en **[help@chateea.com](mailto:help@chateea.com)**.

## Para qué te sirve

* **Acceso a los datos:** obtén resultados, transcripciones y métricas de llamadas para tus propios informes o análisis.
* **Integración con tus procesos:** automatiza la configuración y adapta la IA de voz a tus aplicaciones.
* **Configuración consistente:** crea y actualiza agentes con la misma configuración sin hacerlo a mano uno por uno.
* **Webhooks en tiempo real:** recibe resultados, transcripciones y resúmenes de las llamadas en tus sistemas.

## Qué puedes hacer con la API

### Voces (catálogo)

| Operación | Qué hace |
| - | - |
| **Listar voces** | Devuelve una lista paginada de voces. Puedes filtrar por idioma y enviar un `agentId` para ver solo las voces compatibles con ese agente. |
| **Detalle de una voz** | Devuelve la información de una voz, incluida una URL de muestra para escucharla. |

### Registros de llamadas

| Operación | Qué hace |
| - | - |
| **Listar registros** | Devuelve los registros de llamadas de los agentes de tu cuenta. Permite filtrar por agente, contacto, tipo de llamada, tipo de acción y rango de fechas (interpretado en la zona horaria IANA que indiques). Admite ordenamiento y paginación que empieza en 1. |
| **Obtener un registro** | Devuelve una llamada concreta a partir de su ID, con la transcripción cuando está disponible. |

### Agentes

| Operación | Qué hace |
| - | - |
| **Crear agente** | Crea un agente nuevo con su configuración. |
| **Actualizar agente** | Modifica parcialmente un agente existente. |
| **Listar agentes** | Devuelve la lista paginada de agentes de tu cuenta. |
| **Obtener agente** | Devuelve la configuración completa de un agente. |
| **Eliminar agente** | Elimina un agente y toda su configuración. |

### Acciones

Las acciones definen lo que puede hacer un agente durante una llamada, como llamar a un webhook, consultar datos o enviar resultados.

| Operación | Qué hace |
| - | - |
| **Crear acción** | Agrega una acción nueva a un agente. |
| **Actualizar acción** | Modifica el comportamiento y la configuración de una acción. |
| **Obtener acción** | Devuelve la configuración de una acción, incluidos sus parámetros. |
| **Eliminar acción** | Elimina una acción de forma permanente. |

> [!WARNING]
>
> Eliminar un agente o una acción por API es permanente. Prueba tus integraciones primero con agentes de prueba.

## Preguntas frecuentes

> **¿Puedo gestionar las voces por API?**
>
> Sí. Puedes listar las voces disponibles y obtener su información, con la URL de muestra, para elegir la voz adecuada para cada agente.

> **¿Necesito permisos especiales?**
>
> Sí. Necesitas acceso para gestionar la IA de voz y leer datos de llamadas en tu cuenta. Si no puedes acceder a algún recurso, habla con el administrador de tu cuenta.

> **¿Dónde consulto los endpoints y los formatos de solicitud y respuesta?**
>
> Escribe a **[help@chateea.com](mailto:help@chateea.com)** y te enviaremos la documentación técnica actualizada de la API de Chateea. Los requisitos de acceso y autenticación pueden cambiar, así que usa siempre la versión más reciente.

## Artículos relacionados

> **[API pública de Agent Studio](https://help.chateea.com/docs/ia/api-publica-agent-studio.md)**
>
> Integra tus agentes de Agent Studio.

> **[API de IA conversacional](https://help.chateea.com/docs/ia/api-ia-conversacional.md)**
>
> Gestiona tus bots de chat por API.

> **[Registros de llamadas](https://help.chateea.com/docs/ia/registros-de-llamadas-ia-de-voz.md)**
>
> Los mismos datos, desde la interfaz de Chateea.

> **[Acciones personalizadas](https://help.chateea.com/docs/ia/acciones-personalizadas-ia-de-voz.md)**
>
> Conecta el agente con webhooks durante la llamada.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.