​

Listes de désinscription et de suppression

​

Comment se produit la suppression

• Un contact répond avec un mot-clé STOP sur SMS/WhatsApp.
• Un contact se désinscrit via le centre de préférences.
• Vous enregistrez une désinscription via l’API de consentement (opt_in: false).
• Vous importez en masse une liste (cette page).

• L’import CSV en masse déduit la portée du type d’adresse de chaque ligne : les adresses téléphoniques et WhatsApp prennent par défaut la portée all — un signal STOP sur un numéro de téléphone supprime tous les canaux joignables sur ce numéro — tandis que les adresses e-mail sont limitées à email. Une colonne channel remplace cette valeur par ligne (voir Import CSV en masse).
• L’API de consentement et le centre de préférences suppriment toujours avec la portée all, que l’identifiant enregistré soit un numéro de téléphone ou une adresse e-mail. Une désinscription via l’un de ces points d’entrée retire le contact de tous les canaux.

​

Import CSV en masse

curl -X POST https://api.orbit.devotel.io/api/v1/compliance/suppression-list/import \
  -H "Authorization: Bearer $ORBIT_API_KEY" \
  -F "file=@suppressions.csv" \
  -F "default_country=US" \
  -F "default_reason=migrated_from_legacy_platform" \
  -F "dry_run=false"

​

Champs du formulaire

​

Format du CSV

phone,email,reason
+14155550101,,replied STOP
,jordan@example.com,unsubscribed via email
+442071838750,sam@example.co.uk,complaint

​

Résultats par ligne

{
  "data": {
    "run_id": "supimp_4d…",
    "total_rows": 1000,
    "accepted": 950,
    "duplicates": 30,
    "intra_file_duplicates": 15,
    "invalid": 5,
    "errors": [
      { "status": "invalid", "reason": "invalid_phone", "raw_line": 42 }
    ],
    "by_channel": { "all": 800, "email": 150 },
    "file_sha256": "9b2e…"
  },
  "meta": { "request_id": "…", "timestamp": "2026-06-08T12:00:00.000Z" }
}

​

Raisons de validation

​

Limites

​

En cas d’échec de l’import

​

Import depuis le tableau de bord

1. Choose CSV file — choisissez un .csv de moins de 25 Mo. Utilisez Download sample CSV dans la boîte de dialogue pour un fichier de départ préformaté.
2. Set defaults (optional) — un Default country (ISO alpha-2) pour normaliser les numéros au format national, et un Reason en texte libre apposé sur chaque ligne acceptée.
3. Preview — exécute l’import en dry run côté serveur : rien n’est écrit, et la boîte de dialogue affiche la répartition acceptées / déjà listées / répétées dans le fichier / invalides avant que vous ne validiez.
4. Confirm import — effectue l’écriture définitive. Si des lignes étaient invalides, téléchargez skipped.csv pour les corriger et les réimporter.

​

Exporter la liste de suppression

curl "https://api.orbit.devotel.io/api/v1/compliance/suppression-list/export?format=csv&status=active" \
  -H "Authorization: Bearer $ORBIT_API_KEY" \
  -o suppression-list.csv

​

Vérifier qu’une suppression a pris effet

1. Envoyez un message de test à l’adresse supprimée. Un envoi API direct vers un destinataire supprimé échoue de façon synchrone avec HTTP 422 et le code d’erreur RECIPIENT_OPTED_OUT. En mode sandbox, aucun opérateur n’est touché et aucun solde n’est débité ; tout destinataire se terminant par 8 se résout aussi vers l’accusé de livraison simulé blocked, qui est la vue côté opérateur de la même barrière.
   curl -X POST https://api.orbit.devotel.io/api/v1/messages/sms \
     -H "X-API-Key: $ORBIT_SANDBOX_KEY" \
     -H "Content-Type: application/json" \
     -d '{"to": "+14155550101", "from": "+15005550101", "body": "gate check"}'
   
   {
     "error": {
       "code": "RECIPIENT_OPTED_OUT",
       "message": "Recipient has opted out of this channel"
     }
   }
   
   Un envoi de campagne vers la même adresse se comporte différemment par conception : le destinataire est ignoré silencieusement (status: "skipped", reason: "opted_out") pour que le lot continue — consultez le rapport par destinataire de la campagne plutôt que d’attendre une erreur.
2. Confirmez que l’entrée figure dans le registre. Exportez avec la requête ci-dessus (status=active est la valeur par défaut) et vérifiez que l’adresse apparaît avec la portée channel attendue. L’export est la source de vérité que chaque porte d’envoi lit — si la ligne y est active, la barrière est levée.

​

Levée d’une suppression (ré-opt-in)

​

Références associées

• Consent Management — enregistrer et consulter le consentement par canal.
• Send Gates — heures de silence, DNC, RND, RMD, arrêt d’urgence et centre de préférences.
• DSAR — comment les requêtes delete / opt_out aboutissent à la suppression.
• API Reference → Opt-outs — schémas des endpoints de désinscription et de suppression.