Wat is een STOP-keyword, en wat moet er gebeuren als iemand het stuurt?

Een ontvanger kan vragen te stoppen na het ontvangen van een bericht van een van je nummers. Je applicatie moet dat verzoek koppelen aan de berichten die het daarna verstuurt.

Wat doet Bird met een herkend STOP?

Bird legt een opt-out vast voor het afzender-en-abonnee-paar. Daarna verstuurt het de geconfigureerde bevestiging.

Het matcht eerst de inkomende tekst tegen de toepasselijke keyword-regels. De opt-out moet vastgelegd zijn voordat Bird deze bevestigt, zodat een mislukte schrijfactie geen misleidende bevestiging kan opleveren.

Een latere verzending van die afzender naar die abonnee retourneert E12077 SMSRecipientSuppressed. Bird weigert het verzoek voordat er een uitgaand bericht of een afleverpoging wordt aangemaakt. Er is geen aflever-foutgebeurtenis voor die geweigerde verzending.

Standaard beëindigt start de onderdrukking. Het bevestigt daarna de wijziging. help en info retourneren programma-informatie zonder de opt-out te wijzigen. Als er geen aparte info-regel bestaat, kan INFO als help-keyword dienen.

Dekt de opt-out elk nummer dat ik gebruik?

De keyword-onderdrukking dekt één afzender en één abonnee, niet elke afzender in je werkruimte.

Een opt-out van je marketingnummer onderdrukt bijvoorbeeld niet automatisch een apart afleverbevestigingsnummer. Je applicatie moet de reikwijdte van het daadwerkelijke verzoek van de persoon toepassen voordat je een andere afzender gebruikt.

Gebruik voor een opt-out voor alle afzenders een werkruimtebrede voorkeur. Dat record is gescheiden van een SMS-onderdrukking. Het zendt geen sms_suppression.created uit. Een event handler die alleen op die gebeurtenis let, mist voorkeurswijzigingen.

De opt-outgids beschrijft werkruimtebrede voorkeuren. Een keyword-onderdrukking weigert met E12077. Een werkruimtebrede voorkeur kan weigeren met E25000 PreferenceRevoked.

Hoe controleer ik of Bird het keyword afhandelt?

Je bekijkt de regels die van toepassing zijn op het land of verzendnummer voordat je op automatische afhandeling vertrouwt.

bird sms keyword-rules list --country NL

Een leeg landresultaat betekent dat er geen regels voor dat land zijn geretourneerd. De commandoreferentie documenteert de filters, waaronder --from-country.

Gebruik via de API GET /v1/sms/keyword-rules. Filter op number om de regels van een specifiek nummer te bekijken. Resultaten komen meest specifiek eerst, met de toepasselijke keywords in effective_keywords.

De ingebouwde catalogus van Bird dekt slechts enkele landen. Zonder een toepasselijke regel bereikt het bericht je inbound handler als gewone tekst. Bird legt in dat geval geen automatische opt-out of bevestiging vast. Je handler moet het verzoek herkennen en volgende verzendingen stoppen.

Waarom kan een opt-outbevestiging toch worden verstuurd?

Bird zondert ingebouwde compliance-antwoorden uit van de onderdrukking die ze moeten bevestigen.

Zonder die uitzondering zou het vastleggen van een STOP de eigen bevestiging blokkeren. De uitzondering geldt voor opt-out-, opt-in-, help- en info-antwoorden. Andere verzendcontroles blijven van toepassing.

Een custom keyword-antwoord heeft zo'n uitzondering niet. Anders zou een aangepast antwoord je gekozen tekst kunnen afleveren aan iemand die zich heeft afgemeld.

De confirm-operatie markeert een dubbele opt-in-reactie. Het stuurt geen antwoord. Je handler moet het beantwoorden. Een aangepaste regel zonder antwoordtekst stuurt ook niets.

Wat moet mijn applicatie doen na een opt-out?

Voorkom toekomstige verzendingen die in strijd zijn met het verzoek van de persoon. Leg de reikwijdte van de opt-out vast om deze correct toe te passen.

Behandel E12077 als een geblokkeerde verzending die je in je toestemmingsstatus moet onderzoeken, niet als een tijdelijke afleverfout om opnieuw te proberen. Houd handlers voor oude afzendernummers actief zolang ontvangers nog op hun berichten kunnen reageren.

Honoreer opt-outs die buiten de ingebouwde catalogus of via andere ondersteunde contactmethoden binnenkomen. De CTIA messaging principles verwachten dat afzenders opt-outverzoeken ondersteunen en honoreren.

Controleer bij programma's met meerdere nummers zowel afzenderspecifieke onderdrukkingen als werkruimtebrede voorkeuren. Dat voorkomt dat een wissel van afzender het verzoek van de persoon omzeilt.