Comment enregistrer un numéro de téléphone Twilio et envoyer un SMS à l'aide de la CLI Twilio

May 14, 2021
Rédigé par
Maciej Treder
Contributeur
Les opinions exprimées par les contributeurs de Twilio sont les leurs
Révisé par

Il existe plus de 4,5 milliards d'appareils dotés d'une fonction texte. Ce qui crée une belle opportunité pour informer les clients des rendez-vous à venir, des événements spéciaux, des dernières actualités ou des promotions commerciales par SMS. L'envoi de SMS par programmation permet de communiquer presque simultanément avec de nombreuses personnes. Avec Programmable SMS de Twilio, vous pouvez enregistrer votre propre numéro de téléphone virtuel et envoyer des SMS dans le monde entier.

Ce tutoriel explique comment configurer la CLI Twilio, enregistrer un numéro de téléphone et envoyer un SMS à l'aide du nouveau numéro

Remarque importante sur la conformité : il existe des règles relatives à l'utilisation de la messagerie SMS, qui varient selon les pays. Familiarisez-vous avec les règles du pays dans lequel vous allez envoyer des messages en lisant les directives réglementaires Twilio pour les SMS.

Prérequis

Pour réaliser le projet décrit dans ce tutoriel, vous aurez besoin des outils et ressources suivants :

  • Un compte Twilio – inscrivez-vous gratuitement avec ce lien et bénéficiez d'un bon d'achat de 10 $ lorsque vous passez à un compte classique.
  • La CLI Twilio – l'interface de ligne de commande Twilio nécessite Node.js et npm, qui est installé avec Node.js.

Obtenir un numéro de téléphone Twilio

Les messages Twilio SMS sont envoyés avec Phone Numbers de Twilio, qui fournit instantanément des numéros de téléphone locaux, nationaux, mobiles et gratuits dans plus de 100 pays grâce à une API conviviale pour les développeurs. Vous pouvez obtenir gratuitement un numéro de téléphone Twilio dans le cadre de votre compte d'essai.

Une fois que vous avez créé un compte Twilio, vous pouvez utiliser la CLI Twilio pour obtenir un numéro de téléphone.

Remarque : si vous avez déjà installé la CLI, assurez-vous de disposer de la dernière version en exécutant la commande suivante :

npm install -g twilio-cli

Si vous avez enregistré vos informations d'identification Twilio en tant que variables d'environnement, la CLI Twilio les utilisera automatiquement. Sinon, vous devrez vous connecter à l'aide de la commande suivante :

twilio login

Vous serez alors invité à saisir votre SID de compte et votre token d'authentification, tous deux disponibles sur la console Twilio.

Pour répertorier les numéros de téléphone disponibles pour l'enregistrement, utilisez la commande suivante, en remplaçant le code pays ISO 3166 alpha-2 approprié par « US », si nécessaire :

twilio api:core:available-phone-numbers:local:list --country-code US

Vous devriez voir une liste similaire à ce qui suit :

Phone Number  Region  ISO Country  Address Requirements
+13852101305  UT      US           none                
+14077922414  FL      US           none                
+16033712156  NH      US           none                
+16036367116  NH      US           none                
+18312751816  CA      US           none                
+14693316717  TX      US           none                
+18312751822  CA      US           none    

Copiez l'un des numéros de la liste et enregistrez-le sur votre compte Twilio en utilisant :

twilio api:core:incoming-phone-numbers:create --phone-number="+13852101305"

Si votre tentative d'enregistrement réussit, vous devriez voir :

SID                                 Phone Number  Friendly Name 
PN3ef900000000000000000000000000d9  +13852101305  (385) 210-1305

Une fois enregistré, le numéro de téléphone peut être utilisé (jusqu'à ce que vous le résiliiez à l'aide de la CLI ou de la console Twilio). Notez que le SID associé au numéro de téléphone est un secret d'utilisateur et qu'il doit être géré de manière sécurisée.

Afin de vérifier que le numéro a bien été ajouté à votre compte, vous pouvez utiliser la CLI Twilio pour envoyer un message de test. Exécutez la commande suivante, en prenant soin de remplacer les valeurs d'espace réservé par votre numéro de téléphone Twilio et votre numéro personnel compatible avec les SMS, au format E.164 :

twilio api:core:messages:create --from <your-twilio-phone-number> --to <SMS-receiver-phone-number> --body "Hello world"

Remarque : avec un compte d'essai, vous pouvez uniquement envoyer des messages aux numéros de téléphone que vous avez précédemment enregistrés sur votre compte. Le numéro de téléphone compatible avec les SMS que vous avez utilisé pour créer votre compte Twilio est le premier numéro que vous avez enregistré.

L'API renvoie une réponse similaire à la sortie ci-dessous pour indiquer que le SMS a bien été reçu et qu'il est en file d'attente pour être envoyé :

SID                                 From          To            Status  Direction     Date Sent
SM4a447328e80a43ceb8e61dda9f3d4cb6  +13852101305  +16463974810  queued  outbound-api  null  

Vous devriez recevoir sous peu un SMS sur votre téléphone :

Écran de verrouillage du téléphone portable avec un message SMS

Vous pouvez vérifier l'état de la demande de création de message à l'aide de la commande CLI suivante :

twilio api:core:messages:fetch --sid SM4a447328e80a43ceb8e61dda9f3d4cb6

Vous verrez une réponse similaire à ce qui suit :

SID                                 From          To            Status     Direction     Date Sent                    
SM4a447328e80a43ceb8e61dda9f3d4cb6  +13852101305  +16463974810  delivered  outbound-api  Mar 13 2020 14:17:20 GMT+0100

Si votre message n'est pas reçu, vous pouvez utiliser les journaux d'état de la console Twilio pour essayer d'identifier le problème. Si vous utilisez un compte d'essai Twilio, assurez-vous que vous envoyez le SMS à un numéro de téléphone enregistré.

Résumé

Dans cet article, vous avez appris à installer et à configurer la CLI Twilio et à obtenir un numéro de téléphone Twilio. Ce numéro est nécessaire pour utiliser certains produits Twilio tels que Programmable SMS. Vous avez également appris à envoyer des SMS à n'importe quel numéro compatible avec les SMS à travers le monde grâce à la CLI Twilio.

Ressources supplémentaires

Maciej Treder est Senior Software Development Engineer chez Akamai Technologies. Il est également conférencier international et l'auteur de @ng-toolkit. Pour en savoir plus à son sujet, visitez la page https://www.maciejtreder.com. Vous pouvez également le contacter à l'adresse suivante : contact@maciejtreder.com , ou le retrouver sur GitHub, Twitter, StackOverflow et LinkedIn : @maciejtreder.

Gabriela Rogowska a contribué à la rédaction de cet article.