Guide de démarrage rapide de Twilio SMS Python
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 Python peut envoyer et recevoir des SMS avec Twilio Programmable Messaging.
Ce Quickstart de Programmable Messaging vous guide pas à pas tout au long du processus, en commençant par la configuration de votre compte Twilio jusqu'à l'envoi d'un SMS à l'aide d'un Messaging Service.
Dans ce démarrage rapide, 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 des messages sortants
- Envoyer votre premier SMS sortant
- Configurer votre premier Messaging Service Twilio
- Envoyer un deuxième SMS à partir de ce service de messagerie
À la fin de ce démarrage rapide, vous aurez une base solide pour construire et faire évoluer votre système grâce à Twilio Programmable Messaging pour vos cas d'utilisation spécifiques.
Inscrivez-vous, ou connectez-vous, à Twilio
Vous avez déjà un compte Twilio ? Continuez et ignorez cette section.
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'accès, 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...
Installer la CLI Twilio
Nous allons utiliser l'interface de ligne de commande (CLI) Twilio pour quelques tâches, alors c'est le moment de l'installer.
L'une des manières les plus simples d'installer la CLI (interface de ligne de commande) sous macOS est d'utiliser Homebrew. Si vous ne l'avez pas déjà installé, rendez-vous sur le site Homebrew pour obtenir les instructions d'installation, puis revenez ici.
Une fois Homebrew installé, il vous suffit d'exécuter la commande suivante pour installer la CLI :
brew tap twilio/brew && brew install twilioMise à jour
Si vous avez déjà installé la CLI avec brew et que vous souhaitez effectuer la mise à niveau vers la dernière version, exécutez :
brew upgrade twilioAvertissement pour les développeurs Node.js
Si vous avez installé Node.js version 10.12 ou ultérieure sur votre Mac, vous pouvez éviter les conflits de version potentiels de Node.js en installant la CLI avec npm :
npm install twilio-cli -gAvant de commencer
Avant l'installation, nous devons nous assurer que Node.js est installé (version 12.21 ou ultérieure). Pour savoir si node est installé, essayez d'exécuter cette commande :
node -vSi votre système indique la version 12.21 ou ultérieure, vous pouvez ignorer l'étape suivante.
Installation de Node.js sous Windows
L'utilisation du programme d'installation Windows (.msi) est la méthode recommandée pour installer Node.js sous Windows. Vous pouvez télécharger le programme d'installation à partir de la page de téléchargement Node.js.
Exécutez PowerShell en tant qu'administrateur et saisissez la commande suivante :
Set-ExecutionPolicy Bypass -Scope ProcessVous devriez voir le résultat suivant :
Modification de la stratégie d'exécution
La stratégie d'exécution vous protège des scripts auxquels vous ne faites pas confiance. La modification de la stratégie d'exécution peut vous exposer
aux risques de sécurité décrits dans la rubrique d'aide about_Execution_Policies disponible à l'adresse
https:/go.microsoft.com/fwlink/?LinkID=135170. Voulez-vous modifier la stratégie d'exécution ?
[Y] Oui [A] Oui à tout [N] Non [L] Non à tout [S] Suspendre [?] Aide (la valeur par défaut est "N") :Saisissez Y pour confirmer la modification.
Remarque : vous devrez définir cette stratégie d'exécution à chaque fois que vous exécuterez PowerShell. Pour en savoir plus, reportez-vous aux remarques sur Set-ExecutionPolicy.
Versions de Windows testées
Ces instructions ont été testées sur les versions de Windows suivantes :
- Windows 10 Pro
- Windows Server 2016
Installation de la CLI Twilio
La CLI est installée avec npm (Node Package Manager), qui est fourni avec Node.js. Pour installer la CLI, exécutez la commande suivante :
npm install twilio-cli -gNotez que l'option -g installe la commande globalement pour que vous puissiez l'exécuter depuis n'importe quel emplacement dans votre système.
Mise à jour
Si vous avez déjà installé la CLI avec npm et que vous souhaitez effectuer la mise à niveau vers la dernière version, exécutez :
npm install twilio-cli@latest -gAvant l'installation, nous devons nous assurer que Node.js est installé (version 10.12 ou ultérieure). Même si vous avez déjà installé Node vous-même, la CLI fonctionne mieux lorsque vous l'installez à l'aide de nvm. Voici comment installer nvm sur la plupart des systèmes Linux :
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bashConsultez les instructions d'installation de nvm pour obtenir des options supplémentaires et des étapes relatives à l'analyse des problèmes. Une fois nvm installé, exécutez la commande suivante pour installer et utiliser la version LTS la plus récente de Node.js :
nvm install --lts
nvm use <insérez la version indiquée ci-dessus>Installation d'autres prérequis CLI Twilio pour Linux
Selon votre distribution, vous devrez exécuter l'une des commandes suivantes :
- Debian/Ubuntu :
sudo apt-get install libsecret-1-dev - Basé sur Red Hat :
sudo yum install libsecret-devel - Arch Linux :
sudo pacman -S libsecret
Installation de la CLI Twilio
La CLI est installée avec npm (Node Package Manager), qui est fourni avec Node.js. Pour installer la CLI, exécutez la commande suivante :
npm install twilio-cli -gNotez que l'option -g installe la commande globalement pour que vous puissiez l'exécuter depuis n'importe quel emplacement dans votre système.
Mise à jour
Si vous avez déjà installé la CLI avec npm et que vous souhaitez effectuer la mise à niveau vers la dernière version, exécutez :
npm install twilio-cli@latest -gExécutez twilio login pour connecter la CLI Twilio à votre compte. Rendez-vous sur https://www.twilio.com/console, et vous trouverez votre Account SID et votre Auth Token uniques à fournir à la CLI.
Vous pouvez afficher votre Auth Token en cliquant sur l'icône en forme d'œil :
Obtenir un numéro de téléphone
Si vous n'avez pas encore votre propre numéro de téléphone Twilio avec la fonctionnalité SMS, vous devez en acheter un. Avec la CLI, exécutez :
twilio phone-numbers:buy:local --country-code US --sms-enabledRemplacez US par votre code pays ISO-3166-1 si vous souhaitez un numéro de téléphone dans un autre pays. Si vous ne trouvez pas de numéros compatibles SMS, essayez de rechercher un numéro de téléphone portable au lieu d'un numéro local : twilio phone-numbers:buy:mobile --country-code DE --sms-enabled
Sélectionnez un numéro de téléphone pour l'ajouter à votre compte.
Ensuite, nous devons installer Python et la librairie Python Twilio.
Installer Python et la librairie Twilio
Si vous avez déjà effectué l'un de nos autres Quickstarts Python, que vous avez installé Python et la librairie Python Twilio, vous pouvez ignorer cette étape et passer directement à l'envoi de votre premier message texte.
Pour envoyer votre premier SMS, vous devez installer Python et la librairie Python Twilio.
Install Python
If you’re using a Mac or Linux machine, you probably already have Python installed. You can check this by opening up a terminal and running the following command:
python --versionYou should see something like:
$ python --version
Python 3.4Windows users can follow this excellent tutorial for installing Python on Windows, or follow the instructions from Python's documentation.
Twilio’s Python server-side SDK supports both Python 2 and Python 3. You can use either version for this quickstart, but we recommend using Python 3 for future projects with Twilio unless there are specific libraries your project needs which are only compatible with Python 2.
Install the Twilio Python Server-side SDK
The easiest way to install the library is using pip, a package manager for Python that makes it easier to install the libraries you need. Simply run this in the terminal:
pip install twilioIf you get a pip: command not found error, you can also use easy_install by running this in your terminal:
easy_install twilioIf you'd prefer a manual installation, you can download the source code (ZIP) for twilio-python and then install the library by running:
python setup.py installin the folder containing the twilio-python server-side SDK library code.
Envoyer un SMS sortant avec Python
Maintenant que Python et twilio-python 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.py et saisissez ou collez cet exemple de code.
Vous devrez modifier votre fichier send_sms.py un peu plus avant que votre message ne soit envoyé :
Remplacer les valeurs fictives des informations d'identification
Remplacez les valeurs fictives dans account_sid et auth_token par vos informations d'identification Twilio personnelles. Rendez-vous sur https://www.twilio.com/console et connectez-vous. Sur cette page, vous trouverez votre Account SID et Auth Token uniques de votre compte, dont vous aurez besoin à chaque fois que vous enverrez des messages via le Twilio Client. Vous pouvez afficher votre Auth Token en cliquant sur le lien « view » (voir) :
Ouvrez send_sms.py et remplacez les valeurs de account_sid et auth_token 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_ 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
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.
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 les Verified Caller IDs de votre console Twilio.
Lorsque vous envoyez un SMS à partir de votre numéro de téléphone d'essai gratuit, il commence toujours par « Sent from a Twilio trial account » (Envoyé depuis un compte d'essai Twilio). Nous supprimons ce message après la mise à niveau.
Enregistrez vos modifications et exécutez ce script à partir de votre terminal :
python send_sms.pyC'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 pour savoir comment procéder.
Dans cet exemple de code, nous effectuons une requête POST au point de terminaison message de l'API Programmable Messaging afin de créer un nouveau message sortant. Nous utilisons la méthode create intégrée de la bibliothèque twilio-python, mais vous pouvez effectuer cette requête à l'aide de la CLI Twilio (que vous avez déjà installée), de curl, ou d'un module de requête de votre choix.
Consultez les exemples de code pour envoyer un SMS avec la CLI Twilio et curl. N'oubliez pas de mettre à jour les paramètres body, to et from !
Configurer un Messaging Service Twilio
Félicitations, vous avez envoyé votre premier SMS avec Twilio Programmable Messaging et l'avez reçu sur votre appareil personnel.
À ce stade, nous avons acquis un numéro de téléphone Twilio et l'avons utilisé pour envoyer un SMS sortant. Vous pouvez imaginer qu'un jour, dans un avenir pas si lointain, vous aurez besoin d'un moyen plus robuste et riche en fonctionnalités pour envoyer des messages, par exemple :
- envoyer de nombreux messages sur une courte période
- gérer des opt-ins et des opt-outs
- vous assurer que vos clients bénéficient toujours d'une expérience de messagerie cohérente avec le même numéro de téléphone.
Dans la prochaine partie du Quickstart, nous allons vous guider dans la configuration de votre premier Messaging Service. Vous pouvez considérer un service de messagerie comme un conteneur pour stocker tous vos numéros de téléphone disponibles (et autres expéditeurs) et vous fournir les fonctionnalités dont vous pourriez avoir besoin tout au long de votre parcours de messagerie.
Créer un service de messagerie avec votre numéro de téléphone
Exécutez la commande CLI Twilio suivante pour créer un service de messagerie que nous utiliserons pour envoyer notre premier SMS programmable.
twilio api:messaging:v1:services:create --friendly-name "My first Messaging Service"Notez le Messaging Service SID (il commence par « MGXXX... »). Nous en aurons besoin pour envoyer notre prochain message.
Ensuite, ajoutez le numéro de téléphone que vous venez d'acheter. Vous avez oublié ce numéro ? Pas de problème, vous pouvez le répertorier avec la CLI Twilio :
twilio phone-numbers:list
# Grab the SID ("PNXXXX...") of your numberAjoutez votre numéro de téléphone à votre service de messagerie venant d'être créé à l'aide de la commande suivante :
twilio api:messaging:v1:services:phone-numbers:create --service-sid MGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX --phone-number-sid PNXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Envoyer un SMS à partir de votre service de messagerie
L'envoi d'un SMS sortant à partir d'un service de messagerie est similaire à l'envoi à partir d'un numéro de téléphone Twilio individuel. La principale différence est de remplacer le paramètre from_ par le paramètre messaging_service_sid pour indiquer que vous envoyez à partir d'un numéro de téléphone dans votre groupe d'expéditeurs de service de messagerie. (Actuellement, il n'y a qu'un seul numéro de téléphone dans votre groupe d'expéditeurs, nous allons donc envoyer à partir de celui-ci.)
Remplacez le paramètre messaging_service_sid
Vous vous souvenez du service de messagerie que vous venez de créer ? Au lieu du paramètre from_ et de votre numéro de téléphone, utilisez le paramètre messaging_service_sid avec le « MGXXXX... » de votre Messaging Service SID. Enregistrez vos modifications et exécutez ce script à partir de votre terminal :
python send_sms.pyEt cela vous permet d'envoyer un SMS à l'aide d'un service de messagerie Twilio ! Dans quelques secondes, vous devriez recevoir un deuxième SMS sur votre téléphone à partir de votre numéro de téléphone Twilio. Le service de messagerie a facilement sélectionné votre numéro dans son groupe d'expéditeurs pour envoyer ce deuxième message sortant.
L'étape suivante ?
Maintenant que vous avez envoyé vos premiers SMS, consultez les ressources suivantes pour poursuivre votre parcours de messagerie avec Twilio :
- En savoir plus sur les messages entrants avec Recevoir des SMS et MMS et y répondre
- Vous souhaitez envoyer avec WhatsApp ? Consultez notre démarrage rapide WhatsApp pour Python et notre guide pour l'envoi de notifications WhatsApp avec des modèles
- Construisez des notifications de serveur avec Twilio Programmable Messaging
- Consultez notre documentation de référence d'API pour Twilio SMS
- Suivez l'état de remise de vos messages avec Python
Nous avons hâte de voir ce que vous allez construire !
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.
