Skip to main content

​
Avant de commencer

Twilio est le service qui permet à votre application de passer et de recevoir des appels, ainsi que d’envoyer des SMS. Votre application fournit l’interface ; Twilio fournit l’infrastructure télécom mondiale derrière. Pour le connecter, vous aurez besoin de deux identifiants depuis votre compte Twilio : Account SID et Auth Token. Ce sont les « clés » qui autorisent votre application à utiliser votre compte Twilio. Prérequis :
  • Un compte Twilio actif.
  • Un accès administrateur au CMS de votre application.
  • Recommandé : activer l’authentification à deux facteurs sur Twilio et stocker vos identifiants dans un gestionnaire de mots de passe sécurisé.

​
Étape 1 : Aller dans le CMS et ouvrir Intégrations

Ouvrez le CMS via ce lien direct : aller au CMS.
Dans le menu de gauche, sélectionnez Integrations puis Twilio. Vous verrez un panneau avec deux entrées : account_sid et auth_token. Twilio est marqué comme « Required » car sans lui, les fonctionnalités de téléphonie ne fonctionneront pas.

​
Étape 2 : Récupérer vos identifiants Twilio

Connectez-vous à votre Twilio Console.
Sur le tableau de bord du projet, vous verrez votre Account SID et votre Auth Token sous « Project Info » (le token peut être masqué ; cliquez sur « show » pour l’afficher). Copiez les deux valeurs. Assurez-vous d’utiliser les identifiants live (production), et non ceux de test. Exemples :
  • Account SID : VOTRE_ACCOUNT_SID
  • Auth Token : VOTRE_AUTH_TOKEN
Conseil : traitez l’Auth Token comme un mot de passe. Ne le partagez pas par e-mail ou via un chat.

​
Étape 3 : Ajouter les clés dans le CMS

Dans la section Twilio du CMS :
Cliquez sur Add API Key. Saisissez les informations de l’Account SID exactement comme suit :
  • Key Name : account_sid (valeur par défaut – ne la modifiez pas)
  • Key Value : VOTRE_ACCOUNT_SID
  • Description : Twilio Account SID
  • Active : coché
Enregistrez avec Save Key. Répétez le processus pour l’Auth Token :
  • Key Name : auth_token (valeur par défaut – ne la modifiez pas)
  • Key Value : VOTRE_AUTH_TOKEN
  • Description : Twilio Auth Token
  • Active : coché
Enregistrez avec Save Key. Notes importantes :
  • Les noms de clés doivent rester exactement account_sid et auth_token (tout en minuscules, avec underscore).
  • Marquez toujours les deux clés comme Active. Si l’une des deux est inactive, l’intégration ne fonctionnera pas.

​
Étape 4 : Vérifier que l’intégration est active

Après enregistrement, vous verrez les deux clés listées avec le statut Active. Vérifications rapides :
  • Actualisez la page Integrations et confirmez que Twilio n’affiche aucun avertissement.
  • Si vous avez déjà un agent configuré, lancez un appel de test depuis la section Agents. Si l’appel se connecte, Twilio est correctement intégré.

​
Configuration avancée (optionnelle)

  • Rotation du token : si vous pensez que votre Auth Token a été exposé, générez-en un nouveau dans Twilio et mettez-le à jour immédiatement dans le CMS.
  • Sous-comptes : si vous gérez plusieurs environnements ou clients, vous pouvez utiliser un Twilio subaccount (SID + token) distinct pour chaque projet afin d’isoler la facturation et l’usage.
  • Bonnes pratiques de sécurité : conservez l’Auth Token dans un gestionnaire de mots de passe, limitez qui peut le voir, et contrôlez l’accès à votre Twilio Console.

​
Erreurs fréquentes et solutions

  • Clés laissées inactives : account_sid et auth_token doivent être Active.
  • Changement des noms de clés : ils doivent rester exactement account_sid et auth_token. Toute variation casse l’intégration.
  • Copier/coller avec des espaces : vérifiez qu’il n’y a pas d’espace au début ou à la fin.
  • Utilisation des identifiants de test : la production nécessite des identifiants live.
  • Oubli d’enregistrer : cliquez toujours sur Save Key après avoir saisi les valeurs.
  • Token régénéré non mis à jour : si vous régénérez l’Auth Token dans Twilio sans le mettre à jour dans le CMS, les appels échoueront.

​
Communication fiable avec Twilio

Une fois connecté, votre application peut passer des appels et envoyer des SMS de manière fiable. Gardez vos clés actives, sécurisées et à jour : vous aurez une base solide pour faire évoluer vos workflows de communication.