Ogni destinatario può inviare STOP per annullare l'iscrizione, HELP per ricevere una risposta di assistenza e START per ripristinarla. Bird gestisce automaticamente queste parole chiave a ogni invio e mantiene una lista di soppressione per destinatario che puoi consultare. Nessun codice aggiuntivo da parte tua.
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
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 lista di soppressione e può ricevere nuovamente i messaggi. Il controllo è sempre nelle sue mani.
- 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.
{
"type": "sms.opted_out",
"data": {
"from": "+15005550006",
"keyword": "STOP",
"suppressed": true
}
}
L'opt-out è un flusso inbound.
STOP, HELP e START arrivano come qualsiasi altra risposta, ovvero come messaggi in entrata su numeri bidirezionali. Bird intercetta le parole chiave riservate e le gestisce prima che raggiungano la logica della tua applicazione: ottieni il comportamento di soppressione gratuitamente e continui a vedere tutto il resto di ciò che i tuoi destinatari inviano.
FAQ sull'opt-out
Devo gestire io stesso lo STOP?
Cosa fanno rispettivamente STOP, HELP e START?
Un destinatario che ha fatto opt-out può tornare?
Come faccio a controllare se un numero è soppresso?
Altri argomenti di conformità
L'opt-out è uno dei tre regimi di conformità SMS. Scopri gli altri.
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.