Intégration Twilio

RÔLE DE TWILIO DANS L'ARCHITECTURE

Twilio est l'infrastructure téléphonique qui connecte vos clients à votre bot IA. Lorsqu'un appel arrive sur votre numéro, Twilio établit une connexion WebSocket bidirectionnelle avec les serveurs AI ARTEDUSA, permettant le streaming audio en temps réel.

Le flux audio utilise le format mulaw (codec téléphonique standard) qui est converti en PCM (format audio numérique) par notre serveur pour le traitement STT et TTS.

NUMÉRO DE TÉLÉPHONE DÉDIÉ

Chaque tenant dispose d'un numéro Twilio dédié. Ce numéro est la clé d'identification du tenant : lorsqu'un appel arrive, notre système utilise le numéro appelé pour déterminer quel bot activer et quelle configuration charger.

Vous pouvez utiliser votre numéro existant (via portage) ou un nouveau numéro fourni par Twilio. Les numéros sont disponibles dans plus de 100 pays.

CONFIGURATION DES WEBHOOKS

Les webhooks Twilio sont configurés automatiquement lors de la connexion de votre numéro. Deux webhooks principaux sont mis en place :

• Webhook d'appel entrant : Déclenché à chaque nouvel appel, il initie la session WebSocket et active le bot
• Webhook de statut : Notifie notre système des changements de statut de l'appel (en cours, terminé, échoué)

VALIDATION DE SIGNATURE

Pour garantir la sécurité, chaque requête Twilio est accompagnée d'une signature cryptographique que notre serveur valide avant de traiter l'appel. Cette vérification empêche toute requête frauduleuse d'activer votre bot.

La validation de signature est activée par défaut et ne nécessite aucune configuration de votre part.