SMS avec Twilio

Sans Twilio, l’app n’envoie pas de SMS : les automatisations sur le canal SMS ne livrent rien, et la connexion par téléphone n’est pas disponible, parce que c’est Twilio qui envoie le code.

Avant de commencer

• Plan : n’importe lequel, y compris le Free ;
• Compte Twilio, avec une carte enregistrée pour acheter un numéro ;
• Un coût à deux endroits :
  • Twilio facture le numéro (abonnement mensuel) et chaque SMS, sur votre compte, selon sa grille ;
  • chaque SMS envoyé par l’app consomme des crédits d’intégration de la plateforme, et le SMS est le canal de notification le plus cher en crédits. Cela inclut chaque code de connexion par SMS. Le débit n’a lieu que quand Twilio accepte l’envoi.

Pas à pas

Champs de la carte : Account SID, Auth Token et Numéro d'expéditeur.

1. créez le compte sur twilio.com ;
2. dans la Console Twilio, la page d’accueil affiche l’Account SID (il commence par AC) et l’Auth Token (cliquez pour l’afficher) ;
3. dans Phone Numbers → Manage → Buy a number, achetez un numéro compatible SMS. Certains pays exigent un enregistrement réglementaire avant de débloquer le numéro : Twilio l’indique quand c’est le cas ;
4. dans l’éditeur de l’app, onglet Intégrations, catégorie Notifications, ouvrez la carte SMS (Twilio) ;
5. remplissez l’Account SID, l’Auth Token et, dans Numéro d'expéditeur, le numéro acheté au format international, avec le + et l’indicatif du pays (par exemple, +33612345678) ;
6. cliquez sur Enregistrer et activer.

Compte d’essai (trial)

Tant que le compte Twilio est en essai, il n’envoie qu’à des numéros vérifiés et le message arrive avec un préfixe de test. Pour tester, enregistrez votre numéro dans Verified Caller IDs dans la Console. Pour l’app en service, le compte doit sortir de l’essai.

Connexion par téléphone

Avec Twilio connecté, l’app peut proposer la connexion par numéro de téléphone et code reçu par SMS, ainsi que la récupération du mot de passe par le même chemin. Cela ne s’active pas dans l’onglet Authentification : c’est la présence de Twilio qui le débloque. La suite est dans Inscription et connexion dans votre app.

Mieux vaut prévoir le solde : chaque tentative de connexion par SMS est un SMS payé chez Twilio et un débit en crédits d’intégration. Avec un solde de crédits à zéro, le code n’est pas envoyé et la personne ne peut pas se connecter par téléphone.

Savoir que cela a fonctionné

La carte Twilio ne teste pas l’identifiant à l’enregistrement : Connectée veut dire que les champs ont été enregistrés. La preuve est un vrai SMS :

• si l’app a la connexion par téléphone, demandez un code avec votre numéro ;
• ou demandez dans le chat un bouton de test qui vous envoie un SMS (cela consomme des crédits d’IA, comme toute construction).

Dans la Console Twilio, sous Monitor → Logs → Messaging, chaque tentative apparaît avec son statut et, en cas d’échec, le motif.

Problèmes courants

• Aucun SMS n’arrive et rien n’apparaît dans les logs Twilio. L’identifiant est erroné. Ouvrez la carte et saisissez de nouveau le champ erroné (un champ vide conserve sa valeur enregistrée) ;
• Les logs indiquent un échec pour des numéros non vérifiés. Le compte est en essai. Vérifiez le numéro de destination ou sortez de l’essai ;
• Le numéro d’expéditeur est refusé. Il doit s’agir d’un numéro de votre compte Twilio compatible SMS, écrit avec le + et l’indicatif du pays ;
• L’envoi s’est arrêté du jour au lendemain. Vérifiez le solde de crédits d’intégration, dans le panneau sous Facturation, et le solde du compte Twilio lui-même.