L'API d'appels Ringover vous permet d'extraire et de synchroniser les données de vos appels, contacts, utilisateurs, standards et SMS afin de les intégrer directement dans vos outils métiers. Dans ce guide, vous apprendrez à générer votre clé d'authentification, à définir ses permissions, à exécuter vos requêtes et à résoudre les erreurs courantes.

Prérequis

Un compte Ringover actif avec droits d'accès administrateur ou développeur.
Un environnement de développement ou un client HTTP (cURL, Postman ou serveur applicatif).

Générer une clé API et interroger l'API d'appels Ringover

1. Générer votre clé API dans le Dashboard

Créez votre jeton d'authentification et configurez ses droits d'accès depuis les paramètres développeur.

Allez dans la section Développeur > API.
Cliquez sur le bouton Générer une clé API.
Nommez votre clé et sélectionnez un utilisateur.
Sélectionnez les permissions souhaitées dans la section Droits (appels, contacts, utilisateurs, SVI ou SMS).
Copiez la clé générée et conservez-la en lieu sûr.

⚠️ Gardez vos clés API strictement confidentielles. Ne les partagez jamais publiquement et ne les incluez pas directement dans du code source côté client.

2. Exécuter vos requêtes vers l'API Ringover

Interrogez les points de terminaison publics en transmettant votre clé dans l'en-tête d'autorisation HTTP.

Ouvrez votre terminal de commande ou votre outil d'envoi de requêtes.
Préparez une requête HTTP GET vers l'URL de l'API publique.
Ajoutez votre clé API dans le champ d'en-tête Authorization :

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

☝️ Retrouvez la liste complète des endpoints, des paramètres et des codes de retour sur la documentation officielle : developer.ringover.com.

3. Exploiter les messages SMS et les fonctions avancées

Intégrez la gestion des SMS entrants et sortants au sein de vos applications métiers.

Accès aux messages SMS

Utilisez cet accès pour synchroniser automatiquement les échanges textuels avec les fiches de vos logiciels métiers ou CRM.

Vérifiez que votre clé API dispose bien des droits d'accès accordés pour les SMS.
Consultez la documentation technique pour construire vos charges utiles JSON conformes.

💡Testez toujours vos requêtes dans un environnement de test avant de déployer l'intégration sur votre système en production.

FAQ

Que faire en cas de problème d'authentification avec la clé API ?

Si vos requêtes renvoient une erreur d'authentification, effectuez les vérifications suivantes :

Vérifiez que vous utilisez la clé API exacte fournie dans votre Dashboard.
Vérifiez la sensibilité à la casse : les caractères majuscules et minuscules sont importants.
Confirmez que l'utilisateur ou la clé dispose des autorisations et droits d'accès requis.
Assurez-vous que l'en-tête Authorization est correctement configuré dans votre requête sans espaces superflus.

Où trouver les spécifications détaillées pour les messages SMS ?

Pour obtenir les formats de requêtes et les schémas d'intégration spécifiques aux SMS, consultez directement la documentation officielle à l'adresse developer.ringover.com.

🎉 Vous savez désormais comment générer votre clé API et interroger l'API d'appels Ringover et pouvez interconnecter vos flux de communication en toute simplicité !