Opt-out

STOP veut dire stop, automatiquement.

Chaque destinataire peut envoyer STOP pour se désinscrire, HELP pour obtenir une réponse d'aide, et START pour se réabonner. Bird respecte ces mots-clés automatiquement à chaque envoi et tient une liste de suppression par destinataire que vous pouvez interroger — sans code supplémentaire de votre côté.

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..."

L'opt-out est la seule règle qui est toujours active.

La gestion de l'opt-out fait partie de la conformité SMS sur l'API SMS de Bird, et contrairement à l'enregistrement, elle s'applique partout où vous envoyez, sans aucune configuration. Les mots-clés réservés STOP, HELP et START sont reconnus dans les messages entrants et appliqués par destinataire, de sorte qu'une personne qui se désinscrit reste désinscrite sur tous vos envois jusqu'à ce qu'elle choisisse de revenir.

Comment se comportent les mots-clés.

Mots-clés réservés, appliqués par destinataire.

01
STOP supprime automatiquement.
Lorsqu'un destinataire envoie STOP, Bird l'ajoute à la liste de suppression et bloque tout envoi ultérieur vers ce numéro sans aucune action de votre part.
02
HELP renvoie une réponse d'aide.
Un destinataire qui envoie HELP reçoit une réponse d'aide automatique, de sorte que vous respectez l'exigence des opérateurs relative au mot-clé d'aide sans câbler de gestionnaire.
03
START le réabonne.
L'opt-out est réversible. Un destinataire qui envoie START est retiré de la suppression et peut de nouveau recevoir des messages — il garde toujours le contrôle.
04
La liste de suppression est interrogeable, par destinataire.
Vérifiez si un numéro est supprimé via l'API avant de constituer une audience, afin qu'un destinataire désinscrit ne se glisse jamais à nouveau dans un envoi.

Un opt-out arrive sous forme d'événement signé.

Lorsqu'un destinataire se désinscrit, Bird le supprime et notifie votre webhook avec un événement sms.opted_out afin que vos propres enregistrements restent synchronisés. L'événement est signé HMAC comme tout webhook Bird.

POST /webhooks/bird

sms.opted_out

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

L'opt-out est un flux entrant.

STOP, HELP et START arrivent de la même manière que n'importe quelle réponse — sous forme de messages entrants sur des numéros bidirectionnels. Bird intercepte les mots-clés réservés et les traite avant qu'ils n'atteignent la logique de votre application, de sorte que vous bénéficiez du comportement de suppression gratuitement tout en continuant de voir tout le reste de ce que vos destinataires envoient.

FAQ sur l'opt-out

Dois-je gérer STOP moi-même ?+

Non. Bird reconnaît STOP à chaque envoi, supprime le destinataire et bloque tout message ultérieur vers ce numéro. Vous n'écrivez ni ne maintenez aucune logique de mots-clés.

Que font STOP, HELP et START respectivement ?+

STOP supprime le destinataire et arrête les messages. HELP renvoie une réponse d'aide automatique. START annule un opt-out précédent et réabonne le destinataire. Chacun est appliqué par destinataire.

Un destinataire qui s'est désinscrit peut-il revenir ?+

Oui. L'opt-out est réversible. Un destinataire qui envoie START est retiré de la liste de suppression et peut de nouveau recevoir des messages. Le choix appartient au destinataire.

Comment vérifier si un numéro est supprimé ?+

La liste de suppression est une ressource d'API interrogeable. Recherchez un numéro avant de constituer une audience afin qu'un destinataire désinscrit ne réintègre jamais un envoi.

Autres sujets de conformité

L'opt-out est l'un des trois régimes de conformité SMS. Découvrez les autres.

A2P 10DLCEnregistrement de marque et de campagne pour le trafic applicatif américain.Enregistrement du sender IDPré-inscrivez les sender IDs alphanumériques là où les pays l'exigent.Toute la conformité SMS10DLC, opt-out et enregistrement du sender ID en un seul endroit.Aperçu de l'API SMSL'API SMS complète : envoi, numéros, bidirectionnel, conformité, routage et analyse.

Respectez chaque opt-out sans écrire de gestionnaire.

L'opt-out est l'un des régimes de la conformité SMS sur Bird. STOP, HELP et START sont appliqués à chaque envoi, avec une liste de suppression que vous pouvez interroger depuis la même API.

Explorez la conformité SMS Commencer