Aller au contenu
Espace client
Documentation / Options et intégrations / Plateforme développeurs (téléphonie programmable)

Options et intégrations

Plateforme développeurs (téléphonie programmable)

Construire vos services vocaux en code : endpoints SIP, numéros, appels et dial plan par webhook.

Pour les développeurs qui construisent les services téléphoniques de leurs clients en code : API REST, dial plan par webhook (instructions JSON), SDK TypeScript et PHP, spécification OpenAPI.

Portail développeurs

Portail développeurs (comptes développeurs) ou Connexions › Développeurs :

Onglet Contenu
Démarrage Limites, utilisation, exemples curl et SDK
Clés API Création et révocation (une clé n’est affichée qu’une fois)
Applications URL du webhook, URL de secours, URL de fin d’appel, clé de signature
Endpoints SIP Comptes SIP (téléphone, softphone, WebRTC), identifiants, appareils enregistrés
Numéros Stock disponible, achat, routage vers une application ou un endpoint, résiliation
Journal Chaque requête webhook (7 jours) : envoi, réponse, code HTTP, durée, erreurs
Consommation Estimation de la facture télécom du mois

API REST

  • Base : https://VOTRE-ESPACE/api/v1, authentification Authorization: Bearer vxk_….
  • Spécification : GET /api/v1/openapi.json (OpenAPI 3.1).
  • Limite : 300 requêtes par minute.

Ressources : compte et consommation, applications, endpoints, numéros (achat et routage), appels (POST /calls pour un appel programmable, raccrocher, rediriger), journal des appels, enregistrements (lien d’écoute de 5 minutes), audio, journal des webhooks.

Dial plan en code

À chaque appel vers un numéro relié à votre application, votre URL de webhook reçoit un POST JSON (event, callId, from, to, direction, vars…) et répond en 5 secondes par une liste d’instructions :

[
  { "verb": "play", "url": "https://exemple.fr/accueil.mp3" },
  { "verb": "gather", "numDigits": 1, "timeout": 6, "action": "https://exemple.fr/menu" }
]
Instruction Effet
answer, hangup Décrocher, raccrocher
play, say, pause Jouer un fichier, prononcer un nombre, silence
gather Saisie de touches, puis rappel de action avec digits
record Enregistrer, puis rappel de action
dial Appeler un endpoint, un numéro ou plusieurs (simultané ou à tour de rôle)
queue, conference, voicemail, transfer File d’attente, conférence, messagerie, transfert
set, redirect Variables de l’appel, nouvelle URL d’instructions

En cas d’échec du webhook (délai, erreur), l’URL de secours est appelée. Sans elle, l’appelant entend un message d’erreur.

Sécurité des webhooks

Chaque requête porte X-VoxNova-Signature: t=<horodatage>,v1=<HMAC-SHA256>, calculé sur "<t>.<corps brut>" avec la clé de signature de l’application. Vérifiez-la en temps constant et refusez les horodatages de plus de 5 minutes. Le SDK fournit verifySignature(secret, corpsBrut, entête).

Numéro présenté

callerId doit être l’un de vos numéros ; sinon le numéro de l’endpoint ou de l’entreprise est présenté (protection contre l’usurpation).

Enregistrements

Ils restent sur la plateforme ; l’API ne délivre qu’un lien d’écoute signé de 5 minutes. Suppression automatique selon votre durée de conservation (180 jours au plus).

← PrécédentConnexion unique (SSO) Suivant →Application Centre d’appels

Mis à jour le 1 novembre 2026 · Une question ? Contactez-nous