Guide de démarrage rapide de Twilio SMS PHP

Au bout de quelques lignes de code, votre application PHP peut envoyer, recevoir et répondre à des messages texte avec Twilio Programmable SMS.

Ce quickstart (guide de démarrage rapide) de PHP SMS vous montre comment utiliser notre API REST Communications, la CLI (interface de ligne de commande) Twilio et la librairie PHP Twilio.

Nous utiliserons le gestionnaire de packages Composer pour gérer nos dépendances de produits. Si vous ne souhaitez pas utiliser Composer, aucun problème : nous avons également un quickstart séparé de PHP SMS sans Composer.

Dans ce quickstart, vous apprendrez à :

1. Vous inscrire à Twilio et acheter un numéro de téléphone compatible SMS.
2. Vérifier et installer les conditions préalables à l'aide de Composer.
3. Envoyer votre premier SMS.
4. Configurer votre environnement de développement pour envoyer et recevoir des messages.
5. Recevoir des messages texte entrants.
6. Répondre aux messages entrants par SMS de retour.

Inscrivez-vous ou connectez-vous à Twilio

Installer la CLI Twilio

Nous allons devoir utiliser la CLI Twilio pour quelques tâches, alors installons-la maintenant.

Exécutez la connexion Twilio pour connecter la CLI Twilio à votre compte. Rendez-vous sur https://www.twilio.com/console, et vous trouverez votre Account SID (SID de compte) et votre Auth Token (jeton d'authentification) 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-enabled

Sélectionnez un numéro de téléphone pour l'ajouter à votre compte.

Ensuite, nous devons installer PHP et la librairie PHP Twilio.

Installer PHP et la librairie PHP Twilio

Pour envoyer votre premier SMS, assurez-vous que vous avez configuré PHP et que vous pouvez installer la librairie PHP Twilio. Lors du développement Web dans PHP, nous vous recommandons vivement d'utiliser Composer pour la gestion des packages. Ce quickstart s'appuie sur Composer pour installer la librairie PHP. Si vous choisissez de ne pas utiliser Composer, veuillez consulter notre quickstart de PHP SMS sans Composer.

Installer PHP

Si vous utilisez un ordinateur Mac ou *nix, PHP est peut-être déjà installé. Dans votre terminal préféré, exécutez :

php --version

S'il n'est pas installé, suivez les instructions d'installation de PHP.

Si vous utilisez un ordinateur Windows, suivez le tutoriel PHP officiel pour installer PHP.

Installer Composer

Composer est le gestionnaire de packages standard de facto pour le développement Web PHP. Si vous ne l'avez pas encore installé, voici les instructions d'installation pour votre plateforme :

• Installer Composer pour MacOS, Linux ou Unix
• Installer Composer pour Windows

Si vous préférez installer les dépendances manuellement, consultez notre quickstart de PHP SMS sans Composer.

Installer la librairie PHP Twilio

Nous devons installer la librairie PHP Twilio dans le répertoire où vous allez effectuer le quickstart. Si vous utilisez Composer, il existe deux façons de le faire.

Tout d'abord, à partir d'un terminal, vous pouvez exécuter la commande suivante :

composer require twilio/sdk

Vous pouvez également créer un fichier nommé composer.json, puis y ajouter les éléments suivants :

{
    "require": {
        "twilio/sdk": "^5.0"
    }
}

Puis exécutez

composer install

Et Composer va récupérer la dernière version de la bibliothèque d'aide PHP Twilio.

Enfin, pour une installation sans Composer, suivez les instructions ici. Vous devrez également modifier les exemples de code tels qu'ils apparaissent dans ce quickstart, comme indiqué dans ces instructions.

Envoyer un SMS sortant avec PHP

Maintenant que PHP, Composer et twilio-php sont installés, nous pouvons effectuer une seule requête d'API et envoyer un message texte sortant à partir de notre numéro de téléphone Twilio. Créez et ouvrez un nouveau fichier appelé send_sms.php et saisissez ou collez cet exemple de code.

Remplacez les identifiants Twilio de l'espace réservé

Remplacez les espaces réservés dans account_sid et auth_token par vos identifiants Twilio personnels. Remplacez les valeurs de account_sid et auth_token par vos valeurs uniques.

Remplacez le numéro de téléphone twilio_number

Auparavant, vous avez acheté un numéro de téléphone compatible SMS. Collez ce numéro dans la variable twilio_number en utilisant le format E.164 :

[+][code pays][numéro de téléphone avec indicatif régional]

Remplacer le numéro « To » (À) dans l'appel create()

La première valeur de l'appel à create() est le numéro de téléphone sortant, actuellement défini sur +15558675310. Il peut s'agir de n'importe quel numéro de téléphone pouvant recevoir des SMS, mais vous devez d'abord utiliser un numéro que vous contrôlez pour voir la magie opérer sous vos yeux ! Comme ci-dessus, utilisez le formatage E.164 pour ce numéro.

Enregistrez le fichier, puis exécutez le script :

php send_sms.php

Boum ! En supposant que toutes les valeurs sont correctes, vous devriez déjà voir le 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.

Recevoir des SMS entrants et y répondre avec PHP

Lorsque quelqu'un envoie un SMS à votre numéro de téléphone Twilio, Twilio envoie une requête POST HTTP à votre serveur pour demander des instructions sur la marche à suivre. Pour ce quickstart, nous répondrons à l'expéditeur par une note sur la façon dont nous envoyons notre réponse par SMS.

Nous utilisons à nouveau la librairie Twilio PHP, puis nous utilisons le serveur Web de développement intégré à PHP associé à ngrok pour expliquer à Twilio comment traiter le message. Créez un nouveau fichier reply_sms.php dans le même répertoire que send_sms.php, ouvrez-le, puis copiez et collez ou saisissez le code suivant.

Enregistrez le fichier, puis démarrez le serveur de développement PHP avec :

php -S localhost:8000

Dans votre navigateur préféré, ouvrez l'URL http://localhost:8000/reply_sms.php.

Si tout s'est bien passé, vous devriez voir TwiML dans votre navigateur avec le message que nous avons choisi pour répondre à tous nos textes entrants. Et non, vous n'avez pas besoin de plus de code. Mais il reste une étape supplémentaire à effectuer avant que tout soit prêt.

Configurer votre URL Webhook

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:8000/reply_sms.php"

La CLI démarre un tunnel ngrok, de sorte que Twilio puisse atteindre votre machine de développement, et attend patiemment les messages texte entrants !

Testez votre application avec un message texte

Maintenant que tout est assemblé, il est temps de tester.

Envoyez un SMS depuis votre téléphone portable vers votre numéro de téléphone Twilio. Vous verrez que deux choses se produisent très rapidement :

1. Votre serveur de développement PHP notera une nouvelle connexion.
2. Twilio transmettra votre réponse sous forme de SMS !

Étapes suivantes

Maintenant que vous connaissez les bases de l'envoi et de la réception de SMS et de MMS avec PHP, vous pouvez consulter ces ressources :

• Notre vaste documentation de référence d'API pour Twilio SMS.
• Découvrez comment créer une conversation SMS dans PHP.
• Suivez l'état de remise de vos messages avec PHP.
• Essayez Twilio Quest, notre jeu interactif à votre rythme qui vous apprend à utiliser Twilio.

Nous espérons que vous avez apprécié le quickstart et nous avons hâte de voir ce que vous allez construire !