Services SMS et vocaux via Twilio

Twilio vous permet d'intégrer la voix, la VoIP et la messagerie à vos applications. La plate-forme Twilio comprend le TwiML (langage de balisage de Twilio), une API RESTful et des SDK VoIP pour les navigateurs Web, Android et iOS. Les bibliothèques d'aide sont disponibles dans plusieurs langages.

TwiML indique à Twilio le comportement à adopter lors des appels ou SMS entrants. Lorsque quelqu'un passe un appel ou envoie un SMS à l'un de vos numéros Twilio, la plate-forme recherche l'URL associée à ce numéro de téléphone et envoie une requête. Twilio lit ensuite les instructions TwiML au niveau de cette URL pour déterminer les actions à effectuer, comme enregistrer un appel ou envoyer un SMS.

L'API REST de Twilio vous permet d'interroger les métadonnées relatives à votre compte, vos numéros de téléphone, vos appels, vos SMS et vos enregistrements. Vous pouvez également initier des appels sortants et envoyer des SMS.

Prix

Pour en savoir plus, consultez la page des tarifs Twilio.

Avant de commencer

    Sélectionnez ou créez un projet Google Cloud Platform.

    Accéder à la page "Gérer les ressources"

Configurer

Pour créer cet exemple, vous utiliserez l'environnement d'exécution Python standard de Google App Engine. Si c'est la première fois que vous codez en Python pour Google App Engine, nous vous invitons à commencer par le tutoriel Hello World pour Python.

Une fois que vous avez une application "Hello, World!" fonctionnelle, vous devrez ajouter la bibliothèque Python de Twilio à votre application. Ce processus implique d'installer certains outils de gestion de packages, ainsi que la dernière version du module Twilio Python, puis de créer un lien symbolique vers la bibliothèque et ses dépendances dans votre application Google App Engine :

  1. Accédez au répertoire hébergeant votre application. Si vous avez suivi le tutoriel, il s'agit du répertoire helloworld que vous avez créé.

    cd helloworld
    
  2. Installez setuptools.

  3. Installez pip au moyen de setuptools :

    sudo easy_install pip
    
  4. Installez la bibliothèque Python de Twilio, ainsi que ses dépendances :

    pip install twilio
    
  5. Localisez votre répertoire site-packages, dans lequel pip aura installé la bibliothèque d'aide de Twilio :

    python -c "import site; print(site.getsitepackages()[0])"
    
  6. Créez un lien symbolique vers le module Twilio Python dans le répertoire de votre application. Remplacez {SITE_PACKAGES} par la valeur obtenue avec la commande précédente.

    ln -s {SITE_PACKAGES}/twilio .
    
  7. Créez un lien symbolique vers les dépendances du module Twilio Python dans votre répertoire d'application :

    ln -s {SITE_PACKAGES}/httplib2 .
    ln -s {SITE_PACKAGES}/six.py .
    

Vous avez maintenant installé la bibliothèque Twilio dans votre projet Google App Engine.

Recevoir un appel entrant

Pour créer votre première application avec Twilio, procédez comme suit :

Nous allons créer pas à pas votre première application intitulée "Hello Monkey".

Après avoir suivi les instructions de la section Configuration, modifiez helloworld.py pour qu'il ressemble à ceci.

Après avoir mis à jour helloworld.py, suivez ces instructions pour déployer votre projet dans App Engine.

Une fois votre projet déployé dans App Engine, vous pouvez envoyer une requête HTTP POST à http://<your app>.appspot.com/twiml, qui renvoie alors le texte suivant :

<?xml version="1.0" encoding="UTF-8"?>
  <Response>
  <Say>Hello Monkey!</Say>
</Response>

Copiez et collez l'URL http://<your app>.appspot.com/twiml dans la zone "Voice URL" (URL appels) de la page "Numbers" (Numéros) de votre compte Twilio.

Maintenant, appelez votre numéro Twilio ! En réponse, vous devriez entendre une voix prononcer les mots "Hello Monkey!". Lorsque vous appelez ce numéro, Twilio récupère votre URL et exécute les instructions XML répertoriées ci-dessus. Ensuite, Twilio raccroche, car il n'y a plus d'instructions à exécuter.

Envoyer un SMS

La bibliothèque d'aide twilio-python vous permet d'envoyer facilement un SMS sortant à l'aide de Twilio.

Pour envoyer un message SMS à l'aide de Twilio, procédez comme suit :

  1. Modifiez le fichier helloworld.py et indiquez votre "Account SID" (Identifiant de sécurité du compte) et votre "Auth Token" (Jeton d'authentification) (exemple). Ces valeurs sont disponibles dans votre compte Twilio.

  2. Modifiez les paramètres from_ et to pour utiliser des numéros de téléphone réels. Le numéro from_ doit être un numéro de téléphone Twilio valide enregistré dans votre compte. Pour cette démonstration, utilisez le numéro de téléphone que vous avez appelé dans l'exemple ci-dessus. Le numéro to peut être n’importe quel numéro sortant, par exemple votre numéro de téléphone portable.

  3. Déployez votre code mis à jour, puis déclenchez un SMS en chargeant le chemin d'accès de requête suivant pour votre application :

    http://<your app>.appspot.com/send_sms
    

Étapes suivantes

Maintenant que vous avez appris certaines fonctionnalités de base, consultez les pages ci-dessous pour découvrir d'autres fonctionnalités, ainsi que les bonnes pratiques à suivre pour concevoir des applications sécurisées et évolutives :

Cette page vous a-t-elle été utile ? Évaluez-la :

Envoyer des commentaires concernant…

Environnement standard App Engine pour Python 2