Cancelación

STOP significa parar, automáticamente.

Todo destinatario puede enviar STOP para cancelar, HELP para obtener una respuesta de ayuda y START para volver a suscribirse. Bird respeta estas palabras clave automáticamente en cada envío y mantiene una lista de supresión por destinatario que puedes consultar — sin código adicional por tu parte.

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

La cancelación es la única regla que siempre está activa.

La gestión de cancelación forma parte del cumplimiento de SMS en la API de SMS de Bird y, a diferencia del registro, se aplica dondequiera que envíes, sin configuración. Las palabras clave reservadas STOP, HELP y START se reconocen en los mensajes entrantes y se aplican por destinatario, de modo que una persona que cancela sigue cancelada en tus envíos hasta que decide volver.

Cómo se comportan las palabras clave.

Palabras clave reservadas, aplicadas por destinatario.

01
STOP suprime automáticamente.
Cuando un destinatario envía STOP, Bird lo añade a la lista de supresión y bloquea más envíos a ese número sin que tengas que hacer nada.
02
HELP devuelve una respuesta de ayuda.
Un destinatario que envía HELP recibe una respuesta de ayuda automática, así cumples el requisito de palabra clave de ayuda de los operadores sin cablear un handler.
03
START vuelve a suscribirlo.
La cancelación es reversible. Un destinatario que envía START se elimina de la supresión y puede volver a recibir mensajes — siempre tiene el control.
04
La lista de supresión es consultable, por destinatario.
Comprueba si un número está suprimido a través de la API antes de construir una audiencia, para que un destinatario que canceló nunca se cuele de nuevo en un envío.

Una cancelación llega como un evento firmado.

Cuando un destinatario cancela, Bird lo suprime y notifica a tu webhook con un evento sms.opted_out para que tus propios registros se mantengan sincronizados. El evento está firmado con HMAC como todos los webhooks de Bird.

POST /webhooks/bird

sms.opted_out

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

La cancelación es un flujo entrante.

STOP, HELP y START llegan igual que cualquier respuesta — como mensajes entrantes en números bidireccionales. Bird intercepta las palabras clave reservadas y actúa sobre ellas antes de que lleguen a la lógica de tu aplicación, así que obtienes el comportamiento de supresión gratis y aun así ves todo lo demás que envían tus destinatarios.

Preguntas frecuentes sobre cancelación

¿Tengo que gestionar STOP yo mismo?+

No. Bird reconoce STOP en cada envío, suprime al destinatario y bloquea más mensajes a ese número. No escribes ni mantienes ninguna lógica de palabras clave.

¿Qué hace cada una de STOP, HELP y START?+

STOP suprime al destinatario y detiene los mensajes. HELP devuelve una respuesta de ayuda automática. START revierte una cancelación previa y vuelve a suscribir al destinatario. Cada una se aplica por destinatario.

¿Puede volver un destinatario que canceló?+

Sí. La cancelación es reversible. Un destinatario que envía START se elimina de la lista de supresión y puede volver a recibir mensajes. La decisión queda en manos del destinatario.

¿Cómo compruebo si un número está suprimido?+

La lista de supresión es un recurso de la API consultable. Comprueba un número antes de construir una audiencia para que un destinatario que canceló nunca vuelva a entrar en un envío.

Otros temas de cumplimiento

La cancelación es uno de los tres regímenes de cumplimiento de SMS. Mira el resto.

A2P 10DLCRegistro de marca y campaña para el tráfico de aplicación en EE. UU.Registro de ID de remitenteRegistra previamente los IDs de remitente alfanuméricos donde los países lo exijan.Todo el cumplimiento de SMS10DLC, cancelación y registro de ID de remitente en un solo lugar.Visión general de la API de SMSLa API de SMS completa: envío, números, bidireccional, cumplimiento, enrutamiento y analítica.

Respeta cada cancelación sin escribir un handler.

La cancelación es uno de los regímenes de cumplimiento de SMS en Bird. STOP, HELP y START se aplican en cada envío, con una lista de supresión que puedes consultar desde la misma API.

Explora el cumplimiento de SMS Comenzar