Opt-out

STOP significa stop, automaticamente.

Ogni destinatario può inviare STOP per fare opt-out, HELP per ottenere una risposta di aiuto e START per reiscriversi. Bird rispetta queste keyword automaticamente a ogni invio e mantiene una lista di soppressione per destinatario che puoi interrogare — senza codice extra da parte tua.

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 è l'unica regola sempre attiva.

La gestione dell'opt-out fa parte della conformità SMS sull'API SMS di Bird e, a differenza della registrazione, si applica ovunque tu invii, senza configurazione. Le keyword riservate STOP, HELP e START vengono riconosciute nei messaggi in entrata e applicate per destinatario, così una persona che fa opt-out resta in opt-out attraverso i tuoi invii finché non sceglie di tornare.

Come si comportano le keyword.

Keyword riservate, applicate per destinatario.

01
STOP sopprime automaticamente.
Quando un destinatario invia STOP, Bird lo aggiunge alla lista di soppressione e blocca ulteriori invii verso quel numero senza alcuna azione da parte tua.
02
HELP restituisce una risposta di aiuto.
Un destinatario che invia HELP riceve una risposta di aiuto automatica, così rispetti il requisito dei carrier sulla keyword di aiuto senza cablare un handler.
03
START lo reiscrive.
L'opt-out è reversibile. Un destinatario che invia START viene rimosso dalla soppressione e può ricevere di nuovo messaggi — ha sempre il controllo.
04
La lista di soppressione è interrogabile, per destinatario.
Controlla se un numero è soppresso tramite l'API prima di costruire un'audience, così un destinatario che ha fatto opt-out non rientra mai in un invio.

Un opt-out arriva come evento firmato.

Quando un destinatario fa opt-out, Bird lo sopprime e notifica il tuo webhook con un evento sms.opted_out così i tuoi record restano sincronizzati. L'evento è firmato con HMAC come ogni webhook di Bird.

POST /webhooks/bird

sms.opted_out

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

L'opt-out è un flusso inbound.

STOP, HELP e START arrivano nello stesso modo di qualsiasi risposta — come messaggi in entrata sui numeri bidirezionali. Bird intercetta le keyword riservate e le elabora prima che raggiungano la logica della tua applicazione, così ottieni il comportamento di soppressione gratis e vedi comunque tutto il resto di ciò che i tuoi destinatari inviano.

FAQ sull'opt-out

Devo gestire io stesso lo STOP?+

No. Bird riconosce STOP a ogni invio, sopprime il destinatario e blocca ulteriori messaggi verso quel numero. Non scrivi né mantieni alcuna logica di keyword.

Cosa fanno rispettivamente STOP, HELP e START?+

STOP sopprime il destinatario e ferma i messaggi. HELP restituisce una risposta di aiuto automatica. START annulla un opt-out precedente e reiscrive il destinatario. Ognuno viene applicato per destinatario.

Un destinatario che ha fatto opt-out può tornare?+

Sì. L'opt-out è reversibile. Un destinatario che invia START viene rimosso dalla lista di soppressione e può ricevere di nuovo messaggi. La scelta resta al destinatario.

Come faccio a controllare se un numero è soppresso?+

La lista di soppressione è una risorsa API interrogabile. Cerca un numero prima di costruire un'audience così un destinatario che ha fatto opt-out non rientra mai in un invio.

Altri argomenti di conformità

L'opt-out è uno dei tre regimi di conformità SMS. Scopri gli altri.

A2P 10DLCRegistrazione di brand e campagna per il traffico applicativo USA.Registrazione del sender IDPre-registra i sender ID alfanumerici dove i paesi lo richiedono.Tutta la conformità SMS10DLC, opt-out e registrazione del sender ID in un unico punto.Panoramica dell'API SMSL'API SMS completa: invio, numeri, bidirezionale, conformità, routing e analisi.

Rispetta ogni opt-out senza scrivere un handler.

L'opt-out è uno dei regimi di conformità SMS su Bird. STOP, HELP e START vengono applicati a ogni invio, con una lista di soppressione che puoi interrogare dalla stessa API.

Esplora la conformità SMS Inizia ora