Elke ontvanger kan STOP sms'en om zich af te melden, HELP voor een hulpantwoord en START om zich weer aan te melden. Bird verwerkt deze trefwoorden automatisch bij elke verzending en houdt een suppressielijst per ontvanger bij die u kunt opvragen. Geen extra code aan uw kant.
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.`,
category: "authentication",
}).safe();
if (error) throw error;
console.log(data.id);
// → "sms_4kT01Lq2m..."
Today at 2:14 PM
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.
Afmelding is omkeerbaar. Een ontvanger die START sms't, wordt van de suppressielijst verwijderd en kan weer berichten ontvangen. De ontvanger heeft altijd zelf 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.
{
"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 ander antwoord — als inkomende berichten op tweewegnummers. Bird onderschept de gereserveerde trefwoorden en verwerkt ze voordat ze uw applicatielogica bereiken, zodat u het suppressiegedrag gratis krijgt en nog steeds al het andere ziet dat uw ontvangers sturen.
Opt-out FAQ
Moet ik STOP zelf afhandelen?
Wat doen STOP, HELP en START elk?
Kan een ontvanger die zich heeft afgemeld terugkomen?
Hoe controleer ik of een nummer is onderdrukt?
Andere compliance-onderwerpen
Opt-out is een van de drie SMS-compliance-regimes. Bekijk de rest.
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.