Dans le monde interconnecté d'aujourd'hui, la communication est essentielle, et l'une des formes de communication les plus omniprésentes reste le modeste message texte. Qu'il s'agisse d'envoyer des notifications, des alertes ou des messages promotionnels, la possibilité d'envoyer des messages SMS (Short Message Service) par programmation ouvre un monde de possibilités pour les développeurs. Entrez Twilio, une plateforme de communication cloud qui permet aux développeurs d'intégrer la fonctionnalité SMS de manière transparente dans leurs applications.
Introduction :
Dans ce tutoriel, nous allons explorer comment exploiter la puissance de Twilio avec la flexibilité de Node.js pour envoyer des messages SMS sans effort. Node.js, avec son modèle d'E/S non bloquant et son riche écosystème de packages, offre un environnement idéal pour la création d'applications évolutives et efficaces, tandis que Twilio simplifie l'envoi et la réception de messages SMS, la gestion de la livraison et la gestion des numéros de téléphone.
Que vous développiez un système de notification, que vous construisiez un chatbot d'assistance client ou que vous souhaitiez simplement intégrer la fonctionnalité SMS dans votre application, ce tutoriel vous guidera pas à pas tout au long du processus. À la fin, vous aurez une solide compréhension de la façon d'exploiter l'API de Twilio avec Node.js pour envoyer des messages SMS de manière fiable et sécurisée.
Alors, plongeons-nous et apprenons comment suralimenter vos applications Node.js avec les capacités SMS de Twilio !
Configuration d'un compte Twilio :
Avant d'envoyer des messages SMS avec Twilio et Node.js, la première étape consiste à configurer un compte Twilio.
Twilio propose un essai gratuit que vous pouvez utiliser pour tester tous ses services, tels que l'envoi de SMS avec un numéro gratuit qu'ils vous attribueront.
Pour commencer, inscrivez-vous à un compte gratuit.
Inscrivez-vous pour un compte gratuit Twilio :
Accédez au site Web de Twilio (https://www.twilio.com/) et inscrivez-vous pour un nouveau compte si vous ne l'avez pas déjà fait. Le processus d'inscription est simple et ne nécessite que des informations de base telles que votre adresse e-mail, votre nom complet et votre mot de passe.
Vérifiez votre adresse e-mail :
Selon Twilio
Cette vérification permet d'éviter une utilisation abusive de la plateforme Twilio et garantit le respect des réglementations en matière de télécommunications.
Après l'inscription, Twilio enverra un e-mail de vérification à l'adresse que vous avez fournie lors de l'inscription. Cliquez sur le lien de vérification dans l'e-mail pour confirmer votre adresse e-mail et activer votre compte Twilio.
Vérification du numéro de téléphone :
Cela aide Twilio à vérifier votre identité et vous permet également d'envoyer des messages de test à votre téléphone depuis votre compte Twilio en mode d'essai.
Après avoir vérifié votre e-mail, vous serez invité à vérifier votre numéro de téléphone. Twilio détecte automatiquement votre emplacement à l'aide de votre I.P. Assurez-vous de créer votre compte en utilisant un numéro que vous pouvez vérifier dans votre pays.
Accédez à votre tableau de bord Twilio :
Une fois votre compte vérifié, connectez-vous à votre compte Twilio pour accéder à la Console Twilio. La console est l'endroit où vous gérerez vos services Twilio, vos numéros de téléphone et vos informations d'identification API.
Obtenir les informations d'identification de l'API Twilio :
Dans la console Twilio, accédez à la section « Tableau de bord » ou « Paramètres » pour trouver votre SID de compte et votre jeton d'authentification. Ces informations d'identification sont essentielles pour authentifier vos requêtes lors de l'interaction avec l'API Twilio.
- SID du compte (identifiant du compte) : Il s'agit d'un identifiant unique pour votre compte Twilio. Il agit comme un nom d'utilisateur lors de l'envoi de requêtes API.
- Jeton d'authentification (jeton d'authentification) : Ce jeton servira de mot de passe pour authentifier vos requêtes API. Conservez-le en lieu sûr et ne le partagez jamais publiquement.
- Tnuméro de téléphone wilio : Ce téléphone est crucial, c'est ce que vous utiliserez pour envoyer des SMS et non votre numéro de téléphone.
En suivant ces étapes, vous aurez configuré avec succès votre compte Twilio, obtenu vos informations d'identification API et obtenu votre ou vos numéros de téléphone pour la messagerie SMS. Vous êtes maintenant prêt à intégrer Twilio à votre application Node.js et à commencer à envoyer des messages SMS par programmation.
N.B : Si votre compte d'essai gratuit expire, vous devrez acheter un numéro de téléphone que vous utiliserez pour envoyer un SMS.
Si vous ne voulez pas acheter un numéro de téléphone pour les tests, assurez-vous de créer votre compte uniquement lorsque vous êtes prêt à envoyer votre SMS.
Installation des dépendances :
Pour intégrer la fonctionnalité SMS de Twilio dans votre application Node.js, vous devrez configurer un nouveau projet Node.js et installer le SDK Twilio Node.js.
Avant de continuer avec les installations de dépendances, notez que nous n'utiliserons aucune interface utilisateur ni ne construirons une application frontale pour tester cela. Cependant, pour tester cela, nous allons Apidog une meilleure alternative à Postman.
Apidog est une plateforme intégrée pour la conception, le débogage, le développement, la simulation et les tests d'API.
Voici un guide utile pour bien comprendre ce qu'est Apidog et comment l'utiliser au maximum. Créez un compte pour vous préparer à l'étape de test API de cet article.
Maintenant, revenons à la configuration de Node.Js et Twilio. Suivez ces étapes pour commencer :
Configuration d'un nouveau projet Node.js :
Si vous ne l'avez pas déjà fait, créez un nouveau répertoire pour votre projet Node.js et accédez-y à l'aide de votre terminal ou de votre invite de commande.
mkdir twilio-sms-demo
cd twilio-sms-demo
Initialisation d'un projet Node.js :
Utilisez la commande suivante pour initialiser un nouveau projet Node.js. Cette commande créera un fichier package.json qui suivra les dépendances de votre projet.
npm init -y
Cette commande crée un fichier package.json avec des valeurs par défaut. Vous pouvez personnaliser ces valeurs selon vos besoins.
Installation du SDK Twilio Node.js :
Maintenant, vous devrez installer le SDK Twilio Node.js, qui fournit une interface pratique pour interagir avec l'API de Twilio à partir de vos applications Node.js. Vous pouvez utiliser npm ou yarn pour installer le SDK.
Utilisation de npm :
Exécutez la commande suivante pour installer le SDK Twilio Node.js ainsi que le framework Express à l'aide de npm :
npm install express twilio
Utilisation de yarn :
Si vous préférez utiliser yarn, exécutez plutôt la commande suivante :
yarn add express twilio
Cette commande téléchargera le SDK Twilio Node.js ainsi que le framework Express et l'ajoutera en tant que dépendance dans votre fichier package.json.
Si vous ne le savez pas, Express est un framework node.js qui facilite la création d'API.
Vérification de l'installation :
Après avoir installé le SDK Twilio, assurez-vous qu'il a été ajouté à votre fichier package.json. Vous devriez voir "twilio": "^x.x.x" répertorié sous la section dependencies.
De plus, vous pouvez vérifier que l'installation a réussi en vérifiant la présence du répertoire node_modules dans votre projet. Ce répertoire contient toutes les dépendances installées, y compris le SDK Twilio.
En suivant ces étapes, vous avez configuré avec succès un nouveau projet Node.js et installé le SDK Twilio Node.js, ouvrant la voie à l'intégration de la fonctionnalité SMS de Twilio dans votre application. Vous êtes maintenant prêt à commencer à écrire le code pour envoyer des messages SMS avec Twilio dans votre application Node.js.
Écriture du code Node.js :
Maintenant que vous avez configuré votre projet Node.js et installé le SDK Twilio, écrivons le code pour envoyer un message SMS à l'aide de Twilio en combinaison avec Express.
Création d'un nouveau fichier JavaScript :
Dans le répertoire de votre projet, créez un nouveau fichier JavaScript nommé index.js (ou tout autre nom que vous préférez) où vous écrirez le code pour envoyer des messages SMS.
touch index.js
Une fois que vous avez terminé, ouvrez le répertoire/dossier du projet dans n'importe quel IDE de votre choix. Si vous faites partie des personnes qui aiment la simplicité, vous aurez probablement VsCode installé. Ouvrez l'init du projet et vous devriez voir quelque chose de similaire à ce que j'ai ci-dessous ;
Ouvrez le fichier index.js et commençons à écrire du code. Collez le code suivant dans le fichier index.js.
const express = require('express');
const accountSid = "your_account_sid;
const authToken = "your_auth_token";
const client = require('twilio')(accountSid, authToken);
Dans le code ci-dessus, nous importons le module express au début du fichier. Nous avons également créé deux constantes (const) qui contiennent notre accountSid et authToken. Enfin, nous avons défini une autre constante où nous avons importé le module Twilio et lui avons passé le accountSid et le authToken.
Certaines personnes pourraient affirmer qu'il est préférable d'encapsuler le accountSid et le AuthToken dans un fichier .env. Vous pouvez le faire si vous le souhaitez, mais je vais juste simplifier les choses ici.
Écriture du code pour envoyer un message SMS :
Maintenant, écrivons le code pour envoyer un message SMS à l'aide de la méthode messages.create() de Twilio.
Dans ce même fichier index.js, ajoutez les codes suivants sous ce que nous avions en premier.
const app = express()
app.post('/send-sms', (req, res) => {
client.messages
.create({
body: 'Voici à quoi ressemble la réception d\'un SMS de test de Twilio. Init ?',
from: '+122345678', // Remplacez par votre numéro de téléphone Twilio, y compris l'indicatif du pays.
to: '+123456789' // le numéro de téléphone avec lequel vous avez vérifié votre compte.
})
.then(message => {
console.log('Message envoyé :', message.sid);
res.send('SMS envoyé avec succès !');
})
.catch(error => {
console.error('Erreur lors de l\'envoi du SMS :', error);
res.status(500).send('Échec de l\'envoi du SMS');
});
});
const PORT = 3000;
app.listen(PORT, () => {
console.log(`Le serveur est en cours d\'exécution sur le port ${PORT}`);
});
Dans ce code :
- Nous créons une application Express et définissons une route POST
/send-smspour gérer l'envoi de messages SMS. - Nous initialisons ensuite un client Twilio avec nos informations d'identification Twilio.
- À l'aide du client Twilio, nous envoyons un message SMS au numéro de téléphone du destinataire spécifié (
to) avec le corps du message fourni (body).
C'est tout ! Vous avez maintenant écrit le code Node.js pour envoyer des messages SMS à l'aide de Twilio et Express. N'oubliez pas de remplacer 'from' et 'to' par votre numéro de téléphone Twilio et votre numéro de téléphone vérifié.
Enregistrez le fichier, ouvrez votre terminal et tapez node index.js et cliquez sur Entrée. Si tout se passe bien, vous devriez voir quelque chose de similaire à ;
Test de notre API :
Si vous vous souvenez, j'ai mentionné que nous utiliserions Apidog pour tester nos API afin de voir si elles fonctionnent comme prévu. Alors, veuillez télécharger ou utiliser la version Web de Apidog pour tester l'API que nous venons de créer.
Encore une fois, voici un guide qui vous montrera comment démarrer avec Apidog.
Maintenant que vous connaissez Apidog, connectez-vous et créez votre premier projet - ou utilisez celui créé par défaut automatiquement pour vous. Après cela, cliquez sur « Nouvelle demande »
Après cela, une page vous sera affichée pour envoyer une requête.
Vous pouvez voir que j'envoie une requête POST à localhost:3000/send-sms et c'est parce que la route que nous avons définie sur notre application Web est /send-sms et que nous utilisons notre machine locale.
Si vous tapez la bonne route et appuyez sur le bouton d'envoi en haut à droite, vous recevrez une réponse. Dans mon cas, j'ai reçu une erreur - et l'erreur m'a été enregistrée dans mon terminal.
L'erreur était simple, le numéro de téléphone auquel j'ai essayé d'envoyer le SMS n'est pas vérifié - car j'utilise un compte d'essai, je dois vérifier mon numéro ou passer à la version supérieure pour envoyer des SMS à n'importe quel numéro de téléphone.
L'une des fonctionnalités intéressantes de Twilio est que vous pouvez afficher vos journaux et votre historique. J'ai consulté le mien et j'ai obtenu la réponse suivante ;
Toutes les API de mes tests ont échoué. Pouvez-vous deviner pourquoi ?
Mon to phone number n'était pas vérifié ;
Une fois que vous aurez vérifié ou mis à niveau votre compte vers un compte payant, vous pourrez recevoir un SMS.
Amélioration de l'application (facultatif) :
Une fois que vous avez réussi à implémenter l'envoi de messages SMS avec Twilio et Node.js, vous souhaiterez peut-être explorer des fonctionnalités supplémentaires et améliorer la fiabilité de votre application. Voici quelques améliorations facultatives que vous pouvez envisager :
Explorer des fonctionnalités Twilio supplémentaires :
Twilio propose un large éventail de fonctionnalités au-delà de la simple messagerie SMS. Vous pouvez explorer des fonctionnalités telles que :
- Envoi de MMS : Eaméliorez vos messages en envoyant du contenu multimédia tel que des images, des vidéos et des fichiers audio.
- Planification des messages : Planifiez l'envoi de messages SMS à une date et une heure spécifiques, idéal pour les rappels et les notifications.
Conclusion :
Dans ce tutoriel, nous avons exploré comment intégrer la fonctionnalité SMS de Twilio avec Node.js, vous permettant d'envoyer des messages SMS par programmation à partir de vos applications. Récapitulons les étapes clés impliquées :
Configuration du compte Twilio : Inscrivez-vous à un compte Twilio, obtenez vos informations d'identification API (SID de compte et jeton d'authentification) et vérifiez les numéros de téléphone pour la messagerie SMS.
Installation des dépendances : Configurez un nouveau projet Node.js, installez le SDK Twilio Node.js et configurez Twilio avec vos informations d'identification.
Écriture du code Node.js : Créez un nouveau fichier JavaScript pour envoyer des messages SMS, importez Express et le module Twilio, et écrivez du code pour envoyer des messages SMS à l'aide de la méthode messages.create() de Twilio.
Test du code à l'aide d'Apidog : Nous avons vu comment nous pouvons utiliser un outil de développement comme Apidog pour tester facilement nos API Node.js sans stress.
En suivant ces étapes, vous avez appris à exploiter la puissante API de Twilio avec la flexibilité de Node.js pour intégrer la fonctionnalité SMS dans vos applications. Au fur et à mesure que vous développez vos projets, n'hésitez pas à explorer d'autres fonctionnalités Twilio et à personnaliser vos applications pour répondre aux besoins spécifiques de vos utilisateurs.
Bon codage !
