Registrieren einer Twilio-Telefonnummer und Senden einer SMS mit der Twilio-CLI

May 14, 2021
Autor:in:
Maciej Treder
Mitwirkende:r
Die von Twilio-Mitwirkenden geäußerten Meinungen sind ihre eigenen
Prüfer:in:

Es gibt über 4,5 Milliarden Geräte, die Textnachrichten senden können. Darin steckt ein enormes Potenzial, wenn Sie andere per SMS über anstehende Termine, besondere Ereignisse, Neuigkeiten oder Werbeaktionen informieren möchten. Durch das programmierte Senden von SMS-Nachrichten können Sie viele Menschen nahezu zeitgleich erreichen. Mit Twilio Programmable SMS können Sie Ihre eigene virtuelle Telefonnummer registrieren und SMS-Nachrichten in die gesamte Welt senden.

In diesem Tutorial erfahren Sie, wie Sie die Twilio-CLI einrichten, eine Telefonnummer registrieren und über die neue Nummer eine SMS senden.

Wichtiger Hinweis zur Einhaltung von Gesetzen und Vorschriften: Die Gesetze, denen das Senden von SMS-Nachrichten unterliegt, sind je nach Land verschieden. Sie sind dafür verantwortlich, sich mit den Vorschriften des Landes vertraut zu machen, in dem Sie Nachrichten senden möchten. Hierfür steht Ihnen das Rahmenwerk für SMS-Richtlinien von Twilio zur Verfügung.

Voraussetzungen

Für das in diesem Tutorial beschriebene Projekt benötigen Sie die folgenden Tools und Ressourcen:

  • Twilio-Konto: Melden Sie sich über diesen Link kostenlos an. Wenn Sie sich für ein Upgrade auf ein normales Konto entscheiden, erhalten Sie zusätzlich eine Gutschrift in Höhe von 10 USD.
  • Twilio-CLI: Die Twilio-Kommandozeile (CLI) erfordert Node.js und npm, das mit Node.js installiert wird.

Twilio-Telefonnummer erhalten

SMS-Nachrichten von Twilio werden mit Twilio-Telefonnummern gesendet. Diese bieten sofortigen Zugriff auf lokale, nationale, mobile und gebührenfreie Telefonnummern in mehr als 100 Ländern mit einer entwicklerfreundlichen API. Im Rahmen Ihres Testkontos erhalten Sie eine kostenlose Twilio-Telefonnummer.

Sobald Sie ein Twilio-Konto erstellt haben, können Sie über die Twilio-CLI eine Telefonnummer anfordern.

Hinweis: Wenn Sie die CLI bereits installiert haben, überprüfen Sie mit folgendem Befehl, ob Sie über die neueste Version verfügen:

npm install -g twilio-cli

Wenn Sie Ihre Twilio-Anmeldeinformationen als Umgebungsvariablen gespeichert haben, verwendet die Twilio-CLI diese automatisch. Andernfalls müssen Sie sich mit dem folgenden Befehl anmelden:

twilio login

Dieser Befehl fordert Sie dazu auf, Ihre Konto-SID und Ihr Authentifizierungstoken einzugeben. Beides finden Sie in der Twilio-Konsole.

Mit folgendem Befehl können Sie die Telefonnummern aufrufen, die für die Registrierung genutzt werden können. Ersetzen Sie für Deutschland ggf. den entsprechenden ISO 3166-Ländercode:

twilio api:core:available-phone-numbers:local:list --country-code US

Die angezeigte Ausgabe sollte ungefähr wie folgt aussehen:

Phone Number  Region  ISO Country  Address Requirements
+13852101305  UT      US           none                
+14077922414  FL      US           none                
+16033712156  NH      US           none                
+16036367116  NH      US           none                
+18312751816  CA      US           none                
+14693316717  TX      US           none                
+18312751822  CA      US           none    

Kopieren Sie eine der Nummern aus der Liste und registrieren Sie sie mithilfe folgender Informationen in Ihrem Twilio-Konto:

twilio api:core:incoming-phone-numbers:create --phone-number="+13852101305"

Wenn die Registrierung erfolgreich war, sehen Sie Folgendes:

SID                                 Phone Number  Friendly Name 
PN3ef900000000000000000000000000d9  +13852101305  (385) 210-1305

Sobald die Telefonnummer registriert ist, können Sie sie nutzen (bis Sie sie über die CLI oder Twilio-Konsole freigeben). Beachten Sie, dass die Ihrer Telefonnummer zugeordnete SID ein Nutzergeheimnis darstellt und daher vertrauensvoll behandelt werden muss.

Über die Twilio-CLI können Sie eine Testnachricht senden, um zu überprüfen, ob die Nummer Ihrem Konto erfolgreich hinzugefügt wurde. Führen Sie den folgenden Befehl aus. Ersetzen Sie die Platzhalterwerte durch Ihre Twilio-Telefonnummer und Ihre private SMS-fähige Nummer im E.164-Format:

twilio api:core:messages:create --from <your-twilio-phone-number> --to <SMS-receiver-phone-number> --body "Hello world"

Hinweis: Mit einem Testkonto können Sie Nachrichten nur an Telefonnummern senden, die Sie zuvor in Ihrem Konto registriert haben. Die SMS-fähige Telefonnummer, mit der Sie Ihr Twilio-Konto eingerichtet haben, ist die erste Nummer, die Sie registriert haben.

Die Antwort der API ähnelt der folgenden Ausgabe. Dadurch erfahren Sie, dass die SMS-Nachricht erfolgreich empfangen wurde und sich in der Warteschlange zum Senden befindet:

SID                                 From          To            Status  Direction     Date Sent
SM4a447328e80a43ceb8e61dda9f3d4cb6  +13852101305  +16463974810  queued  outbound-api  null  

Innerhalb kurzer Zeit sollte auf Ihrem Telefon eine SMS-Nachricht eingehen:

Sperrbildschirm eines Mobiltelefons mit SMS-Nachricht

Mit dem folgenden CLI-Befehl können Sie den Status der Anfrage zum Erstellen der Nachricht überprüfen:

twilio api:core:messages:fetch --sid SM4a447328e80a43ceb8e61dda9f3d4cb6

Sie sehen eine Antwort wie die folgende:

SID                                 From          To            Status     Direction     Date Sent                    
SM4a447328e80a43ceb8e61dda9f3d4cb6  +13852101305  +16463974810  delivered  outbound-api  Mar 13 2020 14:17:20 GMT+0100

Wenn Ihre Nachricht nicht übermittelt wurde, helfen Ihnen die Statusprotokolle in der Twilio-Konsole dabei, das Problem zu ermitteln. Achten Sie bei der Nutzung eines Twilio-Testkontos darauf, dass Sie die Nachricht an eine registrierte Telefonnummer senden.

Zusammenfassung

In diesem Beitrag haben Sie erfahren, wie Sie die Twilio-CLI installieren und einrichten und eine Twilio-Telefonnummer erhalten. Diese Nummer ist für die Arbeit mit einigen Twilio-Produkten wie Programmable SMS erforderlich. Außerdem wissen Sie nun, wie Sie mit der Twilio-CLI eine SMS an eine beliebige SMS-fähige Nummer irgendwo auf der Welt senden.

Zusätzliche Ressourcen

Maciej Treder ist Senior Software Development Engineer bei Akamai Technologies. Er ist auch internationaler Vortragsredner und Autor von @ng-toolkit. Weitere Informationen zu ihm finden Sie unter https://www.maciejtreder.com. Sie erreichen ihn auch unter contact@maciejtreder.com oder @maciejtreder auf GitHub, X (ehemals Twitter), StackOverflow und LinkedIn.

Gabriela Rogowska hat an diesem Beitrag mitgewirkt.