La API de llamadas de Ringover le permite extraer y sincronizar los datos de sus llamadas, contactos, usuarios, centralitas y SMS para integrarlos directamente en sus herramientas empresariales. En esta guía, aprenderá a generar su clave de autenticación, definir sus permisos, ejecutar sus solicitudes y resolver los errores habituales.

Requisitos previos

Una cuenta de Ringover activa con derechos de acceso de administrador o desarrollador.
Un entorno de desarrollo o un cliente HTTP (cURL, Postman o servidor de aplicaciones).

Generar una clave API y consultar la API de llamadas de Ringover

1. Generar su clave API en el Dashboard

Cree su token de autenticación y configure sus derechos de acceso desde los ajustes de desarrollador.

Vaya a la sección Desarrollador > API.
Haga clic en el botón Generar una clave API.
Asigne un nombre a su clave y seleccione un usuario.
Seleccione los permisos deseados en la sección Derechos (llamadas, contactos, usuarios, SVI o SMS).
Copie la clave generada y guárdela en un lugar seguro.

⚠️ Mantenga sus claves API estrictamente confidenciales. No las comparta nunca públicamente ni las incluya directamente en el código fuente del lado del cliente.

2. Ejecutar sus solicitudes a la API de Ringover

Consulte los endpoints públicos transmitiendo su clave en el encabezado de autorización HTTP.

Abra su terminal de comandos o su herramienta de envío de solicitudes.
Prepare una solicitud HTTP GET a la URL de la API pública.
Añada su clave API en el campo del encabezado Authorization:

curl --header "Authorization:VOTRE_CLE_API" https://public-api.ringover.com/v2/calls

☝️ Consulte la lista completa de endpoints, parámetros y códigos de respuesta en la documentación oficial: developer.ringover.com.

3. Utilizar los mensajes SMS y las funciones avanzadas

Integre la gestión de los SMS entrantes y salientes en sus aplicaciones empresariales.

Acceso a los mensajes SMS

Utilice este acceso para sincronizar automáticamente los intercambios de texto con las fichas de sus programas empresariales o CRM.

Compruebe que su clave API dispone de los derechos de acceso otorgados para los SMS.
Consulte la documentación técnica para construir sus cargas útiles JSON conformes.

💡Pruebe siempre sus solicitudes en un entorno de prueba antes de implementar la integración en su sistema de producción.

Preguntas frecuentes

¿Qué hacer en caso de problemas de autenticación con la clave API?

Si sus solicitudes devuelven un error de autenticación, realice las siguientes comprobaciones:

Compruebe que está utilizando la clave API exacta proporcionada en su Dashboard.
Compruebe la distinción entre mayúsculas y minúsculas: los caracteres en mayúscula y minúscula son importantes.
Confirme que el usuario o la clave dispone de las autorizaciones y los derechos de acceso necesarios.
Asegúrese de que el encabezado Authorization está configurado correctamente en su solicitud y sin espacios innecesarios.

¿Dónde encontrar las especificaciones detalladas para los mensajes SMS?

Para obtener los formatos de solicitud y los esquemas de integración específicos de los SMS, consulte directamente la documentación oficial en developer.ringover.com.

🎉 ¡Ahora ya sabe cómo generar su clave API y consultar la API de llamadas de Ringover, y puede interconectar sus flujos de comunicación con total facilidad!