Reglas de opt-out y opt-in de SMS

La página Opt-out & opt-in rules gestiona las palabras clave SMS entrantes que dan de baja (opt-out) o re-suscriben (opt-in) a un contacto, y el texto de respuesta automática que envía cada palabra clave. Ábrala desde el espacio SMS en Messages → SMS → barra de herramientas: Opt-out Rules, o directamente en /messages/sms/opt-out-rules.

Original en inglés: Reglas de opt-out y opt-in de SMS.

Quién puede abrir la página

La página está restringida a los roles owner, admin y developer. Los roles billing, viewer y supervisor reciben una pantalla de “you don’t have access” en lugar del editor. Si el editor de palabras clave aparece atenuado para uno de sus compañeros, compruebe su rol en los ajustes de la organización.

Qué configura cada regla

Cada regla es una palabra clave más la respuesta automática que envía, en uno de dos grupos:

Palabras clave de opt-out — dan de baja al contacto (STOP, CANCEL, etcétera).
Palabras clave de opt-in — re-suscriben al contacto (START, YES, etcétera).

Para cada palabra clave usted fija:

Campo	Propósito
Keyword	La palabra entrante exacta que dispara la regla. Las palabras clave se almacenan en mayúsculas; una coincidencia entrante de la palabra voltea el consentimiento del contacto en la dirección del grupo de la regla.
Auto-reply text	El mensaje que recibe el contacto de vuelta (por ejemplo, para STOP: “You have been unsubscribed. Reply START to re-subscribe.”). Déjelo en blanco para cambiar el consentimiento en silencio.

La edición es local hasta que usted pulsa Save Rules. Borrar una fila pide confirmación primero, y salir de la página con ediciones sin guardar abre un aviso de descarte — una recarga o una pestaña cerrada usa en su lugar el guardián “leave site?” propio del navegador.

Las etiquetas de idioma son informativas

Una palabra clave reconocida como término de opt-out localizado (STOP, ALTO, STOPPER, SCHLUSS, PARAR, DUR y similares) muestra su idioma y los mercados donde es común — como pista, no como filtro. Una regla para ALTO se comporta exactamente como una regla para STOP y aplica a todo número con capacidad de respuesta.

Una ruta dedicada, no una superposición

Este editor vivía antes dentro de la lista de mensajes SMS — primero apilado sobre la tabla de historial de mensajes, luego como panel deslizante conmutado desde la barra de herramientas de la lista. Ambas formas montaban la gestión de cumplimiento dentro de la vista de operaciones de mensajes, lo que hacía el espacio difícil de leer. El editor es ahora su propia ruta, alcanzada por navegación real desde la barra SMS — la lista de mensajes ya no lo embebe en absoluto. Cuando planee un cambio de disposición así en sus propias integraciones, conserve la misma separación: operaciones de mensajes en una ruta, configuración de cumplimiento en otra.

Dónde aplican las reglas

Un banner en la cima de la página declara el ámbito explícitamente:

En toda la cuenta. Las reglas aplican a respuestas entrantes en todo número con capacidad de respuesta (un código largo o corto que acepta SMS entrantes) de su cuenta. No están atadas a un messaging service, así que no necesita adjuntar uno para que corran.
Por messaging service. Cada servicio mantiene su propia lista de supresión de opt-out, gestionada en el servicio — vea Custom Opt-Out Keyword Lists.
Por número. Una respuesta de palabra clave solo se reconoce en un número con capacidad de respuesta. Un sender ID alfanumérico no puede recibir respuestas, así que el manejo de palabras clave nunca se dispara para esos remitentes. La página muestra cuáles de sus números califican y avisa cuando ninguno califica.

Para el enrutamiento entrante de respuestas que no son palabras clave, vea Inbound SMS routing.

Fusión con el juego STOP/START de la plataforma

Sus reglas son solo aditivas sobre el juego de palabras clave de nivel de plataforma exigido por los carriers. Borrar todas las reglas STOP de la página deja STOP manejado en la capa de plataforma — TCPA y CTIA lo mandan, y Orbit lo impone sin importar lo que configure un tenant. Sus reglas pueden ampliar la superficie de disparo (un alias como CANCELAR, o un opt-in de marca como REJOIN) pero nunca estrecharla.

Valores por defecto sembrados

Al abrir por primera vez, la página siembra un conjunto multilingüe por defecto — STOP / UNSUBSCRIBE / CANCEL / QUIT / END, el español ALTO, el francés STOPPER, el alemán SCHLUSS, el portugués PARAR y el turco DUR / IPTAL / RED, cada uno con una respuesta automática localizada, más emparejamientos de opt-in (START, YES, SUBSCRIBE y los localizados SI / OUI / JA / SIM / EVET). Como los valores por defecto son deterministas, una fila ALTO sembrada aparece en cada espacio hasta que usted la edite y guarde. Pode las filas que su audiencia no usa, o añada alias regionales como reglas nuevas — pero conserve al menos un camino de opt-out por cada idioma en el que envía. Una palabra de opt-out auditada por un regulador es siempre solo un añadido al juego de plataforma; retirar su copia sembrada de ella tampoco hace nada.

Adjuntar y probar

Las reglas aplican automáticamente a todo número con capacidad de respuesta; no hay nada que adjuntar. Para probar que una regla se disparó:

Envíe por texto la palabra clave a uno de sus números con capacidad de respuesta desde un móvil.
La bandeja muestra el turno entrante y la respuesta automática en la misma conversación.
El perfil del contacto muestra el estado de consentimiento volteado, con la palabra clave registrada en el historial de consentimiento; la vista Opt-Outs lista el registro.
El registro de entregas sigue su respuesta automática por queued → sent → delivered.

Antes de apoyarse en una palabra clave en una campaña, envíe un entrante real y confirme que la respuesta automática llega y el estado de consentimiento voltea — la misma disciplina de probar-luego-enviar que la comprobación Test delivery de Sender IDs. El editor mismo siempre muestra si el manejo de palabras clave está operativo: el banner de estado nombra los números elegibles, o avisa con una acción directa Get a number cuando ninguno califica.

Ida y vuelta: suprimir → intentar envío → re-inscribir

Las reglas de palabras clave de arriba cubren el lado entrante — un contacto envía STOP y el consentimiento voltea. Usted puede conducir el mismo ciclo de vida enteramente por la API: suprima un contacto programáticamente, observe el gate de envío rechazar un mensaje a ese contacto, luego re-inscriba al contacto y envíe de nuevo. Esta sección recorre la ida y vuelta completa contra un número de prueba; la referencia Opt-Outs API cubre los parámetros y gates de rol de cada endpoint.

La supresión y el consentimiento son controles del tenant — su cuenta decide qué califica como opt-out, con ámbito a sus propios registros. La única excepción de nivel de plataforma es el manejo de palabras clave STOP/START exigido por carriers descrito arriba, que ningún ajuste de tenant puede retirar.

1. Suprimir el contacto

Cree una fila de opt-out para el teléfono y el canal. El campo contact es un teléfono E.164 (o un e-mail); la plataforma lo resuelve a una fila de contacto existente o crea una fila stub con ámbito a su tenant.

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/contacts/optouts" \
  -H "X-API-Key: dv_test_sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contact": "+14155552671",
    "channel": "sms",
    "reason": "Customer reply STOP"
  }'

La llamada es idempotente — una primera supresión devuelve 201 Created, y reaplicar el mismo opt-out devuelve 200 OK con already_opted_out: true. 201 Created (o 200 OK al reaplicar)

{
  "data": {
    "id": "con_abc",
    "phone": "+14155552671",
    "channel_preferences": {
      "sms": { "opted_out": true }
    },
    "already_opted_out": false,
    "updated_at": "2026-09-12T12:00:00Z"
  },
  "meta": { "request_id": "req_abc123" }
}

Node (vía la escotilla genérica request() del SDK):

import { Orbit } from "@devotel-orbit/node";

const orbit = new Orbit({ apiKey: process.env.ORBIT_API_KEY! });

const { data } = await orbit.request<unknown>("POST", "/contacts/optouts", {
  body: {
    contact: "+14155552671",
    channel: "sms",
    reason: "Customer reply STOP",
  },
});

Python:

from orbit_sdk import OrbitClient

client = OrbitClient.from_env()  # reads ORBIT_API_KEY

res = client.request(
    "POST",
    "/contacts/optouts",
    json={
        "contact": "+14155552671",
        "channel": "sms",
        "reason": "Customer reply STOP",
    },
)

2. Intentar un envío — el gate lo rechaza

Ahora envíe un SMS al número suprimido. El gate de cumplimiento en el camino de envío comprueba la bandera de opt-out del canal antes de que el mensaje se ponga en cola, así que la petición nunca arranca aguas abajo:

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/messages/sms" \
  -H "X-API-Key: dv_test_sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155552671",
    "body": "Hello from the suppression round trip"
  }'

422 Unprocessable Entity

{
  "error": {
    "code": "RECIPIENT_OPTED_OUT",
    "message": "Recipient has opted out of this channel",
    "status": 422,
    "details": { "to": "+14155552671", "channel": "sms" }
  },
  "meta": {
    "request_id": "req_def456",
    "docs_url": "https://docs.orbit.devotel.io/errors/RECIPIENT_OPTED_OUT"
  }
}

Ramifique sobre error.code === "RECIPIENT_OPTED_OUT" en su código remitente y trátelo como autoritativo — reintentar mientras la bandera está puesta devuelve el mismo 422. Registre meta.request_id en cada rechazo; así correlaciona el soporte un rechazo con la traza del lado del servidor. Una cuota consumida por un envío rechazado se reembolsa automáticamente, y los envíos de campaña saltan al destinatario suprimido en vez de rechazar (el lote mantiene en movimiento a los demás destinatarios) mientras registran el salto en la fila del mensaje — vea la referencia Message Status Lifecycle.

3. Retirar la supresión y enviar de nuevo

Borre la fila de opt-out para el id de contacto y el canal — este es el re-opt-in:

cURL

curl -X DELETE "https://api.orbit.devotel.io/api/v1/contacts/optouts/con_abc/sms" \
  -H "X-API-Key: dv_test_sk_YOUR_KEY"

200 OK — devuelve la fila de contacto actualizada y escribe una entrada de auditoría contact.opted_in con el canal. Re-POSTee exactamente el mismo cuerpo de mensaje del paso 2. El gate ahora pasa y el envío se pone en cola: 202 Accepted

{
  "data": {
    "id": "msg_xyz",
    "status": "queued",
    "channel": "sms",
    "to": "+14155552671"
  },
  "meta": { "request_id": "req_ghi789" }
}

Siga la fila de queued → sent → delivered por su id; las transiciones de estado están enumeradas en la página Message Status Lifecycle.

DELETE limpia la supresión solo dentro de Orbit — las channel_preferences del contacto y su lista de supresión. Un carrier de EE. UU./Canadá puede mantener su propio bloque de opt-out independientemente de los registros de Orbit; si un contacto re-inscrito sigue inalcanzable por SMS, resuelva ese bloque por su canal de verificación toll-free / soporte de carrier, no por esta API.

Opt-outs de marca específica

Si un remitente necesita textos de palabras clave de marca o una lista de supresión con ámbito regional, adjunte una lista de opt-out personalizada a su messaging service en vez de editar las reglas globales. Para una página alojada de cara a los contactos donde los destinatarios gestionan sus propias suscripciones, use el Preference center. La API de supresión por contacto ejercitada arriba gestiona el estado de consentimiento que leen esas listas y páginas.

​Reglas de opt-out y opt-in de SMS

​Quién puede abrir la página

​Qué configura cada regla

​Las etiquetas de idioma son informativas

​Una ruta dedicada, no una superposición

​Dónde aplican las reglas

​Fusión con el juego STOP/START de la plataforma

​Valores por defecto sembrados

​Adjuntar y probar

​Ida y vuelta: suprimir → intentar envío → re-inscribir

​1. Suprimir el contacto

​2. Intentar un envío — el gate lo rechaza

​3. Retirar la supresión y enviar de nuevo

​Opt-outs de marca específica

Reglas de opt-out y opt-in de SMS

Quién puede abrir la página

Qué configura cada regla

Las etiquetas de idioma son informativas

Una ruta dedicada, no una superposición

Dónde aplican las reglas

Fusión con el juego STOP/START de la plataforma

Valores por defecto sembrados

Adjuntar y probar

Ida y vuelta: suprimir → intentar envío → re-inscribir

1. Suprimir el contacto

2. Intentar un envío — el gate lo rechaza

3. Retirar la supresión y enviar de nuevo

Opt-outs de marca específica