Guide de démarrage rapide Programmable SMS pour Node.js
Bonjour à tous, Toutes les communications transmises par l'intermédiaire des canaux de messagerie de Twilio sont traités comme des messages de solutions SMS A2P et sont soumis à la politique de messagerie de Twilio. Pour obtenir des informations détaillées sur les règles de la politique à respecter en utilisant les services de Twilio, veuillez consulter notre politique d'utilisation acceptable.
Avec seulement quelques lignes de code, votre application Node.js peut envoyer et recevoir des messages textes avec Twilio Programmable SMS.
Ce Quickstart (démarrage rapide) Node.js SMS vous apprendra à le faire à l'aide de notreCommunications REST API et de la librairie Node.js Twilio.
Dans ce Quickstart, vous apprendrez à :
- Vous inscrire à Twilio et obtenir votre premier numéro de téléphone Twilio compatible SMS
- Configurer votre environnement de développement pour envoyer et recevoir des messages
- Envoyer votre premier SMS
- Recevoir des messages texte entrants
- Répondre aux messages entrants avec un SMS
Vous préférez vous lancer en regardant une vidéo ? Regardez notrevidéo Quickstart Node.js SMS sur YouTube.
Inscrivez-vous à Twilio et obtenez un numéro de téléphone Twilio
Si vous disposez déjà d'un compte Twilio et d'un numéro de téléphone Twilio compatible SMS, vous avez tout ce qu'il vous faut ! N'hésitez pas à passer à l'étape suivante.
Vous pouvez créer un compte d'essai gratuit Twilio ici.
- Lorsque vous vous inscrivez, vous serez invité à vérifier votre numéro de téléphone personnel. Cela permet à Twilio de vérifier votre identité et d'envoyer des messages de test à votre téléphone depuis votre compte Twilio en mode d'essai.
- Une fois que vous aurez vérifié votre numéro, une série de questions vous sera posée pour personnaliser votre expérience.
- Une fois que vous aurez terminé le processus d'intégration, vous arriverez sur le tableau de bord de votre projet dans la console Twilio. C'est ici que vous pourrez accéder à votre Account SID (SID de votre compte), à votre Auth Token (jeton d'authentification), trouver un numéro de téléphone Twilio et plus encore...
Si vous n'avez pas encore votre propre numéro de téléphone Twilio avec la fonctionnalité SMS, vous devez en acheter un. Après avoir accédé à la page Buy a Number (Acheter un numéro), cochez la case "SMS" et cliquez sur "Search."
Vous verrez alors une liste des numéros de téléphone disponibles et de leurs capacités. Trouvez le numéro qui vous convient et cliquez sur "Buy" (Acheter) pour l'ajouter à votre compte.
Si vous avez déjà effectué l'un de nos autres démarrages rapides de Node.js et que vous avez installé Node.js et la librairie Node.js Twilio, vous pouvez ignorer cette étape et passer directement à l'envoi de votre premier message texte.
Pour envoyer votre premier SMS, vous devrez installer Node.js et le module Twilio Node.js.
Installer Node.js
Vous pouvez vérifier si Node.js est déjà installé sur votre ordinateur en ouvrant un terminal et en exécutant la commande suivante :
node --version
Vous devriez voir quelque chose comme :
$ node --version
v8.9.1
Si Node.js n'est pas installé, rendez-vous sur nodejs.org et téléchargez le programme d'installation approprié pour votre système. Une fois que vous avez installé Node, revenez dans votre terminal et exécutez à nouveau la commande ci-dessus. Si vous ne voyez pas la version de Node installée, vous avez peut-être besoin de relancer votre terminal.
Installer le module Twilio Node.js
Installez la librairie Node Twilio à l'aide denpm:
npm install twilio
Cette opération va installer le module « Twilio » de façon que les scripts Node.js du répertoire actuel puissent l'utiliser.
Envoyer un message SMS sortant avec Node.js
Maintenant que Node.js et la librairie Node.js Twilio sont installés, nous pouvons envoyer un message texte sortant à partir du numéro de téléphone Twilio que nous venons d'acheter avec une requête API simple. Créez et ouvrez un nouveau fichier appelé send_sms.js et saisissez ou collez cet exemple de code.
Vous devrez modifier ce fichier un peu plus avant que votre message ne soit envoyé :
Remplacer les valeurs des informations d'identification d'espace réservé
Remplacez les valeurs d'espaces réservés dans accountSid et authToken par vos informations d'identification Twilio personnelles. Rendez-vous surhttps://www.twilio.com/console et connectez-vous. Sur cette page, vous trouverez votre Account SID et le jeton d'authentification (Auth Token) uniques de votre compte, dont vous aurez besoin à chaque fois que vous enverrez des messages via le client Twilio.
Ouvrez send_sms.js et remplacez les valeurs de accountSid et authToken par vos valeurs uniques.
Remarque : il est possible de coder en dur vos informations d'identification lors de la mise en route, mais vous devez utiliser des variables d'environnement pour les garder secrètes avant le déploiement en production. Pour plus d'informations, consultez la procédure sur comment paramétrer des variables d'environnement.
Remplacer le numéro de téléphone « from » (De)
Vous vous souvenez du numéro de téléphone compatible SMS que vous avez acheté il y a quelques minutes ? Remplacez le numéro d'origine from (De) existant par celui-ci, en veillant à utiliser le format E.164 :
[+][code pays][numéro de téléphone avec indicatif régional]
Remplacer le numéro de téléphone « to » (À)
Remplacez le numéro de téléphone to (à) par votre numéro de téléphone portable. Il peut s'agir de n'importe quel numéro de téléphone qui peut recevoir des messages textes, mais il est recommandé de le tester avec votre propre téléphone pour que la magie opère ! Comme ci-dessus, vous pouvez utiliser le formatage E.164 pour cette valeur.
Enregistrez vos modifications et exécutez ce script à partir de votre terminal :
node send_sms.js
C'est tout ! Dans quelques instants, vous devriez recevoir un SMS de votre numéro Twilio sur votre téléphone.
Vos clients sont-ils aux États-Unis ou au Canada ? Vous pouvez également leur envoyer des messages MMS en ajoutant une seule ligne de code. Consultez ce [guide sur l'envoi de MMS] (https://www.twilio.com/docs/guides/how-to-send-sms-messages-in-node-js#send-a-message-with-media-mms-in-nodejs) pour savoir comment procéder.
Si vous utilisez un compte d'essai Twilio, vos SMS sortants sont limités aux numéros de téléphone que vous avez vérifiés auprès de Twilio. Les numéros de téléphone peuvent être vérifiés via votre Twilio Console's Verified Caller IDs(ID d'appelant vérifiésde la console Twilio) .
Recevoir des SMS entrants et y répondre avec Express
Lorsque votre numéro Twilio reçoit un message entrant, Twilio envoie une requête HTTP à un serveur que vous contrôlez. Ce mécanisme de rappel est appelé webhook. Lorsque Twilio envoie une requête à votre application, elle attend une réponse au format XML TwiML lui indiquant comment répondre au message. Voyons comment nous pourrions créer cela dans Node.js à l'aide d'Express.
Sur la ligne de commande de votre répertoire actuel, exécutez la commande suivante :
npm install express
Créez un fichier appelé « server.js » et utilisez le code suivant pour créer un serveur capable de gérer les messages entrants.
Exécutez ce serveur à l'aide de la commande suivante :
node server.js
Vous verrez que le serveur démarre sur le port 1337.
Avant que Twilio puisse envoyer vos requêtes de webhook d'application, vous devez rendre votre application accessible sur Internet. Bien que vous puissiez le faire de différentes manières, nous vous recommandons d'utiliser l'interface de ligne de commande (CLI) Twilio lors du développement local. Nous allons vous montrer comment configurer cette fonction pour que votre application puisse recevoir des messages.
Installer la CLI Twilio
Pour installer la CLI Twilio, exécutez la commande suivante :
npm install -g twilio-cliExécutez twilio login pour connecter la CLI Twilio à votre compte. Rendez-vous surhttps://www.twilio.com/console, et vous trouverez votre SID de compte (Account SID) et votre jeton d'authentification (Auth Token) uniques à fournir à la CLI.
Vous pouvez afficher votre jeton d'authentification en cliquant sur l'icône en forme d'œil :
Vous pouvez désormais utiliser la CLI pour connecter votre numéro de téléphone à votre application Node.js.
Configurer votre URL Webhook
À présent, vous devez configurer votre numéro de téléphone Twilio pour appeler l'URL de votre webhook chaque fois qu'un nouveau message arrive. Il vous suffit d'exécuter cette commande CLI en remplaçant le numéro de téléphone par votre numéro de téléphone Twilio :
twilio phone-numbers:update "+15017122661" --sms-url="http://localhost:1337/sms"Que se passe-t-il ici ?
Nous utilisons l'interface de ligne de commande Twilio pour définir l'URL du webhook SMS pour votre numéro de téléphone. Twilio fera une requête pour cette URL chaque fois qu'un nouveau SMS sera reçu. La CLI utilise égalementngrokpour créer un tunnel permettant à Twilio d'atteindre votre serveur de développement local (alias « localhost »).
Vous pouvez également utiliser la console Twilio pour définir un webhook dans votre navigateur Web, mais vous devrez démarrer ngrok vous-même.
Tester votre application
Assurez-vous que vous exécutez node server.js et votre commandetwiliosur la ligne de commande (dans des onglets distincts).
Avec ces deux serveurs en cours d'exécution, nous sommes prêts à tester notre nouvelle application Express !
Envoyez un SMS depuis votre téléphone portable vers votre numéro de téléphone Twilio configuré avec ce webhook. Une requête HTTP devrait s'afficher dans votre console ngrok. Votre application Express traitera le SMS et vous recevrez votre réponse sous forme de SMS.
L'étape suivante ?
Maintenant que vous connaissez les bases de l'envoi et de la réception de SMS et de MMS avec Node.js, vous pouvez consulter ces ressources.
- Documentation d'API REST
- Documents de référence TwiML
- Tutoriels avec des exemples complets d'applications dans Node.js
- Envoyez un texte dans Node en 30 secondes avec Twilio
- Recevoir des messages texte et y répondre avec Node.js, Express et Twilio
Bonne personnalisation !
Besoin d'aide ?
Ça arrive à tout le monde, il est parfois difficile de coder. Obtenez de l'aide dès maintenant auprès de notre équipe d'assistance, ou appuyez‑vous sur la sagesse collective en visitant le collectif Stack Overflow Twilio ou en parcourant le tag Twilio sur Stack Overflow.
