Twilio CLI Quickstart

BETA

Dieses Twilio-Produkt ist derzeit als Beta-Version erhältlich. Einige Funktionen sind noch nicht implementiert und andere können geändert werden, bevor das Produkt für allgemein verfügbar erklärt wird. Beta-Produkte sind nicht von einem Twilio SLA abgedeckt. Erfahren Sie mehr über den Support für Beta-Produkte.

Mit der Twilio CLI (Command Line Interface; Befehlszeile) können Sie Ihre Twilio Ressourcen über Ihr Terminal oder die Eingabeaufforderung verwalten. Beschäftigen wir uns nun mit der Installation und einem kurzen Überblick. Befolgen Sie die Installationsanweisungen für die jeweilige Plattform (siehe unten).

Installation von Twilio CLI

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

Melden Sie sich bei Ihrem Twilio-Konto an

Um auf Ihr Twilio-Konto zugreifen zu können, müssen Sie Ihre Twilio-Anmeldeinformationen an die CLI übermitteln. Führen Sie dazu den folgenden Befehl aus:

twilio login

Sie werden aufgefordert, Ihre Konto-SID und Ihr Auth-Token einzugeben, die beide auf dem Dashboard Ihrer Twilio-Konsole zu finden sind. Dadurch wird ein API-Schlüssel für Sie erstellt, der für die künftige Verwendung sicher gespeichert wird. Weitere Informationen zur Verwendung mehrerer Profile finden Sie unter Allgemeine Nutzung.

Installation von CLI autocomplete (nur bash oder zsh)

Wenn Sie bash oder zsh unter macOS oder Linux einsetzen, können Sie einen der beiden folgenden Befehle ausführen (je nachdem, welche Shell Sie verwenden):

twilio autocomplete bash

oder

twilio autocomplete zsh

Folgen Sie den Anweisungen, um die automatische Befehlsvervollständigung für die CLI in Ihrer Shell zu installieren.

Achten Sie darauf, die neue Shell neu zu starten oder zu öffnen, nachdem Sie den Schritt zur Installation der automatischen Befehlsvervollständigung autocomplete abgeschlossen haben.

Twilio CLI kennenlernen

Der beste Weg, um zu erfahren, was Sie mit der CLI alles machen können, besteht darin, den folgenden Befehl einfach auszuführen:

twilio

Daraufhin erhalten Sie eine Liste mit den verschiedenen Themen und Befehlen, die Sie ausführen können. Themen sind einfach Gruppierungen für weitere Themen und Befehle, ähnlich wie die Ordnerstruktur in Ihrem Dateisystem.

> twilio
Nutzen Sie die Leistungsfähigkeit von Twilio von der Eingabeaufforderung aus

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

USAGE
  $ twilio [COMMAND]

COMMANDS
  api            erweiterter Zugriff auf alle Twilio-APIs
  autocomplete   zeigt die Installationsanweisungen für autocomplete an
  feedback       für Feedback an das CLI-Team
  help           zeigt Hilfe für Twilio an
  login          Anmeldeinformationen für ein bestehendes Twilio-Profil hinzufügen
  phone-numbers  Twilio-Telefonnummern verwalten
  plugins        Liste der installierten Plugins
  profiles       Anmeldeinformationen für das Twilio-Profil verwalten

Sehen Sie etwas, das Sie interessiert? Probieren Sie es einfach aus:

twilio api

Da „api“ ein Thema ist, werden Ihnen tatsächlich weitere Themen und Befehle angezeigt, die in diesem Thema enthalten sind. Nehmen wir an, Sie sind bei Ihrer Recherche über diesen Befehl gestolpert:

twilio api:core:messages:list

Wenn Sie diesen Befehl ausführen, werden alle Ihre SMS-Nachrichten aufgelistet. Das können viele sein. Wie können Sie sie filtern? Oder, ganz allgemein, wie können Sie herausfinden, welche Optionen ein bestimmter CLI-Befehl unterstützt? Die Antwort ist: Fügen Sie „--help“ so an den Befehl an:

twilio api:core:messages:list --help

Wenn Sie einen Befehl eingeben, erhalten Sie möglicherweise eine Fehlermeldung, wenn Sie nicht alle erforderlichen Optionen angegeben haben. Das ist eine andere Situation, in der das Hinzufügen von „--help“ zum Befehl Ihnen weitere Informationen liefern kann.

Beispiele

Liste Ihrer Telefonnummern

twilio phone-numbers:list

Eine Textnachricht senden

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

Weitere Beispiele

Bitte besuchen Sie unsere Beispielseite auf der Sie eine Galerie mit weiteren Beispielen finden.

Wie geht es weiter?

Jetzt, wo Sie die CLI kennengelernt haben, fragen Sie sich, wie es weitergehen soll?

Plugins kennenlernen

Die Twilio CLI kann über Plugins erweitert werden. Sie können Ihre eigenen Plugins für die Community veröffentlichen oder sie für Ihre eigenen geschäftlichen Workflows (oder die Ihrer Kundschaft) als privat festlegen. Es gibt bereits eine Reihe von Plug-ins, mit denen Sie die CLI erweitern können.

Allgemeine Anleitung

Wenn Sie die Twilio CLI unter Windows verwenden, prüfen Sie unsere Windows-spezifischen Wissensartikel über die allgemeine Verwendung und Tipps zur Fehlerbehebung:

Kann ich das TLS-Zertifikat meines Unternehmens für API-Anfragen über die Twilio CLI verwenden?

Weitere Informationen zu verschiedenen CLI-Funktionen finden Sie in der Allgemeinen Anleitung:

Weitere Beispiele

Wir haben eine ganze Seite voller Beispiele für die verschiedenen Aufgaben, die Sie mit der Twilio CLI erledigen können.

Senden Sie uns Feedback

Schließlich würden wir gerne von Ihnen hören. Wann immer Sie uns etwas mitteilen möchten, rufen Sie den folgenden Befehl auf:

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.

Need some help?

Thank you for your feedback!

Thanks for your feedback!

Step 1

Step 2

Step 3