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:

Herkent het aan de hand van de trefwoordcatalogus voor het land van dat nummer.
Registreert een onderdrukking op dat exacte afzender-en-abonneepaar.
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 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 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:

Codevoorbeeld

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:

Codevoorbeeld

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.

Codevoorbeeld

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:

Codevoorbeeld

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. 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 voordat je naar een publiek verzendt, of verken opt-outafhandeling van SMS voor je integratie.

SMS verzenden: bekijk categorieën, afzenders en weigeringscondities.
Events: verwerk de sms.*-events voor verzendingen en antwoorden.
SMS-log: inspecteer een bericht, inclusief een geweigerde verzending.

Gerelateerde bronnen

Ga verder met de documentatie, gidsen en voorbeelden voor dit onderwerp. De bronnen zijn in het Engels.

Begrijp het conceptHow do I collect SMS opt-ins?Gebruik de toolPreview message segments Ontdek de mogelijkheidSMS compliance Volg het leerpadOperate messaging reliably

Ontvang een implementatieoverzicht