API de telefonía

API de telefonía: tus datos de llamadas y SMS, en tus propias herramientas.

Con la API de telefonía de OVOKY llevas el historial de llamadas, las grabaciones, los KPI y los informes a tu BI, tu CRM o tu back office, y compras números o envías SMS desde tu propio código. Cada clave lleva solo los ámbitos que necesita y se puede limitar a tus servidores.

Pide una demoEmpieza ya
endpoints REST
26
ámbitos de permiso para las claves de API
15
peticiones por minuto y clave por defecto
60
how it works

Una API REST con claves por ámbito para leer KPI, llamadas, grabaciones e informes, comprar números y enviar SMS desde tus propios sistemas.

  1. Cobertura

    Consulta tu saldo, los KPI, el consumo diario, los pagos, las suscripciones y las tarifas. Lista las interacciones de llamadas y SMS, descarga grabaciones y mensajes de voz, lee los eventos del calendario y ejecuta los informes predefinidos en JSON. Busca números disponibles, cómpralos y dalos de baja.

    • Saldo, KPI, consumo, pagos, suscripciones y tarifas
    • Historial de llamadas y SMS, grabaciones y mensajes de voz
    • Números: listado, detalle, disponibles, compra y baja
    • Eventos del calendario e informes

  2. Seguridad

    Crea una clave por integración y dale solo los ámbitos que necesita, por ejemplo leer informes sin poder comprar números. Fija una fecha de caducidad y limita la clave a una lista de direcciones IP o dominios web. Las respuestas indican cuántas peticiones te quedan.

    • 15 ámbitos, de balance:read a numbers:purchase
    • Fecha de caducidad por clave
    • Listas de IP y dominios permitidos
    • Límites por defecto de 60 por minuto, 3.600 por hora y 50.000 al día

  3. SMS

    Envía a un número o hasta a 100 en una sola petición, programa el envío para más tarde e incluye una clave de idempotencia para que una petición repetida nunca se envíe dos veces. Consulta las rutas disponibles y comprueba el estado de entrega de cada mensaje por su ID.

    • Hasta 100 destinatarios por petición
    • Envío programado
    • Clave de idempotencia contra envíos duplicados
    • Rutas, historial de envíos y estado de entrega

Qué incluye

En detalle: API de telefonía

Ejemplos de código

Cada endpoint documentado con ejemplos en cURL, JavaScript y Python.

Claves bearer

Autentica cada petición con tu clave de API como token bearer.

Informes en JSON

Ejecuta un informe predefinido con filtros y recibe las filas en JSON.

Grabaciones

Descarga las grabaciones de llamadas y los audios del buzón de voz para tu propio archivo.

Compra de números

Busca números disponibles, cómpralos y dalos de baja desde tu código.

Cabeceras de límite

Las respuestas muestran el límite y lo que queda, con un tiempo de espera cuando lo alcanzas.

API de telefonía: preguntas frecuentes

Respuestas breves a lo que más nos preguntan los equipos. ¿Tienes otra duda? Habla con nosotros

  • No. OVOKY no envía eventos a tus sistemas. Para mantenerte sincronizado, consulta periódicamente los endpoints que necesites, como las interacciones de llamadas o el estado de los SMS, dentro de tus límites.

  • Crea una clave de API en los ajustes de tu espacio de trabajo, elige sus ámbitos y envíala como token bearer en la cabecera Authorization. Solo los usuarios con el permiso de claves de API pueden crearlas o gestionarlas.

  • Por defecto, cada clave puede hacer 60 peticiones por minuto, 3.600 por hora y 50.000 al día. Las respuestas incluyen el límite y las peticiones restantes, y una petición que lo supera recibe una cabecera Retry-After.

  • Hoy no. La API cubre las áreas de esta página: datos de la cuenta, interacciones, grabaciones, mensajes de voz, números, eventos del calendario, informes y SMS. Los contactos se importan en la aplicación por CSV, y las campañas también se gestionan allí.

  • La documentación muestra cada endpoint en cURL, JavaScript y Python. Cualquier lenguaje que pueda hacer peticiones HTTP y leer JSON sirve para usar la API.

Funciona con

Combínalo con

Reúne todas las conversaciones con tus clientes en un solo sitio

Llamadas, SMS, WhatsApp, email y chat en una bandeja y en una sola factura. Empieza con un equipo y crece a tu ritmo.

Pide una demoVer preciosEmpieza ya