Ropofy ofrece APIs públicas de Voice AI para que puedas gestionar agentes y acciones de manera programática, recuperar registros de llamadas y transcripciones, y conectar webhooks en tiempo real a tus flujos de trabajo. Este artículo ofrece una visión general y enlaces a la documentación oficial de la API para detalles técnicos.

--- ---

¿Qué son las APIs Públicas de Voice AI?

Las APIs públicas de Voice AI te dan acceso directo para configurar agentes, gestionar acciones, recuperar datos de llamadas e integrar webhooks en tus flujos de trabajo. Esto eleva Voice AI de una función del producto a una capacidad extensible que puede integrarse directamente en tus aplicaciones y flujos de trabajo.

En lugar de limitar Voice AI a controles dentro de la aplicación, puedes:

Gestionar Agentes y Acciones: Crea, actualiza y organiza agentes y sus comportamientos vía API.
Recuperar Datos de Llamadas: Accede a registros y transcripciones para informes, cumplimiento o análisis.
Aprovechar Webhooks: Recibe en tus sistemas resultados de llamadas en tiempo real, transcripciones y resúmenes.

Enlace a la Documentación de la API

---

Beneficios Clave de las APIs Públicas de Voice AI

Acceso a Datos: Extrae resultados de llamadas, transcripciones y métricas para seguimiento e informes detallados.
Integración de Flujos de Trabajo: Automatiza la configuración y adapta Voice AI para ajustarse a tus aplicaciones y necesidades operativas.
Extensibilidad Las APIs públicas hacen que Voice AI no solo sea usable, sino que sea construible.

---

Documentación API de Voice AI

La documentación API para las APIs públicas de Voice AI incluye detalles sobre registros de llamadas, agentes y acciones. Los requisitos de acceso, entornos y detalles de autenticación pueden cambiar. Consulta siempre la documentación de la API para los detalles más actuales.

Haz clic aquí para acceder a la documentación de la API de Voice AI ---

Voces (APIs de Catálogo)

Ahora puedes explorar el catálogo de Voice AI usando APIs públicas:

Obtener Voces: Recupera una lista de voces paginada y filtrable. Puedes filtrar por idioma y, opcionalmente, pasar un `agentId` para regresar solo voces compatibles.

Obtener Detalles de Voz: Recupera metadatos detallados para una voz específica, incluyendo una URL de previsualización para pruebas.

Para detalles técnicos completos, consulta la documentación de la API de Voice AI en el Portal para Desarrolladores.

---

APIs de Registros de Llamadas

Las APIs de registros de llamadas proporcionan acceso a las llamadas gestionadas por Voice AI; soportando análisis, revisiones de calidad y cumplimiento. Úsalas para listar llamadas con filtros o para obtener detalles individuales, incluyendo transcripciones cuando estén disponibles. Consulta la referencia de la API para más detalles.

Listar Registros de Llamadas: Devuelve los registros de llamadas de agentes de Voice AI asociados a una ubicación. Soporta filtrado por agente, contacto, tipo de llamada, tipos de acción y rango de fechas (interpretado en la zona horaria IANA proporcionada). También soporta ordenamiento y paginación basada en 1.
Obtener Registro de Llamada: Devuelve el registro de una llamada por ID de llamada.

Haz clic aquí para acceder a la documentación de la API sobre registros de llamadas

---

APIs de Agentes

Las APIs de agentes te permiten crear, listar, leer, actualizar y eliminar agentes de Voice AI de forma programática para implementar configuraciones consistentes en ubicaciones y entornos. Consulta la referencia de la API para más detalles.

Crear Agente: Crea una nueva configuración y ajustes de un agente de Voice AI.
Actualizar Agente (Patch): Actualiza parcialmente un agente existente de Voice AI.
Listar Agentes: Recupera una lista paginada de agentes para una ubicación dada.
Obtener Agente: Obtiene la configuración y ajustes detallados de un agente de Voice AI específico.
Eliminar Agente: Elimina un agente de Voice AI y todas sus configuraciones.

Haz clic aquí para acceder a la documentación de la API sobre agentes

---

APIs de Acciones

Las acciones definen lo que un agente puede hacer, como invocar un webhook, recuperar datos o enviar resultados. Las APIs de acciones te permiten crear y actualizar estos comportamientos de forma programática y mantenerlos sincronizados con tus sistemas. Consulta la referencia de la API para más detalles.

Crear Acción de Agente: Crea una nueva acción para un agente de voz AI. Las acciones definen comportamientos y capacidades específicas para el agente durante las llamadas.
Actualizar Acción de Agente: Actualiza una acción existente de un agente de voz AI. Modifica el comportamiento y configuración de una acción de agente.
Obtener Acción de Agente: Recupera detalles de una acción específica por su ID. Devuelve la configuración de la acción incluyendo actionParameters.
Eliminar Acción de Agente: Elimina una acción existente de un agente de voz AI. Esto elimina permanentemente la acción y su configuración.

Haz clic aquí para acceder a la documentación de la API sobre acciones

---

Preguntas Frecuentes

P: ¿Puedo gestionar voces vía API?

Sí. Puedes usar las APIs de Voices para recuperar las voces disponibles y obtener metadatos detallados, incluyendo URLs de previsualización, para seleccionar la voz adecuada para tu agente.

P: ¿Necesito permisos especiales para usar estas APIs?

Debes tener acceso apropiado a Ropofy para gestionar Voice AI y leer datos de llamadas. Coordina con tu administrador de cuenta si no puedes acceder a ciertos recursos.

P: ¿Dónde puedo encontrar los endpoints y esquemas de solicitud/respuesta más actuales?

Siempre utiliza la documentación oficial de la API: Haz clic aquí para ver la documentación API

---