Guide d'architecture des API vocales

Les API vocales sont événementielles : la plateforme vous appelle au fur et à mesure que l'appel progresse.

• Comprendre les événements du cycle de vie de l'appel (initié, sonnerie, répondu, terminé) que votre API émet.Votre gestionnaire de webhook est en réalité la machine à états du flux d'appel — concevez-le comme tel.
• Modéliser le contrôle d'appel comme des gestionnaires de webhook idempotents tolérant les réessais et les événements désordonnés.
• Choisir entre des documents de flux d'appel déclaratifs et un contrôle API en direct par événement, selon le cas d'usage.
• Gérer les concepts SIP incontournables : early media, DTMF, transfert, et sémantique du re-INVITE.
• Planifier la stratégie de numéros (E.164), la présentation du caller-ID, et les règles de caller-ID par marché.

• Choisir les codecs délibérément : G.711 pour la qualité, G.729/Opus là où la bande passante est contrainte.Budgétisez la bande passante en incluant le surcoût IP/UDP/RTP, pas seulement le débit du codec.
• Fixer un intervalle de packetisation raisonnable (couramment 20 ms) équilibrant surcoût et latence.
• Concevoir pour la gigue, la perte de paquets et la latence : jitter buffers, et attentes MOS réalistes.
• Planifier la gestion du DTMF (RFC 2833 / SIP INFO / in-band) de façon cohérente sur tout le chemin.
• Décider tôt des besoins d'enregistrement et de transcription — ils affectent le routage et le stockage du média.

• Vérifier les signatures de webhook et rejeter les événements non signés ou périmés.Un webhook de contrôle d'appel non authentifié est un risque de prise de contrôle.
• Répondre aux webhooks rapidement et effectuer le traitement lourd de façon asynchrone pour ne pas bloquer l'appel.
• Rendre les gestionnaires idempotents et dédupliquer sur les ID d'événement, car des réessais sont attendus.
• Corréler les jambes d'appel avec un ID d'appel/session stable à travers le transfert et la conférence.

• Dimensionner les canaux simultanés à partir du CPS × durée moyenne d'appel, puis ajouter une marge de pic.Appels simultanés ≈ appels par seconde × durée moyenne en secondes.
• Provisionner la capacité en trunks/canaux et confirmer les limites de concurrence et de CPS du fournisseur.
• Mettre à l'échelle les gestionnaires de webhook horizontalement et les garder sans état derrière une file d'attente.
• Tester la charge à la concurrence de pic et confirmer une dégradation gracieuse, pas une panne franche.

• Chiffrer la signalisation (SIP sur TLS) et le média (SRTP) là où proposé ; restreindre par allow-listing d'IP.
• Se protéger contre la fraude au péage et le Wangiri : limiter le débit et restreindre les destinations surtaxées à haut risque.
• Concevoir la bascule entre régions/fournisseurs afin qu'une seule panne ne fasse pas tomber tous les appels.
• Journaliser les enregistrements de détail d'appel (CDR) et les événements, et ne conserver l'audio que selon vos règles de conformité.
• Instrumenter les métriques de qualité (MOS, ASR, ACD) et alerter sur les chutes par route.