Cancelaciones y palabras clave

Cuando alguien envía un mensaje a uno de tus números, Bird compara el mensaje con un catálogo de palabras clave antes de que lo recibas. Una palabra clave de cancelación (stop) suprime los mensajes futuros de ese remitente al suscriptor, una palabra clave de inicio (start) termina la supresión y help responde con información de soporte. Los países compatibles no necesitan configuración para este comportamiento.

Esta guía cubre qué hace Bird por defecto, cómo verlo y cómo cambiarlo.

Qué sucede por defecto

Un suscriptor envía STOP a uno de tus números. Bird:

Lo reconoce comparándolo con el catálogo de palabras clave del país de ese número.
Registra una supresión en ese par exacto de remitente y suscriptor.
Lo confirma respondiendo con el mensaje de cancelación de ese país.

A partir de entonces, un envío de ese remitente a ese suscriptor se rechaza con E12077 SMSRecipientSuppressed en lugar de salir. Un START termina la supresión y también lo confirma, y HELP responde sin cambiar nada.

Una supresión cubre un remitente y un suscriptor. No cubre todo tu espacio de trabajo. El alcance técnico de ese bloqueo no otorga permiso para usar otro remitente. Aplica la preferencia declarada del cliente a los mensajes y el programa que pidió detener. Para detener todos los remitentes del espacio de trabajo a la vez, consulta Cancelar todos los remitentes más abajo.

La confirmación está exenta de la supresión que registra. Bird puede responder al mensaje entrante aunque la nueva supresión bloquee los envíos salientes posteriores.

La cobertura es por país

El catálogo de Bird cubre un subconjunto de países. Donde un país tiene cobertura, Bird gestiona las palabras clave de cancelación, activación y ayuda por defecto. Donde no la tiene, Bird no reconoce ninguna palabra clave, no envía respuesta y no registra ninguna cancelación. Si envías a un país sin cobertura, debes gestionar las cancelaciones tú mismo.

Comprueba qué tiene un país antes de depender de ello:

Ejemplo de código

bird sms keyword-rules list --country NL

Un resultado vacío significa que el país no tiene cobertura. Puedes añadir tus propias palabras clave custom ahí, pero cualquier otra operación reemplaza algo que Bird incluye de fábrica, así que solo puedes crear una para un país del catálogo de Bird.

Ver qué se aplica

GET /v1/sms/keyword-rules describe cómo se gestionan las respuestas a tus números. Sin filtro, devuelve todo el catálogo de Bird junto con las reglas que hayas creado; acótalo con country, number, operation o scope:

scope=system devuelve solo el catálogo de Bird, incluido el valor por defecto que una regla del espacio de trabajo reemplazó.
scope=workspace devuelve solo tus propias reglas.
number=+18005551234 devuelve las reglas que se aplican a uno de tus números, en el orden en que se aplican a un mensaje entrante; añade from_country para ver qué recibe un remitente que envía desde otro lugar, lo cual puede diferir.

Las reglas se devuelven de la más específica a la más general, y cada una incluye effective_keywords: el conjunto de Bird para esa operación y país más lo que hayas añadido.

La lista devuelve dos operaciones además de stop, start y help:

info responde con la información de tu programa y se comporta exactamente como help. Existe por separado para que un país cuya respuesta INFO deba diferir de su respuesta HELP pueda tener ambas; donde Bird no incluye una regla info para un país, INFO es una de las palabras clave help de ese país y responde con la respuesta de help.
confirm marca una respuesta de doble confirmación de suscripción, como JOIN o YES. No envía nada actualmente, así que respóndela desde tu propio handler. Bird retiene esas palabras clave para que una regla custom no pueda reclamarlas.

Cambiar la respuesta

Las respuestas por defecto de Bird son correctas pero genéricas. Para responder con tu propio nombre, crea una regla para ese país y operación:

Ejemplo de código

bird sms keyword-rules create \
  --operation stop \
  --country NL \
  --reply "You are unsubscribed from MyBrand. Reply START to resume."

Tu regla reemplaza la respuesta por defecto de Bird para ese país y conserva las palabras clave de Bird a menos que añadas más. También hereda las palabras clave que Bird añada después. No puedes cambiar la operación asignada a una palabra clave de cancelación o activación; Bird rechaza una regla que intente vincular STOP a otra operación.

Donde Bird incluye las palabras clave de un país en más de un idioma, cada idioma tiene su propia regla, así que al crear una debes indicar el idioma que reemplaza. Canadá es ese país actualmente: sus reglas stop, start y help vienen en en y fr. language es obligatorio allí y se rechaza para un país que Bird ofrece en un solo idioma.

Ejemplo de código

bird sms keyword-rules create \
  --operation stop \
  --country CA \
  --language fr \
  --reply "Vous etes desabonne de MyBrand. Repondez DEBUT pour reprendre."

Listar las reglas de un país muestra si la división por idioma aplica y qué idiomas están disponibles.

Para limitar una regla a un número en lugar de a todos los números que tienes en el país, establece number en vez de depender solo del país.

Si respondes a estos mensajes desde tu propio sistema en lugar de a través de Bird, establece reply a null junto con confirmed_self_managed. Eso desactiva la respuesta automática de Bird para la regla, mientras la supresión en sí sigue funcionando.

Palabras clave de campaña

Las reglas custom no tienen un comportamiento integrado. Coinciden con las palabras clave que elijas y envían la respuesta que escribas, lo que permite palabras clave de campaña como PIZZA. Una regla custom no hereda palabras clave, así que necesita al menos una propia, y puede omitir country para aplicarse en todos los destinos donde envíes.

Una palabra clave que Bird ha vinculado a una operación de cumplimiento no puede reutilizarse como una personalizada.

Consultar y gestionar supresiones

GET /v1/sms/suppressions lista los pares para los que tus mensajes están detenidos actualmente, del más reciente al más antiguo. Filtra por destination para verificar un suscriptor antes de enviarle, por originator para uno de tus remitentes o por reason:

keyword_stop: el suscriptor envió una palabra clave de cancelación.
carrier_opted_out: su operador reportó la cancelación.
manual: añadido a través de API o del panel de control.

Las supresiones que han terminado no se listan, así que la respuesta identifica a los destinatarios a los que no puedes enviar mensajes en este momento.

Puedes añadir una tú mismo para cumplir una cancelación que un cliente te dio por teléfono:

Ejemplo de código

bird sms suppressions add --destination +15550001234 --originator +15557654321

Una supresión manual bloquea todas las categorías, incluida la transaccional, y añadirla es idempotente. Eliminar una es deliberadamente restrictivo: solo una supresión manual puede terminarse de esta manera. La cancelación por palabra clave del propio suscriptor y la cancelación del operador se rechazan, porque no te corresponde revertirlas.

Cancelar todos los remitentes

Una palabra clave de cancelación, y las supresiones manuales anteriores, detienen solo un remitente. Algunos suscriptores quieren salir de todos los remitentes del espacio de trabajo a la vez, por ejemplo alguien que le dice a tu equipo de soporte que detenga todos los mensajes en lugar de responder a cada número individualmente.

Eso es una preferencia declarada y no una supresión, así que se encuentra en la pestaña Preferences de SMS > Suppressions, no en la lista anterior. Abre la pestaña y registra una cancelación con Every sender in the workspace: el número deja de recibir SMS de todos los remitentes del espacio de trabajo, incluidos los remitentes que añadas después. Una cancelación registrada en esta pestaña cubre todos los mensajes, incluidos los de autenticación; para registrar una que detenga solo el marketing, usa la página Contacts > Preferences de todo el espacio de trabajo, cuyo diálogo ofrece la opción de cobertura.

Bird comprueba primero las supresiones de esta guía, así que una cancelación por palabra clave sigue rechazándose con E12077 como antes. Un envío a un número con una cancelación de todo el espacio de trabajo en archivo se rechaza con E25000 PreferenceRevoked. Para reanudar los envíos cuando el suscriptor te lo pida, elimina la entrada de la pestaña Preferences (tú la registraste, así que puedes eliminarla) o registra una activación en la página Contacts > Preferences de todo el espacio de trabajo.

Próximos pasos

Revisa consentimiento de campaña y controles de envío antes de un envío a una audiencia, o explora gestión de cancelaciones de SMS para tu integración.

Envío de SMS: revisa categorías, remitentes y condiciones de rechazo.
Events: gestiona los eventos sms.* de envíos y respuestas.
Registro de SMS: inspecciona un mensaje, incluido un envío rechazado.

Recursos relacionados

Continúa con la documentación, guías y ejemplos sobre este tema. Los recursos están en inglés.

Comprender el conceptoHow do I collect SMS opt-ins?Usar la herramientaPreview message segments Explorar la funcionalidadSMS compliance Seguir la ruta de aprendizajeOperate messaging reliably

Obtener un resumen de implementación