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

June 12, 2023
Autor:in:

Hallo und danke fürs Lesen! Dieser Blogpost ist eine Übersetzung von How to Register a Twilio Phone Number and Send an SMS Using the Twilio CLI.

Es gibt über 4,5 Milliarden Geräte, die Textnachrichten versenden 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 Versenden 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 versenden.

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

Wichtiger Hinweis zur Einhaltung von Gesetzen und Vorschriften: Die Gesetze, denen das Versenden 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 versenden 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..
  • 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 versendet. 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.

Finde Account Zugangsdaten

Mit folgendem Befehl können Sie die mobilen 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:mobile:list --country-code DE

Die angezeigte Ausgabe sollte ungefähr wie folgt aussehen:

Phone Number    Region  ISO Country  Address Requirements
+4915735995000  null    DE           local               
+4915735983000  null    DE           local               
+4915735989000  null    DE           local               
+4915735980000  null    DE           local               
+4915735987000  null    DE           local               
+4915735995000  null    DE           local  

Bitte beachten Sie, dass in Deutschland und vielen anderen Ländern ein Regulatory Bundle benötigt wird, um eine Telefonnummer zu erwerben. Lesen Sie diesen Artikel, um mehr darüber zu erfahren: Wie kaufe ich eine Twilio-Rufnummer mit Regulatory Bundles.

Nutzen Sie die folgenden Befehle, um Ihre zuvor angelegten Bundle-SID bzw. ihr Address-SID zu finden:

twilio api:numbers:v2:regulatory-compliance:bundles:list 
twilio api:core:addresses:list

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 \n
--address-sid="<ADDRESS_SID_EINFUEGEN>" \n
--bundle-sid="<BUNDLE_SID_EINFUEGEN>" \n
--phone-number="+4915735980000"

Wenn die Registrierung erfolgreich war, sehen Sie Folgendes:

SID                                 Phone Number    Friendly Name
PN5c0f201f9528c51d83618509eaaaaaa  +4915735980000  4915735980000

Sobald die Telefonnummer registriert ist, können Sie sie nutzen. 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 Versenden befindet:

SID                                 From            To              Status  Direction     Date Sent
SM0ae7837048fae5cb0c107a4f3aaaaaaa  +4915735980000  +4915112341234  queued  outbound-api  null   

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

Incoming message

 

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

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

Sie sehen eine Antwort wie die folgende:

SID                                 From          To            Status     Direction     Date Sent
SM0ae7837048fae5cb0c107a4f3aaaaaaa  +4915735980000  +4915112341234  delivered  outbound-api  Jun 12 2023
 18:60:00 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.

Falls Sie Ihre Nummer nicht mehr benötigen, können Sie sie mit diesem Befehl löschen:

twilio api:core:incoming-phone-numbers:remove \
    --sid PN5c0f201f9528c51d83618509eaaaaaa

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.