Crear y contestar
Inicia llamadas salientes o contesta llamadas entrantes enrutadas a Voice API Control.
Ver documentaciónAPI de voz
Tu lógica.
Tus llamadas.
Tu control.
Integra voz en tu aplicación. Crea y contesta llamadas, reproduce audio, recoge respuestas y decide qué ocurre después mediante la API de IllyVoIP.
Tu aplicación
Control de llamadas
speak→gather→transferEventos de llamadaWebhooks
Las piezas
de una experiencia de voz.
Usa acciones individuales para controlar la llamada en directo o ejecuta una secuencia ordenada de acciones en una sola solicitud.
Hablar y escuchar
Reproduce audio, convierte texto en voz y recoge respuestas habladas o por teclado del interlocutor.
Ver documentaciónDirigir la conversación
Transfiere, pon en espera, reanuda, envía DTMF o finaliza la llamada según lo necesite tu aplicación.
Ver documentaciónUna secuencia de acciones en la práctica
Habla.
Escucha.
Decide el siguiente paso.
Esta solicitud reproduce un saludo y recoge una respuesta hablada en una llamada existente. Tu aplicación decide cómo utilizar el resultado.
- Autenticación
X-Api-Key- Formato de la solicitud
application/json- Obligatorio para este endpoint
Idempotency-Key
Sustituye los valores de ejemplo por tus credenciales de servidor y una sesión válida de control de llamadas. Reutiliza una clave de idempotencia solo para una solicitud idéntica.
Consultar la referencia de secuencias de accionesCuerpo de la solicitud · JSON
POST
/api/v1/voice/call-control/execute{
"call_control_id": "YOUR_CALL_CONTROL_ID",
"actions": [
{
"type": "speak",
"text": "Welcome to our support line."
},
{
"type": "gather",
"input": "speech",
"prompt_text": "How can we help?",
"speech_language": "en-US",
"timeout_ms": 8000,
"save_as": "request"
}
]
}Llamadas entrantes
Tu número.
La respuesta de tu aplicación.
Enruta un número de IllyVoIP a Voice API Control. Suscríbete al evento de llamada entrante, contesta la llamada que permita esta operación y utiliza el identificador de control devuelto para las acciones posteriores.
Consultar la guía de llamadas entrantesNúmero de teléfonoEnrutamiento a Voice API Control
↓Evento de llamada entrante
↓call_ringingTu aplicaciónContestar → controlar la llamada
Webhooks
Haz que los eventos de llamada
activen tu flujo de trabajo.
Recibe eventos del ciclo de la llamada en el endpoint de tu aplicación. Úsalos para actualizar registros, seguir el progreso de las llamadas o activar el siguiente paso en tu sistema.
Descubre los webhookscall_initiatedcall_ringingcall_answeredcall_completedVerifica las firmas, confirma la recepción sin demora y evita duplicados mediante el identificador de evento. Los reintentos de entrega pueden repetir un evento.
Elige cómo
quieres desarrollar.
Usa el control de llamadas para aplicar la lógica de tu aplicación y conecta las demás herramientas que necesite tu experiencia de voz.
API de números de teléfono
Busca, solicita y configura números como parte de los procesos de tu plataforma.
Descubre los números de teléfonoSDK del teléfono web
Añade llamadas desde el navegador a tu interfaz con el SDK documentado y la autenticación mediante tokens de corta duración.
Consultar la documentación del SDKAgentes de voz con IA
Configura en el portal un asistente para llamadas entrantes con una base de conocimiento y flujos visuales de llamadas.
Descubre los agentes de voz con IAAntes de tu
primera integración.
Consulta con nuestro equipo¿La API de voz es lo mismo que una troncal SIP?+
No. La conectividad SIP conecta un sistema telefónico o una plataforma. La API de voz ofrece operaciones de control de llamadas que tu aplicación puede solicitar, como reproducir texto hablado, recoger respuestas y transferir una llamada.
¿Puede gestionar llamadas entrantes y salientes?+
Sí. La documentación incluye la creación de llamadas salientes y la respuesta a llamadas entrantes. Para las entrantes, enruta un número a Voice API Control y sigue el flujo documentado de evento de llamada entrante y respuesta.
¿Puedo recoger respuestas habladas y por teclado?+
Sí. El endpoint gather admite voz y DTMF. Consulta su documentación para elegir las opciones de entrada, el idioma y el tiempo de espera compatibles con tu flujo.
¿Puedo usar los servicios de voz fuera de una llamada en curso?+
Sí. La referencia de la API incluye endpoints independientes de transcripción y de texto a voz. Úsalos para convertir audio en texto o texto en audio; dentro de una llamada, utiliza las operaciones gather y speak de la API de voz.
¿Cómo se cobran las funciones de voz?+
El portal publica las tarifas vigentes de transcripción y de texto a voz. La API de voz aplica esas tarifas a las operaciones gather y speak. Revisa las tarifas actuales y los cargos de llamadas que correspondan a tu configuración.
¿Dónde debo guardar la clave API?+
Mantén las claves API de clientes en tu aplicación de servidor. Las llamadas desde el navegador utilizan el flujo documentado de tokens de corta duración del SDK del teléfono web, sin exponer la clave API de la cuenta.
¿Puedo explorar antes de conectar mi aplicación?+
El portal incluye referencias de endpoints, ejemplos de solicitudes y respuestas, una especificación OpenAPI y un Playground de la API. Las solicitudes del Playground pueden ejecutar operaciones reales; revisa la solicitud seleccionada antes de enviarla.
Crea el flujo de llamadas
que necesita tu aplicación.
Empieza por la referencia de endpoints y los ejemplos actuales de solicitudes.