Opt-outs und Keywords

Wenn jemand eine Ihrer Nummern anschreibt, prüft Bird die Nachricht vor dem Empfang gegen einen Katalog von Keywords. Ein erkanntes Stop-Keyword unterdrückt künftige Nachrichten von diesem Absender an den Empfänger, ein Start-Keyword beendet die Unterdrückung und Help antwortet mit Supportinformationen. In unterstützten Ländern ist dafür keine Einrichtung nötig.

Dieser Leitfaden beschreibt, was Bird standardmäßig tut, wie Sie es einsehen und wie Sie es ändern.

Was standardmäßig passiert

Ein Empfänger schreibt STOP an eine Ihrer Nummern. Bird:

Erkennt es anhand des Keyword-Katalogs für das Land dieser Nummer.
Legt eine Unterdrückung an für genau dieses Absender-Empfänger-Paar.
Bestätigt es mit der Opt-out-Nachricht für dieses Land.

Ab diesem Zeitpunkt wird ein Versand von diesem Absender an diesen Empfänger mit E12077 SMSRecipientSuppressed abgelehnt, statt zugestellt zu werden. Ein START beendet die Unterdrückung und bestätigt dies ebenfalls, und HELP antwortet, ohne etwas zu ändern.

Eine Unterdrückung umfasst einen Absender und einen Empfänger. Sie gilt nicht für Ihren gesamten Workspace. Der technische Umfang dieser Sperre begründet keine Berechtigung, einen anderen Absender zu verwenden. Wenden Sie die erklärte Präferenz des Kunden auf die Nachrichten und das Programm an, deren Stopp er verlangt hat. Um alle Absender im Workspace auf einmal zu stoppen, siehe Opt-out für alle Absender weiter unten.

Die Bestätigung ist von der Unterdrückung ausgenommen, die sie anlegt. Bird kann die eingehende Nachricht beantworten, obwohl die neue Unterdrückung spätere ausgehende Sendungen blockiert.

Abdeckung gilt pro Land

Der Katalog von Bird deckt eine Teilmenge von Ländern ab. Wo ein Land abgedeckt ist, verarbeitet Bird Opt-out-, Opt-in- und Help-Keywords standardmäßig. Wo nicht, erkennt Bird kein Keyword, sendet keine Antwort und legt kein Opt-out an. Wenn Sie in ein nicht abgedecktes Land senden, müssen Sie Opt-outs selbst umsetzen.

Prüfen Sie, was ein Land bietet, bevor Sie sich darauf verlassen:

Codebeispiel

bird sms keyword-rules list --country NL

Ein leeres Ergebnis bedeutet, dass das Land keine Abdeckung hat. Sie können dort eigene custom-Keywords hinzufügen, aber jede andere Operation ersetzt etwas, das Bird mitliefert – Sie können eine solche nur für ein Land im Katalog von Bird erstellen.

Einsehen, was gilt

GET /v1/sms/keyword-rules beschreibt, wie Antworten auf Ihre Nummern behandelt werden. Ungefiltert liefert es den gesamten Katalog von Bird zusammen mit allen von Ihnen erstellten Regeln zurück; grenzen Sie mit country, number, operation oder scope ein:

scope=system liefert nur den Katalog von Bird zurück, einschließlich des Standards, den eine Workspace-Regel ersetzt hat.
scope=workspace liefert nur Ihre eigenen Regeln zurück.
number=+18005551234 liefert die Regeln zurück, die für eine Ihrer Nummern gelten, in der Reihenfolge, in der sie auf eine eingehende Nachricht angewendet werden; fügen Sie from_country hinzu, um zu sehen, was ein Absender erhält, der aus einem anderen Land schreibt – das kann abweichen.

Regeln werden mit der spezifischsten zuerst zurückgegeben, und jede enthält effective_keywords: den Satz von Bird für diese Operation und dieses Land plus alles, was Sie hinzugefügt haben.

Die Liste liefert zwei Operationen über stop, start und help hinaus:

info antwortet mit Ihren Programminformationen und verhält sich genau wie help. Es ist getrennt, damit ein Land, dessen INFO-Antwort von seiner HELP-Antwort abweichen muss, beides führen kann; wo Bird keine info-Regel für ein Land mitliefert, ist INFO eines der help-Keywords dieses Landes und antwortet mit der help-Antwort.
confirm markiert eine Double-Opt-in-Antwort wie JOIN oder YES. Es sendet derzeit nichts, beantworten Sie es daher über Ihren eigenen Handler. Bird hält diese Keywords vor, damit eine custom-Regel sie nicht beanspruchen kann.

Antwort ändern

Die Standardantworten von Bird sind korrekt, aber generisch. Um in Ihrem eigenen Namen zu antworten, erstellen Sie eine Regel für das jeweilige Land und die Operation:

Codebeispiel

bird sms keyword-rules create \
  --operation stop \
  --country NL \
  --reply "You are unsubscribed from MyBrand. Reply START to resume."

Ihre Regel ersetzt die Standardantwort von Bird für dieses Land und behält die Keywords von Bird bei, sofern Sie keine weiteren hinzufügen. Sie erbt auch Keywords, die Bird später hinzufügt. Sie können die einem Opt-out- oder Opt-in-Keyword zugewiesene Operation nicht ändern; Bird lehnt eine Regel ab, die versucht, STOP an eine andere Operation zu binden.

Wo Bird die Keywords eines Landes in mehr als einer Sprache mitliefert, hat jede Sprache ihre eigene Regel, sodass eine Erstellung die zu ersetzende Sprache benennen muss. Kanada ist derzeit dieses Land: seine stop-, start- und help-Regeln gibt es in en und fr. language ist dort erforderlich und wird für ein Land abgelehnt, das Bird in nur einer Sprache führt.

Codebeispiel

bird sms keyword-rules create \
  --operation stop \
  --country CA \
  --language fr \
  --reply "Vous etes desabonne de MyBrand. Repondez DEBUT pour reprendre."

Durch Auflisten der Regeln eines Landes sehen Sie, ob die Aufteilung gilt und welche Sprachen verfügbar sind.

Um eine Regel auf eine einzelne Nummer statt auf alle Nummern, die Sie in dem Land halten, zu beschränken, setzen Sie number, statt sich allein auf das Land zu verlassen.

Wenn Sie diese Nachrichten über Ihr eigenes System statt über Bird beantworten, setzen Sie reply zusammen mit confirmed_self_managed auf null. Das schaltet die automatische Antwort von Bird für die Regel ab, während die Unterdrückung selbst weiterhin greift.

Kampagnen-Keywords

custom-Regeln haben kein eingebautes Verhalten. Sie matchen von Ihnen gewählte Keywords und senden die von Ihnen verfasste Antwort, was Kampagnen-Keywords wie PIZZA unterstützt. Eine custom-Regel erbt keine Keywords und braucht daher mindestens ein eigenes; country kann weggelassen werden, damit sie überall gilt, wo Sie senden.

Ein Keyword, das Bird an eine Compliance-Operation gebunden hat, kann nicht als Custom-Keyword wiederverwendet werden.

Unterdrückungen lesen und verwalten

GET /v1/sms/suppressions listet die Paare auf, für die Ihre Nachrichten derzeit gestoppt sind, neueste zuerst. Filtern Sie nach destination, um einen Empfänger vor dem Senden zu prüfen, nach originator für einen Ihrer Absender oder nach reason:

keyword_stop: Der Empfänger hat ein Stop-Keyword gesendet.
carrier_opted_out: Sein Mobilfunkanbieter hat das Opt-out gemeldet.
manual: Über die API oder das Dashboard hinzugefügt.

Beendete Unterdrückungen werden nicht aufgelistet, daher zeigt die Antwort die Empfänger an, die Sie derzeit nicht erreichen können.

Sie können selbst eine hinzufügen, um ein Opt-out umzusetzen, das Ihnen ein Kunde telefonisch mitgeteilt hat:

Codebeispiel

bird sms suppressions add --destination +15550001234 --originator +15557654321

Eine manuelle Unterdrückung blockiert jede Kategorie, einschließlich transaktionaler Nachrichten, und das Hinzufügen ist idempotent. Das Entfernen ist bewusst eingeschränkt: Nur eine manual-Unterdrückung kann auf diesem Weg beendet werden. Das Stop-Keyword eines Empfängers und das Opt-out eines Mobilfunkanbieters werden abgelehnt, weil deren Rücknahme nicht Ihnen zusteht.

Opt-out für alle Absender

Ein Stop-Keyword und die oben beschriebenen manuellen Unterdrückungen stoppen jeweils einen Absender. Manche Empfänger möchten alle Absender im Workspace auf einmal abbestellen, zum Beispiel jemand, der Ihrem Supportteam sagt, alle Textnachrichten zu stoppen, statt auf jede Nummer einzeln zu antworten.

Das ist eine erklärte Präferenz und keine Unterdrückung, daher befindet sie sich im Tab Preferences unter SMS > Suppressions, nicht in der obigen Liste. Öffnen Sie den Tab und erfassen Sie ein Opt-out mit Every sender in the workspace: Die Nummer empfängt keine SMS mehr von einem Absender im Workspace, einschließlich später hinzugefügter Absender. Ein auf diesem Tab erfasstes Opt-out deckt alle Nachrichten ab, auch Authentifizierungstexte; um eines zu erfassen, das nur Marketing stoppt, verwenden Sie die Workspace-weite Seite Contacts > Preferences, deren Dialog die Abdeckungsauswahl bietet.

Bird prüft zuerst die Unterdrückungen aus diesem Leitfaden, daher lehnt ein einfaches Keyword-Stop weiterhin mit E12077 ab wie zuvor. Ein Versand an eine Nummer mit einem Workspace-weiten Opt-out wird stattdessen mit E25000 PreferenceRevoked abgelehnt. Um den Versand fortzusetzen, sobald der Empfänger Sie darum bittet, entfernen Sie den Eintrag vom Preferences-Tab (Sie haben ihn erfasst, also können Sie ihn entfernen) oder erfassen Sie ein Opt-in auf der Workspace-weiten Seite Contacts > Preferences.

Nächste Schritte

Lesen Sie Kampagnen-Consent und Sendekontrollen vor einem Zielgruppenversand, oder erkunden Sie das SMS-Opt-out-Handling für Ihre Integration.

SMS senden: Kategorien, Absender und Ablehnungsbedingungen prüfen.
Events: Die sms.*-Events für Sendungen und Antworten verarbeiten.
SMS-Log: Eine Nachricht untersuchen, einschließlich eines abgelehnten Versands.

Verwandte Ressourcen