> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbit.devotel.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Listas de palabras clave de exclusión personalizadas

> Configure palabras clave STOP, HELP y START por marca en Orbit con su texto de respuesta automática, y vincule la lista a un servicio de mensajería.

# Listas de palabras clave de exclusión personalizadas

Cada inquilino de Orbit obtiene el procesamiento STOP / HELP / START exigido por los operadores desde el primer momento. Una lista de exclusión va más allá cuando envía bajo más de una marca o en más de un idioma: defina alias de palabras clave adicionales y texto de respuesta automática personalizado, y vincule esa lista al [servicio de mensajería](/api-reference/messaging-credentials) que debería usarla. Un servicio sin lista vinculada conserva los valores predeterminados de la plataforma.

La lista completa de puntos de conexión aparece a continuación; esta página cubre los conceptos y cómo se usan los campos.

> Original en inglés: [Custom Opt-Out Keyword Lists](/guides/opt-out-lists).

## Cuándo necesita una

Use una lista de exclusión personalizada cuando:

* Envíe bajo **varias marcas** desde una cuenta de Orbit y quiera que la respuesta STOP de cada marca suene como esa marca («Ha cancelado las alertas de Acme Travel.» vs. «Ha cancelado los recordatorios de Acme Pharmacy.»).
* Su audiencia escribe en un **idioma o dialecto** cuya palabra de exclusión no está cubierta por los valores predeterminados — puede añadir alias locales sin perder las obligatorias.
* Quiere **texto HELP personalizado** («Responda HELP para soporte, o llame al 1-800-…») en lugar del genérico por defecto.

## Qué puede y qué no puede cambiar

Los arrays de palabras clave por lista son **solo aditivos**. El comparador de Orbit fusiona las palabras clave de su lista con el conjunto predeterminado exigido por los operadores — puede ampliar la superficie de activación (añadir `"CANCEL"` o una palabra en idioma local junto a `STOP`) pero no puede eliminar `STOP` en sí. TCPA y CTIA lo exigen, y Orbit lo impone a nivel de plataforma independientemente de lo que configure el inquilino.

## Crear una lista

```bash theme={null}
curl -X POST https://api.orbit.devotel.io/api/v1/messaging/opt-out-lists \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Acme Travel — ES",
    "stop_keywords": ["BAJA", "CANCELAR"],
    "help_keywords": ["AYUDA"],
    "stop_response": "Has cancelado las alertas de Acme Travel. Responde AYUDA para soporte.",
    "help_response": "Acme Travel: responde BAJA para cancelar, o llama al 1-800-555-0100.",
    "default_lang": "es",
    "brand": "Acme Travel"
  }'
```

| Campo                                                | Notas                                                                                                                    |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `label`                                              | El nombre de su lista, mostrado en el panel.                                                                             |
| `stop_keywords` / `help_keywords` / `start_keywords` | Hasta 32 entradas cada uno, aditivas a los valores predeterminados de la plataforma.                                     |
| `stop_response` / `help_response` / `start_response` | Texto de respuesta automática enviado cuando se activa la palabra clave, hasta 1.600 caracteres (unos 10 segmentos SMS). |
| `default_lang`                                       | Uno de `en`, `tr`, `de`, `es`, `fr`, `pt`, `it`, `ar`, `nl`.                                                             |
| `brand`                                              | Etiqueta de marca en texto libre para su propia referencia e informes.                                                   |

## Códigos de idioma admitidos

El campo `default_lang` acepta un código ISO 639-1 y determina el idioma de la plantilla de respuesta automática, además de la configuración regional usada cuando el idioma del contacto entrante es desconocido. La plataforma admite nueve:

| Código | Idioma     |
| ------ | ---------- |
| `en`   | Inglés     |
| `tr`   | Turco      |
| `de`   | Alemán     |
| `es`   | Español    |
| `fr`   | Francés    |
| `pt`   | Portugués  |
| `it`   | Italiano   |
| `ar`   | Árabe      |
| `nl`   | Neerlandés |

Cuando no hay lista vinculada y se desconoce el idioma, el conjunto de palabras clave de cada idioma se revisa en cascada: la sobrerrevisión de una respuesta de exclusión entrante es intencional (peor de los casos: un mensaje legítimo de "DUR" tratado como exclusión; eso es regulatoriamente seguro).

## Alias comunes (por idioma)

Añada estas entradas adicionales al array `stop_keywords` (o `help_keywords` / `start_keywords`) de su lista cuando su audiencia las use. Son ejemplos de adiciones del inquilino; los valores predeterminados anteriores se aplican siempre.

| Idioma     | Alias del inquilino a considerar                        |
| ---------- | ------------------------------------------------------- |
| Turco      | `CIKIS` (variante ASCII), `IPTAL`, `IPTAL ET`, `DURDUR` |
| Alemán     | `ABMELDEN`, `STOPP`, `ABBESTELLEN`, `ENDE`              |
| Francés    | `STOP`, `ARRET`, `ARRÊT`, `ANNULER`                     |
| Árabe      | `إلغاء`, `أوقف`, `توقف`, o inglés `STOP`                |
| Neerlandés | `STOPPEN`, `UITSCHRIJVEN`, `OPZEGGEN`                   |
| Español    | `BAJA`, `CANCELAR`, `SALIR`                             |
| Portugués  | `PARAR`, `CANCELAR`, `SAIR`                             |
| Italiano   | `FERMA`, `CANCELLA`, `FINE`                             |

La coincidencia es insensible a mayúsculas y sobrevive a la normalización NFC: los acentos y diacríticos colapsan en el mismo destino de palabra clave, y los espacios internos se colapsan antes de la comparación.

## Vincular una lista a un servicio de mensajería

Una lista solo surte efecto cuando se vincula a un [servicio de mensajería](/api-reference/messaging-credentials) — la identidad de envío por la que realmente se envía una campaña o flujo:

```bash theme={null}
curl -X PATCH https://api.orbit.devotel.io/api/v1/messaging/services/msvc_abc123 \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "opt_out_list_id": "ool_abc123" }'
```

Cada servicio de mensajería que debería usar las mismas palabras clave y copia de marca apunta su `opt_out_list_id` hacia la misma lista. Desvincúlela estableciendo `opt_out_list_id` en `null`, lo que restaura los valores predeterminados de la plataforma para ese servicio.

## Listas de exclusión vs. listas de supresión vs. exclusiones de contacto

Estas son tres capas distintas, fáciles de confundir:

* **Las listas de exclusión (esta página)** configuran *cómo se reconoce y responde una respuesta STOP/HELP/START* — la capa de coincidencia de palabras clave y respuesta automática.
* **[Exclusión y listas de supresión](/compliance/opt-out-suppression)** cubren la lista de supresión masiva del lado de cumplimiento: importación masiva de direcciones a las que nunca más se debe enviar, p. ej. al migrar desde otra plataforma.
* **[API de Exclusiones](/api-reference/optouts)** es el registro por contacto y por canal de quién se ha dado de baja realmente — contra lo que se verifica cada envío antes de la entrega.

Un conjunto más amplio de palabras clave STOP (esta página) aumenta cuántas respuestas entrantes se *reconocen* como exclusión; el bloqueo real ocurre a través del registro de exclusión del contacto que escribe.

## Puntos de conexión

| Método   | Ruta                                   | Propósito                      |
| -------- | -------------------------------------- | ------------------------------ |
| `GET`    | `/api/v1/messaging/opt-out-lists`      | Listar sus listas de exclusión |
| `POST`   | `/api/v1/messaging/opt-out-lists`      | Crear una lista                |
| `GET`    | `/api/v1/messaging/opt-out-lists/{id}` | Obtener una lista              |
| `PATCH`  | `/api/v1/messaging/opt-out-lists/{id}` | Actualizar una lista           |
| `DELETE` | `/api/v1/messaging/opt-out-lists/{id}` | Eliminar una lista             |

## Véase también

* [Exclusión y Listas de Supresión](/compliance/opt-out-suppression) — importación masiva de listas de supresión para direcciones que nunca deben ser contactadas
* [Scrub DNC](/compliance/dnc-scrub) — filtra contactos contra registros nacionales de No Llamar antes del envío de la campaña
* [Referencia API de Exclusiones](/api-reference/optouts) — registros de exclusión por contacto
* [Credenciales y servicios de mensajería](/api-reference/messaging-credentials) — vincular una lista vía `opt_out_list_id`
* [Servicios de envío SMS](/guides/sms-services) — el servicio al que se vincula la lista, de extremo a extremo