# Opt-outs en trefwoorden

Wanneer iemand een van je nummers een sms stuurt, controleert Bird het bericht aan de hand van een catalogus met trefwoorden voordat je het ontvangt. Een herkend **stop**-trefwoord onderdrukt toekomstige berichten van die afzender naar de abonnee, een **start**-trefwoord beëindigt de onderdrukking, en **help** antwoordt met ondersteuningsinformatie. Ondersteunde landen hebben hiervoor geen configuratie nodig.

Deze gids behandelt wat Bird standaard doet, hoe je het bekijkt en hoe je het aanpast.

## Wat er standaard gebeurt

Een abonnee sms't `STOP` naar een van je nummers. Bird:

1. **Herkent het** aan de hand van de trefwoordcatalogus voor het land van dat nummer.
2. **Registreert een onderdrukking** op dat exacte afzender-en-abonneepaar.
3. **Bevestigt het** door te antwoorden met het opt-outbericht voor dat land.

Vanaf dat moment wordt een verzending van die afzender naar die abonnee geweigerd met [`E12077 SMSRecipientSuppressed`](/docs/api/errors/E12077) in plaats van verzonden. Een `START` beëindigt de onderdrukking en bevestigt dat ook, en `HELP` antwoordt zonder iets te wijzigen.

Een onderdrukking dekt **één afzender en één abonnee**. Ze dekt niet je hele werkruimte. De technische reikwijdte van die blokkering geeft geen toestemming om een andere afzender te gebruiken. Pas de door de klant uitgesproken voorkeur toe op de berichten en het programma waarvoor ze om stopzetting vroegen. Om elke afzender in de werkruimte tegelijk te stoppen, zie [Opt-out voor elke afzender](#opt-out-voor-elke-afzender) hieronder.

De bevestiging is uitgezonderd van de onderdrukking die ze registreert. Bird kan het inkomende bericht beantwoorden, ook al blokkeert de nieuwe onderdrukking latere uitgaande verzendingen.

## Dekking is per land

De catalogus van Bird dekt een **subset van landen**. Waar een land gedekt is, verwerkt Bird standaard opt-out-, opt-in- en help-trefwoorden. Waar dat niet het geval is, herkent Bird geen trefwoord, stuurt geen antwoord en registreert geen opt-out. Als je naar een niet-gedekt land verzendt, moet je opt-outs zelf verwerken.

Controleer wat een land heeft voordat je erop vertrouwt:

```bash
bird sms keyword-rules list --country NL
```

Een leeg resultaat betekent dat het land geen dekking heeft. Je kunt daar eigen `custom`-trefwoorden toevoegen, maar elke andere bewerking vervangt iets dat Bird meeleveren, dus je kunt er alleen een aanmaken voor een land in de catalogus van Bird.

## Bekijken wat er geldt

`GET /v1/sms/keyword-rules` beschrijft hoe antwoorden op je nummers worden afgehandeld. Ongefilterd geeft het de volledige catalogus van Bird terug samen met regels die je hebt aangemaakt; verfijn met `country`, `number`, `operation` of `scope`:

- `scope=system` geeft alleen de catalogus van Bird terug, inclusief de standaard die een werkruimteregel heeft vervangen.
- `scope=workspace` geeft alleen je eigen regels terug.
- `number=+18005551234` geeft de regels terug die gelden voor een van je nummers, in de volgorde waarin ze worden toegepast op een inkomend bericht; voeg `from_country` toe om te zien wat een afzender die van elders een bericht stuurt krijgt, wat kan verschillen.

Regels komen terug van meest specifiek naar minst specifiek, en elke regel bevat `effective_keywords`: de set van Bird voor die bewerking en dat land plus alles wat je hebt toegevoegd.

De lijst geeft twee bewerkingen terug naast `stop`, `start` en `help`:

- `info` antwoordt met je programma-informatie en gedraagt zich precies zoals `help`. Het is apart zodat een land waarvan het INFO-antwoord moet afwijken van het HELP-antwoord beide kan bevatten; waar Bird geen `info`-regel voor een land meeleveren, is INFO een van de `help`-trefwoorden van dat land en antwoordt met het `help`-antwoord.
- `confirm` markeert een dubbele opt-in-reactie, zoals `JOIN` of `YES`. Het verstuurt momenteel niets, dus beantwoord het vanuit je eigen handler. Bird houdt die trefwoorden vast zodat een `custom`-regel ze niet kan claimen.

## Het antwoord aanpassen

De standaardantwoorden van Bird zijn correct maar generiek. Om onder je eigen naam te antwoorden, maak je een regel aan voor dat land en die bewerking:

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

Je regel vervangt het standaardantwoord van Bird voor dat land en **behoudt de trefwoorden van Bird**, tenzij je er meer toevoegt. De regel neemt ook trefwoorden over die Bird later toevoegt. Je kunt de bewerking die aan een opt-out- of opt-in-trefwoord is toegewezen niet wijzigen; Bird weigert een regel die `STOP` aan een andere bewerking probeert te koppelen.

Waar Bird de trefwoorden van een land in meer dan één taal meeleveren, heeft elke taal een eigen regel, dus bij het aanmaken moet je de taal opgeven die je vervangt. Canada is dat land: de `stop`-, `start`- en `help`-regels zijn beschikbaar in `en` en `fr`. `language` is daar vereist en wordt geweigerd voor een land dat Bird in één taal aanbiedt.

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

De regels van een land opvragen laat zien of de splitsing van toepassing is en welke talen beschikbaar zijn.

Om een regel te beperken tot één nummer in plaats van elk nummer dat je in het land hebt, stel je `number` in in plaats van alleen op het land te vertrouwen.

Als je deze berichten vanuit je eigen systeem beantwoordt in plaats van via Bird, stel dan `reply` in op null samen met `confirmed_self_managed`. Dat schakelt het automatische antwoord van Bird uit voor de regel, terwijl de onderdrukking zelf blijft werken.

## Campagnetrefwoorden

`custom`-regels hebben geen ingebouwd gedrag. Ze matchen trefwoorden die je kiest en sturen het antwoord dat je schrijft, wat campagnetrefwoorden ondersteunt zoals `PIZZA`. Een `custom`-regel neemt geen trefwoorden over, dus heeft er minimaal één eigen nodig, en kan `country` weglaten om overal te gelden waar je verzendt.

Een trefwoord dat Bird aan een compliancebewerking heeft gekoppeld, kan niet worden hergebruikt als aangepast trefwoord.

## Onderdrukkingen bekijken en beheren

`GET /v1/sms/suppressions` toont de paren waarvoor je berichten momenteel geblokkeerd zijn, meest recente eerst. Filter op `destination` om één abonnee te controleren voordat je naar hen verzendt, op `originator` voor een van je afzenders, of op `reason`:

- `keyword_stop`: de abonnee heeft een stop-trefwoord gestuurd.
- `carrier_opted_out`: hun provider heeft de opt-out gemeld.
- `manual`: toegevoegd via de API of het dashboard.

Beëindigde onderdrukkingen worden niet getoond, dus het antwoord identificeert ontvangers naar wie je op dit moment niet kunt verzenden.

Je kunt er zelf een toevoegen om een opt-out te respecteren die een klant je telefonisch heeft gegeven:

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

Een handmatige onderdrukking blokkeert **elke categorie, inclusief transactioneel**, en toevoegen is idempotent. Verwijderen is bewust beperkt: alleen een `manual`-onderdrukking kan op deze manier worden beëindigd. Het eigen stop-trefwoord van een abonnee en een opt-out van een provider worden geweigerd, omdat die niet van jou zijn om terug te draaien.

## Opt-out voor elke afzender

Een stop-trefwoord en de hierboven genoemde handmatige onderdrukkingen stoppen beide één afzender. Sommige abonnees willen stoppen met elke afzender in de werkruimte tegelijk, bijvoorbeeld iemand die je supportteam vraagt om alle sms'jes te stoppen in plaats van op elk nummer apart te antwoorden.

Dat is een uitgesproken voorkeur in plaats van een onderdrukking, dus het staat op het tabblad **Preferences** van **SMS** > **Suppressions**, niet in de bovenstaande lijst. Open het tabblad en registreer een opt-out met **Every sender in the workspace**: het nummer ontvangt geen SMS meer van welke afzender in de werkruimte dan ook, inclusief afzenders die je later toevoegt. Een opt-out op dit tabblad dekt alle berichten, inclusief authenticatieteksten; om er een te registreren die alleen marketing stopt, gebruik je de werkruimtebrede pagina **Contacts** > **Preferences**, waarvan het dialoogvenster de dekkingskeuze biedt.

Bird controleert eerst de onderdrukkingen in deze gids, dus een gewone keyword-stop wordt nog steeds geweigerd met `E12077` zoals voorheen. Een verzending naar een nummer met een werkruimtebrede opt-out wordt geweigerd met [`E25000 PreferenceRevoked`](/docs/api/errors/E25000). Om het verzenden te hervatten zodra de abonnee je daarom vraagt, verwijder je de vermelding van het tabblad Preferences (je hebt het geregistreerd, dus je kunt het verwijderen), of registreer je een opt-in op de werkruimtebrede pagina **Contacts** > **Preferences**.

## Volgende stappen

Bekijk [campagneconsent en verzendcontroles](/products/sms/marketing/compliance) voordat je naar een publiek verzendt, of verken [opt-outafhandeling van SMS](/products/sms/compliance/opt-out) voor je integratie.

- [SMS verzenden](/docs/guides/sms/sending-sms): bekijk categorieën, afzenders en weigeringscondities.
- [Events](/docs/guides/sms/events): verwerk de `sms.*`-events voor verzendingen en antwoorden.
- [SMS-log](/docs/guides/sms/sms-log): inspecteer een bericht, inclusief een geweigerde verzending.

## 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](/sms-api/features/compliance) (product)
- [Operate messaging reliably](/learn/paths/reliability) (course)

[Get an implementation brief](/learn/workspace?topic=consent)