Les communications professionnelles, tout simplement
Applications mobiles et de bureauDéveloppeursÉtat des services IllyVoIPCentre d’aide

Voice API

Votre logique.
Vos appels.
Vous gardez la main.

Intégrez les appels à votre application. Créez des appels et répondez-y, diffusez de l’audio, recueillez les réponses et pilotez la suite avec l’API IllyVoIP.

Découvrir l’APIVoir une requête

Les briques essentielles
de votre parcours vocal.

Utilisez des actions individuelles pour piloter un appel en direct ou exécutez une suite ordonnée d’actions dans une seule requête.

Créer et répondre

Lancez des appels sortants ou répondez aux appels entrants dirigés vers Voice API Control.

Consulter la documentation

Parler et écouter

Diffusez de l’audio, faites lire du texte et recueillez la parole ou la saisie au clavier de l’appelant.

Consulter la documentation

Guider la conversation

Transférez, mettez en attente, reprenez, envoyez des tonalités DTMF ou terminez l’appel selon les besoins de votre application.

Consulter la documentation

Une chaîne d’actions en pratique

Parlez.
Écoutez.
Adaptez la suite.

Cette requête diffuse un message d’accueil et recueille une réponse orale sur un appel existant. Votre application décide ensuite comment exploiter le résultat.

Authentification
X-Api-Key
Format de requête
application/json
Requis pour cet endpoint
Idempotency-Key

Remplacez les valeurs d’exemple par vos identifiants côté serveur et une session de contrôle d’appel valide. Ne réutilisez une clé d’idempotence que pour une requête identique.

Lire la documentation des chaînes d’actions
Corps de la requête · 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"
    }
  ]
}

Appels entrants

Votre numéro.
La réponse de votre application.

Dirigez un numéro IllyVoIP vers Voice API Control. Abonnez-vous à l’événement de sonnerie, répondez à l’appel éligible, puis utilisez l’identifiant de contrôle renvoyé pour les actions suivantes.

Lire le guide des appels entrants
Numéro de téléphoneRoutage Voice API Control
Événement de sonneriecall_ringing
Votre applicationRépondre → piloter l’appel

Webhooks

Faites avancer vos parcours
au rythme des appels.

Recevez les événements du cycle de vie des appels sur l’endpoint de votre application. Utilisez-les pour mettre à jour vos données, suivre un appel ou déclencher l’étape suivante dans votre système.

Découvrir les webhooks
call_initiatedcall_ringingcall_answeredcall_completed

Vérifiez les signatures, accusez réception rapidement et dédupliquez les événements par leur identifiant. Une nouvelle tentative de livraison peut répéter un événement.

Choisissez comment
vous souhaitez développer.

Utilisez le contrôle d’appel pour mettre en œuvre la logique de votre application et ajoutez les outils nécessaires à votre parcours vocal.

SDK Webphone

Ajoutez les appels depuis le navigateur à votre interface avec le SDK documenté et son authentification par jetons à courte durée de vie.

Lire la documentation du SDK

Agents vocaux IA

Configurez dans le portail un assistant pour les appels entrants, avec ses connaissances et des parcours d’appel visuels.

Découvrir les agents vocaux IA

Avant votre
première intégration.

Poser une question à notre équipe
Voice API est-elle la même chose qu’un trunk SIP ?+

Non. La connectivité SIP relie un système téléphonique ou une plateforme. Voice API expose des opérations de pilotage que votre application peut demander : faire lire du texte, recueillir une saisie ou transférer un appel, par exemple.

Peut-elle gérer les appels entrants et sortants ?+

Oui. La documentation couvre la création d’appels sortants et la réponse aux appels entrants. Pour les appels entrants, dirigez un numéro vers Voice API Control et suivez le parcours documenté de l’événement de sonnerie à la réponse.

Puis-je recueillir la parole et les saisies au clavier ?+

Oui. L’endpoint gather prend en charge la parole et les tonalités DTMF. Consultez sa documentation pour choisir les modes de saisie, la langue et le délai d’attente adaptés à votre parcours.

Puis-je utiliser le traitement de la parole en dehors d’un appel ?+

Oui. Des endpoints autonomes de transcription et de synthèse vocale sont disponibles dans la documentation API. Utilisez-les pour convertir de l’audio en texte ou du texte en audio ; pendant un appel, utilisez les opérations gather et speak de Voice API.

Comment les fonctions de traitement de la parole sont-elles facturées ?+

Le portail publie les tarifs actuels de transcription et de synthèse vocale. Voice API applique ces tarifs aux opérations gather et speak. Vérifiez les tarifs actuels et les frais d’appel applicables à votre configuration.

Où conserver la clé API ?+

Conservez les clés API du compte dans votre application côté serveur. Les appels depuis le navigateur utilisent le parcours documenté de jetons à courte durée de vie du SDK Webphone, sans exposer la clé API du compte.

Puis-je explorer l’API avant de connecter mon application ?+

Le portail propose la documentation des endpoints, des exemples de requêtes et de réponses, une spécification OpenAPI et un Playground API. Les requêtes du Playground peuvent effectuer de vraies opérations : vérifiez la requête choisie avant de l’exécuter.

Créez le parcours d’appel
dont votre application a besoin.

Commencez par la documentation des endpoints et les exemples de requêtes à jour.

Ouvrir la documentation Voice APIContacter notre équipe