You are viewing the French site, but your language preference is set to English. Switch to English site →

Menu

Expand
Évaluez cette page :

Guide de démarrage rapide Programmable Voice pour PHP

Avec seulement quelques lignes de code, votre application Web PHP peut passer et recevoir des appels téléphoniques avec Twilio Programmable Voice.

Ce quickstart de PHP Voice vous apprendra à le faire à l'aide de l'API REST Voice de Twilio, de la librairie d'aide PHP Twilio, du serveur Web de développement PHP intégré et de ngrok pour exposer votre serveur local à Twilio.

Nous allons utiliser le gestionnaire de packages Composer pour la gestion des dépendances (vous ne voulez pas ? Essayez notre quickstart de PHP Voice sans Composer).

Dans ce quickstrat, vous apprendrez à :

  1. Vous inscrire à Twilio et obtenir votre premier numéro de téléphone Twilio compatible avec les appels
  2. Vérifier et installer les conditions préalables PHP à l'aide de Composer
  3. Passer un appel téléphonique sortant et jouer un MP3
  4. Recevoir un appel téléphonique entrant pour lire un message à un appelant et y répondre à l'aide de la synthèse vocale Text to Speech

Vous préférez regarder une vidéo ? Regardez notre vidéo sur la façon de passer et de recevoir des appels téléphoniques avec PHP.

Montrez-moi comment appeler !

Inscrivez-vous à Twilio et obtenez un numéro de téléphone

Vous disposez déjà d'un compte Twilio et d'un numéro de téléphone Twilio compatible avec les appels ? Connectez-vous, puis passez à 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 vous permet également de passer des appels vers votre téléphone depuis votre compte Twilio en mode d'essai.
  • Une fois votre numéro vérifié, vous serez invité à créer un projet. Pour le bon déroulement de ce tutoriel, vous pouvez cliquer sur le modèle "Learn and Explore" (Apprendre et explorer). Donnez un nom à votre projet ou cliquez simplement sur "skip remaining steps" (ignorer les étapes restantes) pour continuer avec la valeur par défaut.
  • Une fois que vous aurez terminé le processus de création de projet, 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é Voix, vous devez en acheter un. Après avoir accédé à la page Buy a Number (Acheter un numéro), cochez la case "Voice" et cliquez sur "Search."

Search for a Phone Number.png

Vous verrez alors une liste des numéros de téléphone disponibles et de leurs capacités. Trouvez le numéro qui vous plaît et cliquez sur "Buy" (Acheter) pour l'ajouter à votre compte.

Buy a Phone Number.png

Aidez-moi à installer la librairie.

Installer PHP et la librairie PHP Twilio

Si PHP et la librairie PHP Twilio sont déjà installés dans votre répertoire de travail, vous êtes prêt pour cette étape. N'hésitez pas à passer à l'étape suivante et à envoyer votre premier message texte.

Pour passer votre premier appel vocal sortant, 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 de vos packages. Ce quickstart s'appuie sur Composer pour installer la librairie PHP. (Si vous choisissez de ne pas utiliser Composer, vous trouverez les instructions d'installation manuelles de PHP Twilio sur la page de la librairie PHP.)

Installer PHP

Si vous utilisez un ordinateur Mac ou *nix, PHP est peut-être déjà installé. Depuis votre terminal, exécutez ce qui suit :

php --version

Si PHP 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.

Bien que de nombreuses versions de PHP 7.x fonctionnent pour ce quickstart, veuillez prêter attention aux versions PHP prises en charge. Lorsque vous faites du développement Web, mettez toujours à jour votre version de PHP vers une version qui reçoit des mises à jour de sécurité.

Installer Composer pour la gestion de packages

Composer est le gestionnaire de packages classique de facto pour le développement Web PHP. Pour ce tutoriel, Composer est requis. Si vous ne souhaitez pas installer Composer, essayez notre quickstart de PHP Voice sans Composer.

Installer la librairie PHP Twilio

Nous devons maintenant installer la librairie PHP Twilio.

Tout d'abord, accédez au répertoire dans lequel vous allez effectuer ce quickstart, puis choisissez l'une des méthodes suivantes pour installer la librairie.

À partir d'un terminal, vous pouvez exécuter la commande suivante :

composer require twilio/sdk

Ou, vous pouvez créer un fichier nommé composer.json à la place. Dans ce fichier, ajoutez :

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

Ensuite, exécutez

composer install

Composer va récupérer la dernière version 5.x de la librairie PHP Twilio.

Pour ne pas utiliser Composer, essayez ce quickstart PHP Voice.

Tout est installé et prêt à être appelé !

Passer un appel téléphonique sortant avec PHP

Maintenant que PHP et la librairie PHP sont installés, nous pouvons passer un appel téléphonique sortant en une seule requête API. Créez un nouveau fichier appelé make_call.php et saisissez ou collez cet exemple de code.

        
        
        
        Passez un appel vocal avec la librairie PHP

        Passer un appel vocal

        Passez un appel vocal avec la librairie PHP

        Lorsque vous exécutez le code, il lance un appel téléphonique entre les deux numéros transmis comme arguments. Nous avons ajouté deux variables pour vous montrer les numéros « From » (De) et « To » (À) et elles seront mappées comme suit :

        • (From) / twilio_number: Le numéro de téléphone Twilio que vous avez acheté
        • (To) / to_number: Le numéro à appeler (peut-être votre téléphone portable ?)

        Dans le tableau, l'argument url pointe vers un TwiML. TwiML est un langage que Twilio utilise en interne pour lancer ou répondre à des actions, telles qu'une séquence d'appel vocal. Ce TwiML spécifique entraîne la lecture d'un message avec la synthèse vocale de Twilio, puis la lecture d'un MP3 sur le numéro « To » / to_number.

        Avant de pouvoir exécuter ce code, vous devez échanger quelques valeurs spécifiques au compte.

        Remplacez les informations d'identification du texte fantôme par les vôtres

        Remplacez les valeurs du texte fantôme account_sid et auth_token par vos informations d'identification de compte Twilio.

        Pour les trouver, rendez-vous sur https://www.twilio.com/console et connectez-vous. Sur cette page, vous trouverez votre Account SID (SID de compte) et Auth Token (jeton d'authentification) uniques. Vous pouvez afficher le jeton d'authentification en cliquant sur l'icône en forme d'œil :

        Reveal Your Auth Token

        Ouvrez make_call.php et remplacez les valeurs de account_sid et auth_token par vos valeurs uniques.

        Remarques : Il est plus facile de coder en dur vos informations d'identification pour ce quickstart, mais vous devez utiliser des variables d'environnement pour les garder secrètes en production. Pour plus d'informations, découvrez comment définir les variables d'environnement et consultez les commentaires de code pour obtenir un exemple de lecture. Ce répertoire est également une excellente référence pour les variables d'environnement dans PHP.

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

        Auparavant, vous avez acheté ou trouvé un numéro de téléphone compatible pour les appels. Collez le 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]

        Par exemple, +18005551212.

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

        En utilisant à nouveau le format E.164, remplacez le numéro de téléphone qui recevra l'appel sortant. Vous devez utiliser un numéro de téléphone personnel ici pour recevoir l'appel et entendre la magie après avoir exécuté le code.

        Si vous utilisez un compte d'essai Twilio, vous pouvez uniquement passer des appels sortants vers les 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 à l'aide des Verified Caller IDs de votre console Twilio. Pour connaître les limites de votre compte d'essai complet, consultez notre guide sur l'utilisation de votre compte d'essai gratuit Twilio.

        Enregistrez le script et invoquez-le pour tester un appel sortant. Pour OSX et *NIX, cela devrait ressembler à :

        php make_call.php

        Si vous avez tout remplacé correctement, vous entendrez bientôt un message formidable et une toute nouvelle chanson ! Si ce n'est pas le cas, n'abandonnez jamais et suivez les instructions de la console.

        Vous ne m'avez pas laissé tomber ! Et ensuite ?

        Recevoir des appels vocaux entrants et y répondre avec PHP

        Lorsque quelqu'un appelle votre numéro de téléphone Twilio, Twilio émet une requête HTTP à votre serveur pour demander des instructions sur la façon de traiter l'appel. Pour ce quickstart, nous répondons à l'expéditeur et le remercions de son appel téléphonique grâce aux fonctions de synthèse vocale Text to Speech de Twilio.

        Encore une fois, nous allons utiliser la librairie PHP Twilio pour cette étape. Nous utiliserons le serveur Web de développement intégré à PHP en combinaison avec ngrok pour indiquer à Twilio comment gérer l'appel.

        Créez un nouveau fichier, answer_call.php, dans le même répertoire que make_call.php. Puis, copiez et collez ou saisissez le code suivant.

        (Remarque : si vous n' utilisez pas le même répertoire que lors de notre premier appel, veuillez suivre l'étape d'installation de la librairie PHP ci-dessus)

              
              
              
              Recevez un appel vocal et répondez-y avec la librairie PHP

              Recevoir un appel vocal entrant

              Recevez un appel vocal et répondez-y avec la librairie PHP

              Enregistrez answer_call.php, puis démarrez un serveur de développement PHP local avec :

              php -S localhost:8000

              Dans un onglet de navigateur, ouvrez l'URL http://localhost:8000/answer_call.php.

              Si tout s'est bien passé, vous devriez maintenant voir XML dans votre navigateur avec le message que vous aimeriez lire aux appels entrants. C'est tout le code dont vous avez besoin. Il ne reste que quelques étapes avant que tout soit prêt.

              Maintenant, exposons cet endpoint à Twilio.

              C'est très simple. Comment Twilio communique avec ma nouvelle application ?

              Autorisez Twilio à communiquer avec votre application PHP

              Avant de pouvoir donner des instructions à Twilio sur la marche à suivre en réponse à un appel entrant, vous devez d'abord exposer votre serveur au public. Lorsque vous exécutez votre serveur de développement local, il est très probable qu'il ne soit accessible qu'à partir de votre réseau local. Mais ne vous inquiétez pas, nous vous montrerons un moyen simple de tester votre serveur.

              De nombreux produits et services Twilio utilisent des webhooks pour communiquer avec votre application. Par exemple, lorsque Twilio reçoit un appel entrant, il contacte une URL spécifique que vous fournissez pour rechercher des instructions sur la façon de traiter la réponse. La partie du code dans answer_call.php est un exemple d'instruction que vous pouvez utiliser pour « répondre » à l'appelant. Cependant, lorsque vous exécutez le serveur, il ne sera exposé qu'à vous localement, et non au grand public. Nous devons trouver un moyen de résoudre ce problème.

              Bien qu'il existe de nombreuses façons de rendre ce code public (par exemple en le déployant sur un hôte), nous recommandons un outil appelé ngrok. Lorsque vous démarrez ngrok, il fournit une URL unique sur le domaine ngrok.io et transfère les demandes entrantes vers votre environnement de développement local.

              L'architecture se présente comme suit :

              How ngrok helps Twilio reach your local server

              Si vous n'utilisez pas déjà ngrok, rendez-vous sur la page de téléchargement et installez l'outil pour votre système d'exploitation.

              Si vous travaillez sous Mac ou Linux, vous êtes prêt après la décompression. Si vous utilisez Windows, suivez notre guide pour installer et configurer ngrok sous Windows. Pour plus d'informations sur ngrok (y compris quelques conseils et astuces), consultez notre post de blog consacré à ngrok.

              Une fois que vous avez téléchargé un programme d'installation ngrok, ouvrez un nouvel onglet ou une nouvelle fenêtre de terminal (en laissant votre serveur de développement en cours d'exécution) et démarrez-le à l'aide de la commande suivante :

              ./ngrok http 8000

              Vous devriez voir quelque chose qui ressemble à ceci :

              Ngrok server terminal output

              Copiez l'URL publique à partir de ce résultat, collez-la dans votre navigateur et modifiez answer_call.php. Vous devriez voir le même fichier XML que celui que vous avez vu précédemment, mais vous pouvez désormais y accéder depuis n'importe quel endroit où vous avez accès à Internet.

              Maintenant que vous êtes public, indiquons à Twilio où trouver le serveur.

              Mon serveur est public. Apprenez-moi à recevoir des appels téléphoniques !

              Configurer votre URL Webhook

              Maintenant que votre serveur est accessible au public, vous devez configurer votre numéro de téléphone Twilio pour accéder à l'URL de votre webhook lorsque de nouveaux appels arrivent.

              1. Consultez la page des numéros de la console.
              2. Cliquez sur votre numéro de téléphone compatible avec les appels.
              3. Recherchez la section « Voice & Fax ». Assurez-vous que l'option « Accept Incoming » (Accepter les appels entrants) est définie sur « Voice Calls » (Appels vocaux). La sélection « Configure With » (Configurer avec) par défaut correspond à ce dont vous aurez besoin : "Webhooks/TwiML...".
              4. Dans la section « A Call Comes In » (Un appel arrive), sélectionnez « Webhook » et collez l'URL que vous souhaitez utiliser, en ajoutant /answer_call.php :

              Voice call webhook with ngrok

              Enregistrez vos modifications et c'est parti !

              Tester votre application

              Si votre serveur de développement local et ngrok sont toujours en cours d'exécution, vous êtes prêt pour la partie amusante : les tests !

              Appelez votre numéro de téléphone Twilio. Vous verrez et entendrez un certain nombre de choses se produire rapidement :

              1. Une requête HTTP s'affiche dans la console ngrok
              2. Le serveur de développement affiche certains messages sur la console
              3. Vous entendrez le message une fois l'appel connecté

              Et voilà, vous pouvez passer des appels sortants et entrants avec PHP.

              Ça a fonctionné ! Et ensuite ?

              L'étape suivante ?

              Vous connaissez maintenant les bases pour passer des appels téléphoniques et y répondre avec PHP.

              Cette application PHP n'a utilisé que le verbe TwiML <Say> pour lire un message à l'appelant en utilisant la fonction de synthèse vocale. Avec différents verbes TwiML, vous pouvez créer d'autres constructions et flux d'appels puissants. Essayez-en quelques-uns, comme <Record>, <Gather> et <Conference>.

              Consultez ces pages pour en savoir plus :

              Nous avons hâte de voir ce que vous allez construire !

              Évaluez cette page :

              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.

                    
                    
                    

                    Merci pour vos commentaires!

                    Veuillez sélectionner la ou les raisons de vos commentaires. Les informations supplémentaires que vous fournissez nous aident à améliorer notre documentation:

                    Envoi de vos commentaires...
                    🎉 Merci pour vos commentaires!
                    Une erreur s'est produite. Veuillez réessayer.

                    Merci pour vos commentaires !

                    Recommandez‑nous et gagnez 10 € en 3 étapes simples!

                    Étape 1

                    Obtenir le lien

                    Obtenez un lien de recommandation personnel gratuit ici

                    Étape 2

                    Donner 10 €

                    Votre utilisateur s'inscrit et effectue la mise à niveau en utilisant le lien

                    Étape 3

                    Gagner 10 €

                    1 250 SMS gratuits
                    OU 1 000 minutes vocales gratuites
                    OU 12 000 chats
                    OU plus