Was ist der Unterschied zwischen Einweg- und Zweiweg-SMS?

Die Form eines Absenders bestimmt, ob Antworten eine Adresse haben. Eine zulässige SMS-Nummer kann eine Nachricht empfangen; ein alphanumerischer Name nicht.

Der Unterschied klingt nach einem Feature, das Sie einschalten. Er ist eher eine physische Eigenschaft dessen, wovon Sie gesendet haben, mit einer länderspezifischen Richtlinie darüber.

Was macht einen Absender zu Einweg?

Dass keine Adresse dahintersteht.

Eine Antwort ist eine Nachricht an denjenigen, der die letzte gesendet hat. Wenn der Absender eine Nummer war, existiert diese Adresse und ein Gerät kann sie nutzen. Wenn der Absender eine alphanumerische Sender-ID war, gibt es keine Nummer zum Adressieren, und das Modell von Bird bildet diese Abwesenheit direkt ab: Der Ländercode eines solchen Absenders ist null, beschrieben als "the country of the number this sender sends from", und er trägt keine Nummern-ID, weil "an alphanumeric sender has no number behind it".

Die erste Unterscheidung ist also strukturell. Langwahlnummern, gebührenfreie Nummern und Kurzwahlnummern können empfangen. Ein alphanumerischer Absender nicht, in keinem Land und unter keiner Registrierung.

Die zweite Unterscheidung ist länderspezifisch. Jeder Absendertyp, den ein Zielland unterstützt, meldet eine direction von one_way oder two_way. Ein Nummerntyp, der in einem Zielland Antworten annimmt, kann in einem anderen nur senden. Die SMS-Richtlinie des Landes trägt auch ein eigenes is_two_way_supported-Flag. Beides sind länderspezifische Werte, die sich ändern, deshalb werden sie auf SMS-Zielländer veröffentlicht statt hier aufgelistet; jede Zielland-Seite gibt an, ob Zweiweg-Messaging unterstützt wird.

Wie erreicht eine Antwort meine Anwendung?

Als Event, an Sie gepusht, mit der bereits gespeicherten Nachricht.

Wenn ein Empfänger eine Ihrer Nummern anschreibt, speichert Bird die Nachricht zusammen mit Ihren Sendungen und sendet sms.received. Die Nutzlast enthält den Inhalt, die Segment-Aufschlüsselung, beide Nummern und den Netzbetreiber, wenn der Carrier einen meldet. Es gibt nichts abzufragen.

Bevor dieses Event Sie erreicht, passiert eine Sache, und sie ändert, was Sie im Handler tun sollten. Bird prüft die Antwort zuerst gegen die Keyword-Regeln für diese Nummer. Ein unterstütztes Stopp-Keyword erfasst eine Absender-und-Empfänger-Sperre und sendet die Opt-out-Bestätigung, und es sendet trotzdem sms.received. Eine eingehende Nachricht, die ein Opt-out war, kommt also an Ihrem Endpunkt an wie jede andere eingehende Nachricht, bereits verarbeitet.

Die Konsequenz für Ihren Code: Behandeln Sie nicht jedes sms.received als Gesprächsschritt. Manche davon sind Opt-outs, die Bird bereits umgesetzt hat, und als Reaktion darauf erneut etwas zu senden ist genau der Fehler, zu dem dieses Muster einlädt. Was ist ein STOP-Keyword beschreibt, welche Keywords erkannt werden, wo, und was in einem Land außerhalb des Katalogs passiert.

Von welchem Absender antworte ich?

Verwenden Sie die Nummer, die die Person kontaktiert hat, solange sie zulässig bleibt, damit die Antwort wiedererkennbar ist. Ihre Anwendung sendet über den öffentlichen SMS-Endpunkt mit den üblichen Absender-, Zielland- und Empfängerprüfungen.

Die integrierten Keyword-Bestätigungen von Bird haben einen separaten internen Antwortkontext. Diesen Kontext kann Ihre API-Anfrage nicht beanspruchen. Er erlaubt weder eine dialogartige Antwort noch einer Kampagne, Registrierung, Ziellandzugang oder das Opt-out einer Person zu umgehen.

Klassifizieren Sie die eingehende Nachricht, bevor Sie antworten. Eine STOP- oder Hilfe-Anfrage sollte ihrem vorgesehenen Verarbeitungsablauf folgen, statt eine unzusammenhängende automatische Antwort auszulösen. Absenderanforderungen und Keyword-Verarbeitung beschreiben die relevanten Prüfungen.

Was kostet mich Zweiweg, das Einweg nicht kostet?

Vier Dinge, keines davon optional, sobald Sie Antworten annehmen.

1. Ein Endpunkt, der Events zuverlässig verifiziert und verarbeitet. Eingehende Nachrichten werden gepusht; berücksichtigen Sie Wiederholungsversuche und doppelte Zustellungen. Webhook-Verarbeitung beschreibt Signaturen, Wiederholungsversuche und Replay. Die Identität des Events steht im webhook-id-Header, außerhalb des Body. Verwenden Sie seinen Wert als Ihren Deduplizierungsschlüssel.
2. Eine Nummer in jedem Zielland, das eine braucht. Ein alphanumerischer Absender kann nicht Teil eines Zweiweg-Programms sein. Eine Kampagne, die beides mischt, braucht daher einen Plan für Zielländer, in denen nur der Name verfügbar ist. Einweg ist auch kein Ausweg aus der Pflicht: Eine Regulierung, die ein Opt-out-Recht gewährt, kann verlangen, dass ein Einweg-Absender offenlegt, dass Antworten nicht funktionieren, und einen anderen Weg anbietet, was Was ist der TCPA beschreibt.
3. Der Umgang mit Nachrichten, für die Sie nicht geplant haben. Menschen antworten auf Benachrichtigungen. Manche dieser Antworten sind Fragen, manche sind Opt-outs und manche sind keines von beidem.
4. Die eingehende Seite Ihrer eigenen Nummern im Blick behalten. Bird meldet eingehendes Volumen getrennt vom ausgehenden. Ein Zweiweg-Programm hat also einen zweiten Satz Kennzahlen zu beobachten.

Wenn nichts davon zutrifft, ist Einweg kein Nachteil. Es ist die kleinere Verpflichtung, und ein alphanumerischer Absender bringt Ihnen einen erkennbaren Namen im Absenderfeld in den Zielländern, die ihn unterstützen. Welchen Absendertyp sollte ich verwenden zeigt den Vergleich vollständig, und Zweiweg-SMS beschreibt, was Bird für die Antwortseite liefert.