Ce que vous voyez
Le nouvel appel est refusé ou coupé; aucun contrôle ne doit être retiré pour le faire passer.
État d’avancement:Logiciel présent, service public absentfiche de référencemise en service interdite pour l’instantÉtat réel:Code bridge localpage d’autorité composantpromotion NO-GO
Choisissez votre lectureCommencez par la vue sans jargon si vous découvrez le sujet.
À qui s’adresse chaque lecture?
Je veux comprendre: direction, équipes métier, communication, achats et première visite. Exploitation: opérateur, support et astreinte. Vue architecte: architecte, ingénieur et sécurité. Tout afficher: revue complète de la fiche.
« Je veux comprendre » affiché. Ce choix sera repris sur les autres fiches. La décision de mise en service et les risques restent toujours visibles.
Comprendre cette fonction en 60 secondes
Le résumé donne le rôle, le trajet, le risque, le responsable et la limite de preuve en moins d’une minute. Les dépendances et exemples restent disponibles juste après, sans jargon imposé.
Résumé essentiel
Ce que c’est et à quoi cela sert
Recevoir un appel Twilio sans ouvrir une porte non contrôlée.
Vérifier chaque demande publique avant de relier l’appel à l’assistant vocal.
Une comparaison utile
Comme l’accueil d’un bâtiment: chaque arrivée suit la bonne entrée.
Ce qui entre
Twilio annonce un appel et demande l’ouverture du son en direct.
Qui en bénéficie et quel résultat attendre
Seul le bon appel, destiné au bon numéro, ouvre une unique session audio autorisée.
La personne qui appelle et l’équipe téléphonique.
État actuel
Logiciel présent, service public absent. Le logiciel et ses contrôles existent, mais il accepte seulement les connexions de la même machine. Aucun accès public, numéro actif, service redondant ou appel réel n’est attesté. Mise en service interdite pour l’instant.
Risque principal
Le nouvel appel est refusé ou coupé; aucun contrôle ne doit être retiré pour le faire passer.
Responsable
Responsable de l’intégration Twilio. Autorité de décision: Architecte sécurité téléphonie.
Décision suivante
Autoriser cette liaison seulement après preuve que signature, numéro, appel et session audio restent liés de bout en bout.
Voir les dépendances, preuves et solutions de secours
Ce qui entre, en langage courant
Twilio annonce un appel et demande l’ouverture du son en direct.
Ce dont il dépend
Du fournisseur téléphonique, du réseau et des autres fonctions de la cellule qui traite l’appel.
Comment le service continue
Refuser la nouvelle session VoiceBot et conserver uniquement un parcours PBX ou humain déjà approuvé. Aucun appel actif n’est migré entre bridges.
Preuve attendue avant la prochaine étape
Webhooks valides et hostiles, Media Streams unique, appel réel autorisé, coupures, charge, rotation et journaux expurgés.
Statut expliqué
Le logiciel sait vérifier qu’une demande vient de Twilio et qu’elle concerne le bon appel. Cette fiche ne prouve pas qu’un numéro public arrive réellement jusqu’à lui ni qu’un appel survivrait à sa panne. Il reste à fournir un point d’entrée public protégé, configurer Twilio, exercer de vrais appels autorisés, mesurer la charge et organiser la reprise.
Exemple concret
Twilio annonce un appel et demande l’ouverture du son en direct. Seul le bon appel, destiné au bon numéro, ouvre une unique session audio autorisée.
Voir l’exemple technique précis
Le bridge vérifie la signature et le numéro appelé, réserve un CallSid, puis accepte un seul WebSocket média correspondant.
Voir les questions et réponses selon votre rôle
Les six lectures ci-dessous reprennent les mêmes faits. Elles ne créent pas une seconde source de vérité.
- Direction
- Question: Peut-on compter sur cette fonction aujourd’hui?
Réponse: Le logiciel sait vérifier qu’une demande vient de Twilio et qu’elle concerne le bon appel. Cette fiche ne prouve pas qu’un numéro public arrive réellement jusqu’à lui ni qu’un appel survivrait à sa panne. Autoriser cette liaison seulement après preuve que signature, numéro, appel et session audio restent liés de bout en bout. - Métier
- Question: Quel service rend-elle concrètement?
Réponse: Vérifier chaque demande publique avant de relier l’appel à l’assistant vocal. Seul le bon appel, destiné au bon numéro, ouvre une unique session audio autorisée. - Achats et conformité
- Question: De quoi dépend l’engagement et qu’est-ce qui manque?
Réponse: Du fournisseur téléphonique, du réseau et des autres fonctions de la cellule qui traite l’appel. Il reste à fournir un point d’entrée public protégé, configurer Twilio, exercer de vrais appels autorisés, mesurer la charge et organiser la reprise. Preuve attendue: Webhooks valides et hostiles, Media Streams unique, appel réel autorisé, coupures, charge, rotation et journaux expurgés. - Communication
- Question: Que peut-on annoncer sans faire de fausse promesse?
Réponse: Vous pouvez expliquer l’objectif suivant: Vérifier chaque demande publique avant de relier l’appel à l’assistant vocal. Ne présentez pas cette fonction comme disponible en production: Le logiciel sait vérifier qu’une demande vient de Twilio et qu’elle concerne le bon appel. Cette fiche ne prouve pas qu’un numéro public arrive réellement jusqu’à lui ni qu’un appel survivrait à sa panne. - Exploitation
- Question: Qui agit et quel est le premier geste sans risque?
Réponse: Responsable de l’intégration Twilio. Autorité de décision: Architecte sécurité téléphonie. Fermer l’admission des nouvelles sessions, vérifier la signature et la réservation CallSid, puis contrôler l’ingress sans affaiblir les gardes. - Technique
- Question: Où sont les contrats exacts?
Réponse: Utilisez la « Vue architecte ». Elle montre les entrées, les sorties, les interfaces, les données, la sécurité et les preuves provenant de la fiche d’autorité.
Trajet simple, de la situation au résultat
Le trajet montre ce qui déclenche cette fonction, le service qu’elle rend et le résultat obtenu. Il reste lisible sans fonction interactive.
Suivre le flux
Partie documentée: Recevoir un appel Twilio sans ouvrir une porte non contrôlée.
Twilio annonce un appel et demande l’ouverture du son en direct.
Vérifier chaque demande publique avant de relier l’appel à l’assistant vocal.
Seul le bon appel, destiné au bon numéro, ouvre une unique session audio autorisée.
Comment lire ce trajet: avancez avec les flèches du clavier ou sélectionnez une étape. Les contrats exacts restent dans la « Vue architecte ».
Étape 1 sur 3: Twilio annonce un appel et demande l’ouverture du son en direct.
Impact utile: Seul le bon appel, destiné au bon numéro, ouvre une unique session audio autorisée.
En cas de panne: Le nouvel appel est refusé ou coupé; aucun contrôle ne doit être retiré pour le faire passer.
Responsable: Responsable de l’intégration Twilio. Autorité de décision: Architecte sécurité téléphonie.
Premiers gestes en cas de problème
Reconnaître ce qui se passe, protéger le service et prévenir le bon responsable sans improviser.
Première action sans risque
Fermer l’admission des nouvelles sessions, vérifier la signature et la réservation CallSid, puis contrôler l’ingress sans affaiblir les gardes.
Solution de secours
Refuser la nouvelle session VoiceBot et conserver uniquement un parcours PBX ou humain déjà approuvé. Aucun appel actif n’est migré entre bridges.
Qui prévenir et où lire les preuves
Responsable de l’intégration Twilio. Autorité de décision: Architecte sécurité téléphonie. La procédure de production reste à créer et valider avant la mise en service. Ouvrir la fiche d’architecture et de preuve du domaine.
Besoin d’un terme technique? Ouvrir les définitions
- CallSid
- identifiant d’appel Twilio
- Media Streams
- audio d’appel transporté par WebSocket
- Webhook
- appel HTTP reçu d’un service tiers
Décision actuelle: mise en service interdite pour l’instant. Le logiciel sait vérifier qu’une demande vient de Twilio et qu’elle concerne le bon appel. Cette fiche ne prouve pas qu’un numéro public arrive réellement jusqu’à lui ni qu’un appel survivrait à sa panne. Ce qui reste à faire: Il reste à fournir un point d’entrée public protégé, configurer Twilio, exercer de vrais appels autorisés, mesurer la charge et organiser la reprise.Décision actuelle: promotion NO-GO, pas de mise en production. Le code valide la signature Twilio, l’URL publique reconstruite, le numéro To allowlisté et le CallSid réservé avant d’accepter un seul Media Streams WSS. Le serveur écoute par défaut sur 127.0.0.1:3103. Aucun ingress, webhook Twilio configuré, numéro public, appel PSTN, HA ou reprise active n’est attesté. Blockers: Ingress public, secret provisionné et rotatif, configuration Twilio, appels réels, protection DDoS, redondance, reprise, charge, journalisation expurgée et SLO restent à prouver.
Opérer le composant
Responsabilité, séquence nominale, panne et niveau de service attendu.
| Owner et rôle | Séquence nominale | Mode dégradé | Observabilité et SLO |
|---|---|---|---|
| Admet un webhook Twilio et une session Media Streams par appel. Owner intégration téléphonie et sécurité. Non-rôle: N’est ni un SBC carrier, ni une preuve de numéro public actif, ni une terminaison publique directe depuis son port local. | Le bridge vérifie la signature et le numéro appelé, réserve un CallSid, puis accepte un seul WebSocket média correspondant. | Une seconde session est refusée; une perte du bridge coupe l’appel actif. Aucune réplication, reconnexion, bascule ou capacité multi-instance n’est prouvée. | Le niveau de preuve est Code bridge local. Aucun SLO de production n’est acquis; l’owner doit mesurer disponibilité, erreurs, saturation et reprise avant promotion. |
Déplier ou replier les détails d’architecture
Contrat d’architecture
Entrées, sorties, protocoles, données, dépendances et configuration.
| Amont et entrées | Aval et sorties | Interfaces et trust boundary | État, données et déploiement |
|---|---|---|---|
| Webhook HTTPS et Media Streams WSS de Twilio, via un ingress public approuvé. | Session VoiceBot, STT, TTS et settlement du tour; aucun appel actif ne migre vers une autre instance. | HTTPS public puis WSS Twilio via ingress approuvé; le processus écoute par défaut sur 127.0.0.1:3103. Signature, URL publique, To allowlisté et CallSid réservé sont contrôlés. | Code existant, une réservation active et un seul socket média correspondant. Dépend de Twilio, d’un ingress, du VoiceBot, du STT et du TTS; aucun numéro ni webhook public n’est attesté. Déploiement: Code et tests locaux uniquement; l’exposition publique doit appartenir à un ingress distinct et approuvé. |
Déplier ou replier les détails de sécurité et de preuve
Sécurité, preuve et décision
Le statut de preuve reste visible quel que soit le profil choisi.
| Sécurité et identité | Preuve et sources | Blockers | Définitions |
|---|---|---|---|
HTTPS public puis WSS Twilio via ingress approuvé; le processus écoute par défaut sur 127.0.0.1:3103. Signature, URL publique, To allowlisté et CallSid réservé sont contrôlés. | Niveau de preuve: Le code valide la signature Twilio, l’URL publique reconstruite, le numéro To allowlisté et le CallSid réservé avant d’accepter un seul Media Streams WSS. Le serveur écoute par défaut sur 127.0.0.1:3103. Aucun ingress, webhook Twilio configuré, numéro public, appel PSTN, HA ou reprise active n’est attesté. Les requêtes invalides sont détruites avant média. Egress et ingress Twilio franchissent une frontière tierce. Source: server/twilio-crisis-bridge.ts, lib/twilio-request-security.ts. Appel public, DDoS, rotation, charge et SLO: NO-GO.Vue d’autorité du domaine · Entrée du catalogue | NO-GO: Ingress public, secret provisionné et rotatif, configuration Twilio, appels réels, protection DDoS, redondance, reprise, charge, journalisation expurgée et SLO restent à prouver. | Consulter les définitions de cette fiche |