# 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: 1. **Erkennt es** anhand des Keyword-Katalogs für das Land dieser Nummer. 2. **Legt eine Unterdrückung an** für genau dieses Absender-Empfänger-Paar. 3. **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`](/docs/api/errors/E12077) 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](#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: ```bash 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: ```bash 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. ```bash 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: ```bash 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`](/docs/api/errors/E25000) 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](/products/sms/marketing/compliance) vor einem Zielgruppenversand, oder erkunden Sie das [SMS-Opt-out-Handling](/products/sms/compliance/opt-out) für Ihre Integration. - [SMS senden](/docs/guides/sms/sending-sms): Kategorien, Absender und Ablehnungsbedingungen prüfen. - [Events](/docs/guides/sms/events): Die `sms.*`-Events für Sendungen und Antworten verarbeiten. - [SMS-Log](/docs/guides/sms/sms-log): Eine Nachricht untersuchen, einschließlich eines abgelehnten Versands. ## Related resources - [How do I collect SMS opt-ins?](/explained/sms/how-do-i-collect-sms-opt-ins) (answer) - [Preview message segments](/tools/sms-segment-calculator) (tool) - [SMS compliance](/products/sms/compliance) (product) - [Operate messaging reliably](/learn/paths/reliability) (course) [Get an implementation brief](/learn/workspace?topic=consent)