Opt-out

STOP betekent stop, automatisch.

Elke ontvanger kan STOP sms'en om zich af te melden, HELP voor een helpreactie, en START om zich weer aan te melden. Bird honoreert deze keywords automatisch bij elke verzending en houdt een suppressielijst per ontvanger bij die je kunt bevragen — geen extra code aan jouw kant.

send-otp.ts

200 · 0.4s

import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });

const code = generateOtp();

const { data, error } = await bird.sms.send({
  from: "Bird",
  to:   "+15005550006",
  text: `Your Bird verification code is ${code}. Reply STOP to opt out.`,
}).safe();

if (error) throw error;
console.log(data.id);
// → "sms_4kT01Lq2m..."

import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });

const code = generateOtp();

const { data, error } = await bird.sms.send({
  from: "Bird",
  to:   "+15005550006",
  text: `Your Bird verification code is ${code}. Reply STOP to opt out.`,
}).safe();

if (error) throw error;
console.log(data.id);
// → "sms_4kT01Lq2m..."

send-otp.ts

200 · 0.4s

import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });

const code = generateOtp();

const { data, error } = await bird.sms.send({
  from: "Bird",
  to:   "+15005550006",
  text: `Your Bird verification code is ${code}. Reply STOP to opt out.`,
}).safe();

if (error) throw error;
console.log(data.id);
// → "sms_4kT01Lq2m..."

import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });

const code = generateOtp();

const { data, error } = await bird.sms.send({
  from: "Bird",
  to:   "+15005550006",
  text: `Your Bird verification code is ${code}. Reply STOP to opt out.`,
}).safe();

if (error) throw error;
console.log(data.id);
// → "sms_4kT01Lq2m..."

Opt-out is de ene regel die altijd aanstaat.

Opt-out-afhandeling is onderdeel van SMS compliance op de Bird SMS API, en anders dan registratie geldt het overal waar je verstuurt, zonder setup. De gereserveerde keywords STOP, HELP en START worden in inkomende berichten herkend en per ontvanger uitgevoerd, zodat iemand die zich afmeldt afgemeld blijft over al je verzendingen tot ze ervoor kiezen terug te komen.

Hoe de keywords zich gedragen.

Gereserveerde keywords, afgedwongen per ontvanger.

01
STOP onderdrukt automatisch.
Wanneer een ontvanger STOP sms't, voegt Bird hen toe aan de suppressielijst en blokkeert verdere verzendingen naar dat nummer zonder enige actie van jou.
02
HELP geeft een helpreactie terug.
Een ontvanger die HELP sms't krijgt een automatisch helpantwoord, zodat je voldoet aan de help-keyword-eis van de carriers zonder een handler te bouwen.
03
START schrijft hen opnieuw in.
Opt-out is omkeerbaar. Een ontvanger die START sms't wordt uit de suppressie verwijderd en kan weer berichten ontvangen — zij houden altijd de controle.
04
De suppressielijst is opvraagbaar, per ontvanger.
Controleer via de API of een nummer is onderdrukt voordat je een audience opbouwt, zodat een afgemelde ontvanger nooit opnieuw in een verzending glipt.

Een opt-out komt binnen als een ondertekend event.

Wanneer een ontvanger zich afmeldt, onderdrukt Bird hen en notificeert je webhook met een sms.opted_out event zodat je eigen records gesynchroniseerd blijven. Het event is HMAC-ondertekend zoals elke Bird-webhook.

POST /webhooks/bird

sms.opted_out

{
  "type": "sms.opted_out",
  "data": {
    "from": "+15005550006",
    "keyword": "STOP",
    "suppressed": true
  }
}

Opt-out is een inbound flow.

STOP, HELP en START komen op dezelfde manier binnen als elk antwoord — als inkomende berichten op two-way nummers. Bird onderschept de gereserveerde keywords en voert ze uit voordat ze je applicatielogica bereiken, zodat je het suppressiegedrag gratis krijgt en alsnog alles ziet wat je ontvangers verder versturen.

Opt-out FAQ

Moet ik STOP zelf afhandelen?+

Nee. Bird herkent STOP bij elke verzending, onderdrukt de ontvanger en blokkeert verdere berichten naar dat nummer. Je schrijft of onderhoudt geen keywordlogica.

Wat doen STOP, HELP en START elk?+

STOP onderdrukt de ontvanger en stopt berichten. HELP geeft een automatische helpreactie terug. START draait een eerdere opt-out terug en schrijft de ontvanger opnieuw in. Elk wordt per ontvanger uitgevoerd.

Kan een ontvanger die zich heeft afgemeld terugkomen?+

Ja. Opt-out is omkeerbaar. Een ontvanger die START sms't wordt van de suppressielijst verwijderd en kan weer berichten ontvangen. De keuze blijft bij de ontvanger.

Hoe controleer ik of een nummer is onderdrukt?+

De suppressielijst is een opvraagbare API-resource. Zoek een nummer op voordat je een audience opbouwt, zodat een afgemelde ontvanger nooit opnieuw in een verzending belandt.

Andere compliance-onderwerpen

Opt-out is een van de drie SMS-compliance-regimes. Bekijk de rest.

A2P 10DLCBrand- en campagneregistratie voor Amerikaans applicatieverkeer.Sender-ID-registratiePreregistreer alfanumerieke sender ID's waar landen het vereisen.Alle SMS compliance10DLC, opt-out en sender-ID-registratie op één plek.SMS API-overzichtDe volledige SMS API: verzenden, nummers, two-way, compliance, routering en analytics.

Honoreer elke opt-out zonder een handler te schrijven.

Opt-out is één regime van SMS compliance op Bird. STOP, HELP en START worden bij elke verzending afgedwongen, met een suppressielijst die je vanuit dezelfde API kunt bevragen.

Verken SMS compliance Aan de slag