Alles, was Sie über Unterkonten bei Twilio wissen müssen
Lesezeit: 5 Minuten
In diesem Beitrag erfahren Sie, welche Vorteile Unterkonten bieten und wie Sie Nachrichten über diese senden können. Mit Unterkonten können Sie Ihre Nutzung, Ihre Nummern und Ihre Einstellungen voneinander trennen, indem Sie ein Guthaben mit Ihrem Hauptkonto teilen. Auf diese Weise können Sie Ihre Nutzung von Twilio ganz praktisch segmentieren.
In diesem Beitrag geht es um folgende wichtige Punkte:
- Technische Voraussetzungen
- Was sind Unterkonten bei Twilio und warum sollten Sie sie verwenden?
- Über Unterkonten eine Nachricht senden
Technische Voraussetzungen
- Ein kostenloses Twilio-Konto: Melden Sie sich hier über diesen Link an. Wenn Sie ein Upgrade durchführen, erhalten Sie zusätzlich eine Gutschrift in Höhe von 10 USD.
- Eine Twilio-Telefonnummer.
- Eine verifizierte Handynummer (für den Empfang von SMS-Nachrichten).
- Kenntnis vom Senden von REST API-Anfragen. Hier finden Sie hilfreiche Tipps zum Ausführen von cURL über bash oder zsh. Sie können auch ein Tool wie Postman verwenden.
Was sind Unterkonten bei Twilio und warum sollten Sie sie verwenden?
Unterkonten sind Container, die Ressourcen eines Twilio-Projekts (übergeordnet) trennen. Nehmen wir zum Beispiel das fiktive Unternehmen Owlie Notifications. Owlie Notifications bietet eine SaaS-Plattform über die Kund:innen Anrufe tätigen können. Owlie Notifications hat etwa 50 Kund:innen.
Owlie Notifications bietet zwei Optionen bei der Erstellung einer Twilio-Kontostruktur:
- Sie erstellen ein Twilio-Konto, das mit einer eindeutigen Kennung, der Konto-SID, verknüpft ist, der immer der Zusatz „AC“ vorangestellt ist. Immer, wenn Owlie Notifications eine API-Anfrage stellt, wird die Konto-SID für dieses Konto darin verwendet. Die Konto-SID lautet zum Beispiel AC123.
- Sie erstellen ein Twilio-Konto (Konto-SID = AC123, übergeordnetes Konto) wie bei Option 1 und ein Unterkonto für jeden ihrer 50 Kund:innen (50 Unterkonten). Jedes der 50 Unterkonten erhält seine eigene eindeutige Konto-SID. Wenn Owlie Notifications also eine API-Anfrage für eine Kundin oder einen Kunden stellt, wird die entsprechende Konto-SID des Unterkontos und nicht die Konto-SID des übergeordneten Kontos verwendet.
Im Folgenden erklären wir, warum die zweite Option die bessere Wahl ist.
Hauptvorteile von Unterkonten
Segmentierung des Abrechnungsprozesses
Wenn Owlie Notifications sich gegen Unterkonten entscheiden würde, müssten das Unternehmen die gesamte Nutzung für jede einzelne Person im Überblick behalten. Das bedeutet zusätzliche Arbeit und birgt ein hohes Fehlerpotenzial. Da Unterkonten als Container fungieren, können Sie mit der Nutzungs-API von Twilio bestimmte Abrechnungsdaten für ein Unterkonto abrufen. Auf diese Weise ist weniger Geschäftslogik für die Nachverfolgung einzelner Personen erforderlich.
Bereitstellung von Ressourcen
Über Unterkonten können Ressourcen (z. B. Telefonnummern) zu dem jeweiligen Unterkonto hinzugefügt werden. Dabei ist zu beachten, dass die meisten Ressourcen jeweils nur zu einem Unterkonto gehören können. Dies kann schwierig sein, wenn Sie ständig Zahlen zwischen Konten verschieben. Diese Logik kommt beispielsweise zum Tragen, wenn Sie ein Unterkonto schließen, aber die Telefonnummer beibehalten wollen. Bei Twilio können Sie zum Glück Telefonnummern zwischen Konten verschieben.
Bietet Ihnen zusätzliche Kontrolle über mehrere Konten desselben Projekts: Je nach den Bedürfnissen Ihrer Kundschaft können Sie Unterkonten vorübergehend deaktivieren, schließen und wieder aktivieren.
Überlegungen vor der Umstellung auf Unterkonten
Twilio hilft Kund:innen, die über unsere Plattform Nachrichten versenden, bei der Verwaltung von Opt-outs, wenn Endnutzer:innen zum Beispiel „STOPP“ auf eine Nachricht antworten. Twilio verwaltet diese Opt-out-Liste auf Kontoebene.
Antworten Endnutzer:innen „STOPP“ auf eine Telefonnummer, die dann von einem Projekt zu einem Unterkonto mit eindeutiger Konto-SID verschoben wird, kann das Opt-out nicht mehr zugeordnet werden. Wenn Sie sich bisher keinen Überblick über Ihre Opt-outs verschafft haben, fangen Sie jetzt damit an. Nur so können Sie gewährleisten, dass Ihre Abonnenten-Liste aktuell ist.
Über Unterkonten eine Nachricht senden
Sie fragen sich vielleicht: „Was ist, wenn ich noch keine Unterkonten verwende? Wie schwer ist die Umstellung?“
Stellen Sie sich vor, dass Owlie Notifications ein einziges Konto für alle 50 Kund:innen verwendet hat. Einige von ihnen wollen jetzt SMS-Nachrichten senden. Im Folgenden wird erklärt, wie Owlie Notifications jetzt wahrscheinlich vorgehen wird:
Über die REST API für Unterkonten ist eine programmgesteuerte Vorgehensweise möglich. Bei Bedarf können Sie auch die serverseitigen Hilfsbibliotheken verwenden.
Melden Sie sich zunächst bei Ihrer Twilio-Konsole an. Im Dashboard werden Ihre Konto-SID und das Authentifizierungstoken angezeigt, die Ihrem Konto zugewiesen sind:
![Konto-SID und Authentifizierungstoken in der Konsole](/content/dam/twilio-com/global/en/blog/legacy/2021/guide-twilio-subaccounts/7Zj884HG8tArB4LvWmF6E8zNhXBRjwKa_mSvg4wD-LCp1bjUAbrYM77xXXL1011YfiID88vvzkiSZI.png)
In den folgenden Beispielen verwenden Sie die Konto-SID und das Authentifizierungstoken für das Twilio-Konto, das Sie gerade erstellt oder kopiert haben. Denken Sie daran, die Platzhalter unten zu ersetzen.
Ein Unterkonto erstellen
Lassen Sie uns mit den Kund:innen von Owlie Notifications (Falcon Flights) fortfahren und ein Unterkonto für sie anlegen.
Anfrage
Führen Sie in Ihrem Terminal oder in der Eingabeaufforderung den folgenden Befehl aus, um die Anfrage zu stellen. Ersetzen Sie die Platzhalterwerte durch die Konto-SID und das Authentifizierungstoken Ihres übergeordneten Kontos.
Antwort
Nach der Ausführung des Befehls, erhalten Sie eine Antwort wie diese:
Diese Antwort enthält einige wichtige Informationen.
Es gibt ein neues Konto namens FalconFlights mit einer eigenen, eindeutigen Konto-SID und einem Authentifizierungstoken.
Die owner_account_sid
sollte mit der SID Ihres (übergeordneten) Projektkontos übereinstimmen (Owlie Notifications).
Notieren Sie sich die SID des Unterkontos und das Authentifizierungstoken, da Sie diese später noch verwenden werden.
Eine Telefonnummer übertragen
Etwas weiter oben ging es um die Übertragung einer Telefonnummer. Hier erfahren Sie, wie das geht. Wenn Sie keine Twilio-Telefonnummer haben, können Sie eine erwerben, entweder über die Twilio-Konsole oder die REST API.
Um Ihre Twilio-Telefonnummer von Ihrem übergeordneten Konto auf Ihr Unterkonto zu übertragen, navigieren Sie zum Abschnitt „Active Numbers“ (Aktive Nummern) in der Konsole. Klicken Sie auf eine Nummer, um Konfigurationsoptionen anzuzeigen.
Dort finden Sie die SID Ihrer Telefonnummer (PNxxx).
![Telefonnummern-Kennung in Twilio finden](/content/dam/twilio-com/global/en/blog/legacy/2021/guide-twilio-subaccounts/o1I04d6uUAixqdjrQydZXfIc7lD5UlPJTDUYzJZbb5Ed97fIvGuMVFgNJydT9u-WW8A0jESstUbNAq.png)
Anfrage
Sie müssen die SID Ihres übergeordneten Kontos in Ihren Headern verwenden, da die Telefonnummer zu dem übergeordneten Konto gehört.
Führen Sie den folgenden Befehl in Ihrem Terminal aus:
Beachten Sie, dass die Voice- und SMS-URL beim Übertragen von Telefonnummern auf ein anderes Konto erhalten bleibt.
Antwort
Messaging-Dienst erstellen
Erstellen Sie einen Messaging-Dienst in Ihrem neu erstellten Unterkonto. Ein Messaging-Dienst ist eine Ressource, die als Container für Ihre Telefonnummern fungieren kann und Software bereitstellt, über die Sie Nachrichten in großem Umfang ganz einfach senden können.
Für diese Anfrage verwenden Sie die Konto-SID und das Authentifizierungstoken, die mit dem Unterkonto verknüpft sind.
Anfrage
Antwort
In der Antwort ist die SID des Messaging-Dienstes (Mgxxxx) enthalten. Sie werden sie in den nächsten Schritten benötigen. Halten Sie sie griffbereit.
Sie werden feststellen, dass Ihr Response-Objekt einige verschiedene Attribute enthält. Wenn Sie mehr über die Funktionen eines Messaging-Dienstes erfahren möchten, lesen Sie die Dokumentation zum Messaging-Dienst.
Telefonnummern zum Messaging-Dienst hinzufügen
Mit der Services-API können Sie Ihre Telefonnummer zu Ihrem Messaging-Dienst hinzufügen.
Anfrage
Antwort
Sie haben die Telefonnummer jetzt erfolgreich zu Ihrem Messaging-Dienst hinzugefügt.
Eine Nachricht senden
Mit einem neuen Unterkonto und einem Messaging-Dienst mit Telefonnummer können Sie jetzt eine Nachricht senden.
Um eine Nachricht über den Messaging-Dienst zu senden, verwenden Sie die SID des Messaging-Dienstes (MGxxx) in Ihrer Anfrage.
Stellen Sie sicher, dass die To
-Telefonnummer verifiziert ist. Wenn Ihre Nummer nicht verifiziert ist, können Sie eine verifizierte Telefonnummer über die Twilio-Konsole hinzufügen.
Anfrage
War dies erfolgreich, sollten Sie eine Nachricht wie die folgende erhalten:
![Beispielnachricht von einem Unterkonto](/content/dam/twilio-com/global/en/blog/legacy/2021/guide-twilio-subaccounts/2cphXSI3BCKQSIeEjzl52we01yBXDw7E4_5xWcjLtddw4zsx6hD17P6ORGrijMDwLuy6ppR2AfLlCV.png)
Großartig, es hat funktioniert!
Fazit: Unterkonten sind leistungsstark
Sehen wir uns die letzten Schritte noch einmal an. Sie haben:
- ein Unterkonto erstellt
- eine Telefonnummer von Ihrem übergeordneten Konto an Ihr Unterkonto übertragen
- einen Messaging-Dienst in Ihrem Unterkonto erstellt
- eine Telefonnummer zum Messaging-Dienst hinzugefügt
- eine Nachricht über Ihren Messaging-Dienst in Ihrem Unterkonto gesendet
Hoffentlich erkennen Sie die Vorteile von Unterkonten. Mit diesem Artikel haben wir nur an der Oberfläche gekratzt. Wenn Ihnen dieser Blogbeitrag gefallen hat, könnten Sie auch die folgenden Themen interessieren:
- Nutzung von Unterkonten mit der Nutzungs-API verfolgen
- Einrichten von Nutzungsauslösern
- Messaging-Architektur für unabhängige Softwareanbieter
- Voice-Architektur für unabhängige Softwareanbieter
Josh ist Senior Solutions Engineer bei Twilio und unterstützt unsere unabhängigen Softwareanbieter beim Aufbau skalierbarer Architekturen und Geschäfte mit Twilio. Sie erreichen ihn unter jsiverson [at] twilio.com.
Verwandte Posts
Ähnliche Ressourcen
Twilio Docs
Von APIs über SDKs bis hin zu Beispiel-Apps
API-Referenzdokumentation, SDKs, Hilfsbibliotheken, Schnellstarts und Tutorials für Ihre Sprache und Plattform.
Ressourcen-Center
Die neuesten E-Books, Branchenberichte und Webinare
Lernen Sie von Customer-Engagement-Experten, um Ihre eigene Kommunikation zu verbessern.
Ahoy
Twilios Entwickler-Community-Hub
Best Practices, Codebeispiele und Inspiration zum Aufbau von Kommunikations- und digitalen Interaktionserlebnissen.