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

# Listes de mots-clés opt-out personnalisées

> Configurez dans Orbit des mots-clés STOP, HELP et START spécifiques à une marque avec leurs textes de réponse automatique, puis attachez la liste à un service de messagerie.

# Listes de mots-clés opt-out personnalisées

Chaque locataire Orbit dispose par défaut du traitement STOP / HELP / START imposé par les opérateurs. Une liste opt-out va plus loin lorsque vous envoyez sous plusieurs marques ou dans plusieurs langues : définissez des alias de mots-clés supplémentaires et un texte de réponse automatique personnalisé, puis attachez cette liste au [service de messagerie](/api-reference/messaging-credentials) qui doit l'utiliser. Un service sans liste attachée conserve les valeurs par défaut de la plateforme.

La liste complète des points d'accès se trouve ci-dessous ; cette page couvre les concepts et l'utilisation des champs.

> Original anglais : [Custom Opt-Out Keyword Lists](/guides/opt-out-lists).

## Quand en créer une

Créez une liste opt-out personnalisée lorsque :

* Vous envoyez sous **plusieurs marques** depuis un même compte Orbit et souhaitez que la réponse STOP de chaque marque sonne comme cette marque (« Vous êtes désabonné des alertes Acme Travel. » vs. « Vous êtes désabonné des rappels Acme Pharmacy. »).
* Votre audience écrit dans une **langue ou un dialecte** dont le mot de désinscription n'est pas couvert par les valeurs par défaut — vous pouvez ajouter des alias locaux sans perdre les mots obligatoires.
* Vous voulez un **texte HELP marqué** (« Répondez HELP pour l'assistance, ou appelez le 1-800-… ») au lieu du texte générique par défaut.

## Ce que vous pouvez et ne pouvez pas modifier

Les tableaux de mots-clés par liste sont **uniquement additifs**. Le moteur de correspondance d'Orbit fusionne les mots-clés de votre liste avec l'ensemble par défaut imposé par les opérateurs — vous pouvez élargir la surface de déclenchement (ajouter `"CANCEL"` ou un mot en langue locale en plus de `STOP`) mais vous ne pouvez pas supprimer `STOP` lui-même. TCPA et CTIA l'exigent, et Orbit l'impose au niveau de la plateforme, indépendamment de ce que le locataire configure.

## Créer une liste

```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"
  }'
```

| Champ                                                | Notes                                                                                                                                  |
| ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `label`                                              | Le nom de votre liste, affiché dans le tableau de bord.                                                                                |
| `stop_keywords` / `help_keywords` / `start_keywords` | Jusqu'à 32 entrées chacun, en complément des valeurs par défaut de la plateforme.                                                      |
| `stop_response` / `help_response` / `start_response` | Texte de réponse automatique envoyé lorsque le mot-clé correspondant se déclenche, jusqu'à 1 600 caractères (environ 10 segments SMS). |
| `default_lang`                                       | L'un de `en`, `tr`, `de`, `es`, `fr`, `pt`, `it`, `ar`, `nl`.                                                                          |
| `brand`                                              | Étiquette de marque en texte libre pour votre référence et vos rapports.                                                               |

## Codes de langue pris en charge

Le champ `default_lang` accepte un code ISO 639-1 et détermine la langue du modèle de réponse automatique ainsi que la locale utilisée lorsque la langue du contact entrant est par ailleurs inconnue. La plateforme en prend en charge neuf :

| Code | Langue      |
| ---- | ----------- |
| `en` | Anglais     |
| `tr` | Turc        |
| `de` | Allemand    |
| `es` | Espagnol    |
| `fr` | Français    |
| `pt` | Portugais   |
| `it` | Italien     |
| `ar` | Arabe       |
| `nl` | Néerlandais |

Lorsqu'aucune liste n'est attachée et qu'aucune langue n'est connue, l'ensemble de mots-clés de chaque langue est soumis à une correspondance en cascade — la sur-correspondance d'une réponse opt-out entrante est délibérée (au pire : un message « DUR » légitime traité comme une désinscription ; c'est prudent sur le plan réglementaire).

## Alias courants (par langue)

Ajoutez ces entrées supplémentaires dans le tableau `stop_keywords` (ou `help_keywords` / `start_keywords`) de votre liste lorsque votre audience les utilise. Ce sont des exemples d'ajouts côté locataire ; les valeurs par défaut ci-dessus s'appliquent quoi qu'il arrive.

| Langue      | Alias côté locataire à envisager                        |
| ----------- | ------------------------------------------------------- |
| Turc        | `CIKIS` (variante ASCII), `IPTAL`, `IPTAL ET`, `DURDUR` |
| Allemand    | `ABMELDEN`, `STOPP`, `ABBESTELLEN`, `ENDE`              |
| Français    | `STOP`, `ARRET`, `ARRÊT`, `ANNULER`                     |
| Arabe       | `إلغاء`, `أوقف`, `توقف`, ou l'anglais `STOP`            |
| Néerlandais | `STOPPEN`, `UITSCHRIJVEN`, `OPZEGGEN`                   |
| Espagnol    | `BAJA`, `CANCELAR`, `SALIR`                             |
| Portugais   | `PARAR`, `CANCELAR`, `SAIR`                             |
| Italien     | `FERMA`, `CANCELLA`, `FINE`                             |

La correspondance est insensible à la casse et survit à la normalisation NFC — les accents et les diacritiques s'effondrent sur la même cible de mot-clé, et les espaces internes sont fusionnés avant la comparaison.

## Attacher une liste à un service de messagerie

Une liste ne prend effet qu'une fois attachée à un [service de messagerie](/api-reference/messaging-credentials) — l'identité d'envoi par laquelle une campagne ou un flux envoie réellement :

```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" }'
```

Chaque service de messagerie qui doit utiliser les mêmes mots-clés et textes marqués pointe son `opt_out_list_id` vers la même liste. Détachez-la en définissant `opt_out_list_id` sur `null`, ce qui rétablit les valeurs par défaut de la plateforme pour ce service.

## Listes opt-out vs. listes de suppression vs. opt-outs de contacts

Ce sont trois couches différentes et faciles à confondre :

* **Les listes opt-out (cette page)** configurent *comment une réponse STOP/HELP/START est reconnue et traitée* — la couche de correspondance des mots-clés et de réponse automatique.
* **[Opt-out & listes de suppression](/compliance/opt-out-suppression)** couvrent la liste de suppression en masse côté conformité — l'importation en masse d'adresses qui ne doivent plus jamais être contactées, par exemple lors d'une migration depuis une autre plateforme.
* **[API Opt-Outs](/api-reference/optouts)** est l'enregistrement par contact et par canal de qui s'est réellement désabonné — l'objet contre lequel chaque envoi est vérifié avant l'expédition.

Un ensemble de mots-clés STOP plus large (cette page) augmente le nombre de réponses entrantes *reconnues* comme une désinscription ; le blocage réel se fait via l'enregistrement opt-out du contact qu'il écrit.

## Points d'accès

| Méthode  | Chemin                                 | Objectif                  |
| -------- | -------------------------------------- | ------------------------- |
| `GET`    | `/api/v1/messaging/opt-out-lists`      | Lister vos listes opt-out |
| `POST`   | `/api/v1/messaging/opt-out-lists`      | Créer une liste           |
| `GET`    | `/api/v1/messaging/opt-out-lists/{id}` | Obtenir une liste         |
| `PATCH`  | `/api/v1/messaging/opt-out-lists/{id}` | Mettre à jour une liste   |
| `DELETE` | `/api/v1/messaging/opt-out-lists/{id}` | Supprimer une liste       |

## Voir aussi

* [Opt-Out & Listes de suppression](/compliance/opt-out-suppression) — importation en masse de listes de suppression pour les adresses à ne plus jamais contacter
* [Scrub DNC](/compliance/dnc-scrub) — filtre les contacts contre les registres nationaux de non-appel avant l'envoi de campagne
* [Référence API Opt-Outs](/api-reference/optouts) — enregistrements opt-out par contact
* [Informations d'identification et services de messagerie](/api-reference/messaging-credentials) — attacher une liste via `opt_out_list_id`
* [Services d'envoi SMS](/guides/sms-services) — le service auquel la liste est attachée, de bout en bout