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

Menu

Expand
Rate this page:

Guide de démarrage rapide de l'interface de ligne de commande Twilio

BÊTA

Ce produit Twilio est actuellement disponible en version bêta. Certaines fonctionnalités ne sont pas encore mises en œuvre et d'autres peuvent être modifiées avant que le produit ne soit déclaré comme étant généralement disponible. Les produits bêta ne sont pas couverts par un SLA Twilio. En savoir plus sur l'assistance pour les produits bêta.

L'interface de ligne de commande Twilio vous permet de gérer vos ressources Twilio à partir de votre terminal ou de votre invite de commande. Installons-la et effectuons une visite rapide. Suivez les instructions d'installation pour votre plateforme spécifique ci-dessous.

Installer la CLI Twilio

One of the easiest ways to install the CLI on macOS is to use Homebrew. If you don't already have it installed, visit the Homebrew site for installation instructions and then return here.

Once Homebrew is installed, simply run the following command to install the CLI:

brew tap twilio/brew && brew install twilio

Updating

If you already installed the CLI with brew and want to upgrade to the latest version, run:

brew upgrade twilio

Warning for Node.js developers

If you have installed Node.js version 10.12 or higher on your Mac, you can avoid potential Node.js version conflicts by installing the CLI using npm:

npm install twilio-cli -g

Before You Begin

Before we can install, we need to make sure you have Node.js installed (version 12.21 or above). To see if you have node installed, try running this command:

node -v

If your system reports v12.21 or above, you can skip the next step.

Installing Node.js on Windows

Using the Windows Installer (.msi) is the recommended way to install Node.js on Windows. You can download the installer from the Node.js download page.

Run PowerShell as an administrator, and type the following command:

Set-ExecutionPolicy Bypass -Scope Process

You should see the following output:

Execution Policy Change
The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose
you to the security risks described in the about_Execution_Policies help topic at
https:/go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"):

Enter Y to confirm the change.

Note you will have to set this execution policy every time you run PowerShell. See notes on Set-ExecutionPolicy to learn more.

Tested Windows Versions

These instructions have been tested on the following Windows versions:

  • Windows 10 Pro
  • Windows Server 2016

Installing Twilio CLI

The CLI is installed with npm (Node Package Manager), which comes with Node.js. To install the CLI run the following command:

npm install twilio-cli -g

Note the -g option is what installs the command globally so you can run it from anywhere in your system.

Updating

If you already installed the CLI with npm and want to upgrade to the latest version, run:

npm install twilio-cli@latest -g

Before we can install, we need to make sure you have Node.js installed (version 10.12 or above). Even if you already installed Node yourself, the CLI works best when you install it using nvm. Here's how to get nvm installed on most Linux systems:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash

Please visit the nvm installation instructions for additional options and troubleshooting steps. Once you have nvm installed, run the following to install and use the most recent LTS release of Node.js:

nvm install --lts
nvm use <insert version reported from above>

Installing other Twilio CLI prerequisites for Linux

Depending on your distribution, you will need to run one of the following commands:

  • Debian/Ubuntu: sudo apt-get install libsecret-1-dev
  • Red Hat-based: sudo yum install libsecret-devel
  • Arch Linux: sudo pacman -S libsecret

Installing Twilio CLI

The CLI is installed with npm (Node Package Manager), which comes with Node.js. To install the CLI run the following command:

npm install twilio-cli -g

Note the -g option is what installs the command globally so you can run it from anywhere in your system.

Updating

If you already installed the CLI with npm and want to upgrade to the latest version, run:

npm install twilio-cli@latest -g

Se connecter à votre compte Twilio

Pour accéder à votre compte Twilio, vous devez fournir vos informations d'identification Twilio à la CLI. Pour ce faire, exécutez la commande suivante :

twilio login

Vous serez alors invité à saisir votre SID de compte (Account SID) et votre jeton d'autorisation (Auth Token), tous deux disponibles sur le tableau de bord de la‌console Twilio. Cela créera pour vous une clé API qui sera stockée de manière sécurisée pour une utilisation ultérieure. Consultez la section Utilisation générale pour en savoir plus sur l'utilisation de plusieurs profils.

Installer la saisie semi-automatique de la CLI (bash ou zsh uniquement)

Si vous exécutez bash ou zsh sur MacOS ou Linux, vous pouvez exécuter l'une des deux commandes ci-dessous (selon le shell que vous utilisez) :

twilio autocomplete bash

ou

twilio autocomplete zsh

Suivez les instructions fournies pour installer la commande de saisie semi-automatique de la CLI dans votre shell.

Assurez-vous de redémarrer ou d'ouvrir un nouveau shell après avoir terminé l'étape d'installation de la saisie semi-automatique.

Explorer la CLI Twilio

La meilleure façon d'en savoir plus sur ce que vous pouvez faire avec l'interface de ligne de commande est d'exécuter simplement la commande :

twilio

Dans ce cas, vous obtiendrez une liste des différentes rubriques et commandes que vous pouvez exécuter. Les rubriques ne sont que des regroupements pour d'autres rubriques et commandes, tout comme la structure de dossiers de votre système de fichiers.

> twilio
déployez la puissance de Twilio depuis votre invite de commande

VERSION
  twilio-cli/1.3.6 darwin-x64 node-v10.16.0

USAGE
  $ twilio [COMMAND]

COMMANDS
  api            accès avancé à toutes les API Twilio
  autocomplete   affiche les instructions d'installation de la saisie semi-automatique
  feedback       fournit un retour à l'équipe CLI
  help           affiche l'aide pour twilio
  login          ajouter des informations d'identification pour un profil Twilio existant
  phone-numbers  gérer les numéros de téléphone Twilio
  plugins        répertorier les modules complémentaires installés
  profiles       gérer les informations d'identification pour le profil Twilio

Vous voyez quelque chose d'intéressant ? Essayez de l'exécuter :

twilio api

Étant donné que « api » est une rubrique, vous verrez davantage de rubriques et de commandes contenues dans cette rubrique. Supposons qu'au cours du processus d'exploration, vous rencontrez cette commande :

twilio api:core:messages:list

Si vous exécutez cette commande, elle répertorie tous vos messages SMS, ce qui peut être volumineux. Comment les filtrer ? Ou, plus généralement, comment découvrir les options fournies par une commande CLI donnée ? La réponse est d'ajouter « --help » à la commande comme suit :

twilio api:core:messages:list --help

Si vous saisissez une commande, vous risquez d'obtenir une erreur si vous n'avez pas fourni toutes les options requises. Il s'agit d'une autre situation dans laquelle l'ajout de « --help » peut vous donner plus d'informations.

Exemples

Répertorier vos numéros de téléphone

twilio phone-numbers:list

Envoyer un message texte

twilio api:core:messages:create \
  --from "+15017122661" \
  --to "+15558675310" \
  --body "I love you 3000"

Plus d'exemples

Consultez notre page exemples pour découvrir une galerie d'exemples supplémentaires.

Et ensuite ?

Maintenant que vous connaissez la CLI, que pourriez-vous faire à partir de là ?

Explorer les modules complémentaires

L'interface de ligne de commande Twilio peut être étendue via des modules complémentaires. Vous pouvez publier vos propres workflows pour la communauté ou les rendre privés pour vos propres workflows métier (ou ceux de vos clients). Un certain nombre de modules complémentaires sont déjà disponibles pour étendre votre CLI.

Guide d'utilisation générale

Plus d'exemples

Nous disposons d'une page entière d'exemples des différentes opérations que vous pouvez effectuer avec l'interface de ligne de commande Twilio.

Envoyez-nous vos commentaires

Nous serions heureux d'avoir votre retour. Chaque fois que vous avez des commentaires que vous aimeriez nous envoyer, exécutez simplement :

twilio feedback
Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Community Forums or browsing the Twilio tag on Stack Overflow.

        
        
        

        Thank you for your feedback!

        We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

        Sending your feedback...
        🎉 Thank you for your feedback!
        Something went wrong. Please try again.

        Thanks for your feedback!

        Refer us and get $10 in 3 simple steps!

        Step 1

        Get link

        Get a free personal referral link here

        Step 2

        Give $10

        Your user signs up and upgrade using link

        Step 3

        Get $10

        1,250 free SMSes
        OR 1,000 free voice mins
        OR 12,000 chats
        OR more