Un rappel, un menu vocal et un assistant vocal utilisent des parties différentes d'une plateforme de téléphonie.
Que peut contrôler une API vocale ?
Une API vocale peut exposer la configuration, le contrôle d'appel et le reporting, les opérations prises en charge étant définies par le fournisseur.
La configuration couvre les trunks, les identités d'appelant, les destinations et le routage des numéros. Le contrôle d'appel couvre le comportement à l'intérieur d'une conversation, comme les annonces ou la saisie au clavier. Le reporting renvoie le statut de l'appel, sa durée et les autres résultats enregistrés.
Les fournisseurs expriment le contrôle d'appel différemment. TwiML de Twilio, par exemple, décrit les actions au moyen d'instructions renvoyées à Twilio. Migrer une application implique donc de cartographier son comportement et ses attentes de callback, pas seulement de remplacer un nom d'hôte.
Une méthode qui lit un appel n'est pas une opération qui en initie un.
Comment une API et SIP fonctionnent-ils ensemble ?
Une API applicative peut configurer ou contrôler un service tandis que SIP établit la session téléphonique sous-jacente.
SIP, le protocole de signalisation d'appel, crée, modifie et termine les sessions. Il négocie la manière dont les participants se connectent. RTP transporte les médias en temps réel, comme l'audio.
Les chemins peuvent échouer indépendamment. Un appel peut sonner alors qu'un paramètre média ou un chemin réseau empêche un participant d'entendre l'autre. Testez l'audio dans les deux sens, ainsi que la sonnerie et le raccrochage.
Un PBX, le système téléphonique d'entreprise qui route les appels, peut conserver sa gestion d'appels tout en utilisant les trunks SIP d'un fournisseur. Un runtime conversationnel peut utiliser une connexion similaire tout en fournissant lui-même le traitement de la parole et les outils métier.
Que puis-je consulter sur un appel ?
Une fiche d'appel identifie la tentative et rapporte son état observé. Les champs disponibles dépendent de l'opération et de l'étape de l'appel.
- Connexion : si l'appel a été admis, a sonné et a reçu une réponse.
- Média : si les participants pouvaient s'entendre et interagir.
- Résultat métier : si le rendez-vous, le rappel ou la tâche de support prévus ont été accomplis.
Un appel téléphonique décroché peut aboutir à une personne, une messagerie vocale ou un autre système automatisé. La fiche d'appel seule ne peut pas prouver qu'un client a accompli une tâche.
Les événements aident votre application à réagir aux changements. Gérez les doublons et les livraisons tardives, puis réconciliez les mises à jour manquantes ou incertaines avec l'état enregistré par le fournisseur.
Comment construire cela avec Bird ?
Vous configurez les appels sortants avec un trunk SIP, un identifiant d'appelant vérifié et un pays de destination activé.
Les modifications de configuration nécessitent voice_management au niveau écriture.
Sur le trunk, outbound_enabled doit être true. Son domain est l'adresse à laquelle votre client SIP se connecte. L'authentification par clé API inscrit votre clé dans allowed_api_key_ids ; la clé nécessite voice au niveau écriture. La mise à jour de cette liste remplace toutes les entrées : conservez les clés que d'autres clients utilisent encore.
Votre identifiant d'appelant nécessite status: verified, qui confirme que votre espace de travail a effectué son appel de vérification. Son phone_number contient le numéro international, y compris le + initial.
Le pays de destination nécessite à la fois enabled: true et status: available. Activer un pays ne rend pas une destination non prise en charge joignable.
Le téléphone navigateur nécessite aussi session_credentials_enabled: true sur le trunk et MD5 dans sa liste digest_algorithms.
Après un appel, vous inspectez status, rejection_reason et sip_response_code. Les opérations liste des appels et lecture d'appel renvoient ces champs. Ces opérations rapportent des tentatives. Votre application SIP les initie.
Pour un menu vocal, vous configurez les annonces et les branches clavier dans l'application connectée. Un runtime vocal IA fournit le traitement de la parole, le raisonnement et les outils métier pour une conversation.
En bref
Vérifiez quel rôle remplit l’API.
Configuration, contrôle d'appel et fiches d'appels sont des interfaces distinctes. Une opération de lecture n'implique pas la possibilité de passer un appel.
La signalisation et l'audio empruntent des chemins séparés.
SIP établit et modifie la session. Les médias transportent ce que les participants entendent : une signalisation réussie seule ne prouve pas que l'audio fonctionne.
Associez le résultat métier au résultat de l'appel.
Un appel décroché peut aboutir à une messagerie vocale ou à un autre système. L'application responsable de la tâche confirme si celle-ci a été accomplie.