> ## 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. # Barrière TCPA des plaideurs connus > Activez la vérification de la provenance du destinataire qui bloque les envois SMS/MMS vers les numéros figurant sur la liste de la plateforme des plaideurs professionnels TCPA, avec une piste d'audit du contournement consenti et un mode de défaillance ouvert (fail-open). # Barrière TCPA des plaideurs connus Les opérateurs américains et les services du secteur (Numeracle, Blacklist Alliance, DNC.com) maintiennent des listes de **plaignants professionnels** — des destinataires qui déposent des plaintes TCPA contre les expéditeurs à titre commercial. Un seul SMS A2P non consenti vers l'un d'eux coûte de 500 $à 1 500$ par message en vertu du 47 U.S.C. § 227(b)(3). La barrière des plaideurs connus d'Orbit bloque ces envois avant leur expédition. La barrière est délibérément limitée au **trafic SMS et MMS américain (+1, NANP)** — le TCPA est une loi américaine, et les SMS/MMS sont les canaux qui la déclenchent. Le trafic vocal comporte sa propre barrière de fenêtre de composition TCPA ; voir [Barrières d'envoi](/compliance/send-gates). Il s'agit d'un contrôle de risque locataire auquel vous adhérez, et non d'un filtrage de plateforme. La barrière ne s'applique au chemin d'envoi que lorsque votre organisation l'active, et elle réduit (sans l'éliminer) votre exposition aux dépositaires de plaintes TCPA en série. Ceci ne constitue pas un avis juridique — confirmez vos obligations TCPA auprès d'un conseil juridique. *** ## Comment la vérification se résout Chaque envoi d'une organisation activée résout le destinataire selon une chaîne en couches, la moins coûteuse d'abord : 1. **Marquage préalable du contact** — si une importation en lot a déjà estampillé le drapeau `is_tcpa_litigator` du contact, la recherche est entièrement ignorée et l'envoi se résout comme marqué sans toucher au réseau ni au cache. Un calcul par importation, pas par envoi. 2. **Cache Redis** — un verdict mis en cache d'une recherche précédente. 3. **Recherche Numeracle en direct** — utilisée lorsque l'opérateur a configuré la clé Numeracle (le SaaS hébergé d'Orbit la définit pour vous). 4. **Graine statique (seed)** — la liste des plaideurs intégrée à la plateforme, utilisée en dernier recours lorsque la recherche en direct est indisponible. Chaque verdict rapporte sa `source` dans la piste d'audit et la surface de recherche admin, afin de distinguer un succès en cache d'un succès en direct. Les **remplacements manuels administrateurs** vivent dans la même couche de cache, de sorte qu'un marquage forcé ou un démarquage forcé persiste entre les recherches. Voir [Remplacements manuels admin](#admin-manual-overrides) ci-dessous. *** ## Activer la barrière La barrière est **désactivée par défaut**. Elle est livrée désactivée pour les opérateurs non américains : une vérification TCPA américaine sur du trafic qui ne touche jamais de destinataires +1 ajoute de la latence de recherche et du bruit d'audit sans bénéfice. Activez-la par organisation en définissant `tcpa_check_enabled` dans vos paramètres généraux : ```bash theme={null} curl -X PUT "https://api.orbit.devotel.io/api/v1/settings/general" \ -H "Authorization: Bearer $ORBIT_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "settings": { "tcpa_check_enabled": true } }' ``` Tant que le drapeau n'est pas `true`, chaque envoi ignore entièrement la chaîne. La valeur `false` (ou l'absence de la clé) signifie désactivé. Les paramètres de conformité du tableau de bord exposent le même commutateur. Les appels vocaux ne sont pas filtrés par cette vérification. La portée est les envois `sms` et `mms` vers des destinations `+1`. Pour étendre le filtrage des plaideurs à la voix sortante, utilisez la surface de remplacement manuel admin ci-dessous ou filtrez les destinataires avant une campagne avec la recherche admin. *** ## À quoi ressemble un envoi bloqué Un envoi bloqué lève `403 TCPA_KNOWN_LITIGATOR_BLOCKED` (l'ancien nom `MESSAGING_TCPA_KNOWN_LITIGATOR` a été remplacé). Le corps de la réponse : ```json theme={null} { "error": { "code": "TCPA_KNOWN_LITIGATOR_BLOCKED", "message": "Recipient is on the TCPA known-litigator list and has not given verifiable consent. Confirm consent in writing before sending, OR remove the recipient from the campaign.", "status": 403, "details": { "to": "+1415****", "channel": "sms", "source": "numeracle", "score": 92 } } } ``` Le blocage est résolu **avant** la facturation, donc un envoi bloqué ne facture jamais. `details.source` vous indique quelle couche a marqué le destinataire (`contact_flag`, `cache`, `numeracle`, `seed` ou `manual_override`). Lorsque la barrière a un score de confiance de Numeracle, il passe dans `details.score` (0–100, plus le score est élevé, plus le risque l'est). ### Destinations non américaines Les destinataires non `+1` qui correspondent à la liste reçoivent un **avertissement souple** plutôt qu'un blocage strict : l'envoi se poursuit, un fil d'Ariane Sentry et une entrée d'audit `messages.tcpa_litigator_soft_warn` enregistrent le marquage, et vous pouvez le revoir après coup. La portée du blocage strict du TCPA se limite au NANP. *** ## Contournement consenti Si le destinataire a un enregistrement de consentement `opted_in` pour le même canal, la barrière **autorise l'envoi** — mais écrit une entrée d'audit (`messages.tcpa_litigator_consented_bypass`) plus un fil d'Ariane Sentry afin que votre équipe de conformité puisse revoir la décision après coup. L'entrée d'audit comporte le destinataire (masqué), le canal, la source du marquage et le score. Les envois bloqués écrivent plutôt des entrées `messages.tcpa_litigator_blocked`. Interrogez l'une ou l'autre classe depuis la console Admin ou votre puits SIEM. *** ## Mode de défaillance : fail-open Une panne du cache Redis, de la sonde de base de données ou de l'API Numeracle ne bloque **pas** vos envois. La chaîne intercepte la faute, journalise un avertissement, la capture dans Sentry et traite le destinataire comme non marqué — l'envoi passe. C'est délibéré : une panne de pré-vérification TCPA ne doit jamais faire trou noir à toute la messagerie sortante. Si vous préférez échouer fermé (p. ex. pendant une plainte active), désactivez le commutateur et reposez-vous sur la surface de remplacement manuel admin — marquez de force les numéros affectés afin qu'ils bloquent sans dépendre de la disponibilité d'une recherche amont. *** ## Remplacements manuels admin Le personnel de la plateforme gère la liste elle-même par la surface super-admin (`/dashboard/tcpa-litigators`) : * `GET /admin/compliance/tcpa-litigators/seed` — l'enveloppe de la graine statique (source, nombre d'entrées, dernière mise à jour). * `GET /admin/compliance/tcpa-litigators/lookup?phone=…` — exécute la chaîne en direct sur un numéro pour déboguer une plainte. * `POST /admin/compliance/tcpa-litigators/override` — marque de force ou démarque de force un numéro (persiste entre les recherches jusqu'à suppression). * `DELETE /admin/compliance/tcpa-litigators/override/:phone` — supprime un remplacement. * `GET /admin/compliance/tcpa-litigators/overrides` — liste les remplacements actifs avec provenance (qui, quand, pourquoi). * `POST /admin/compliance/tcpa-litigators/diff` + `/merge` — importe en lot un CSV de marquages. * `GET /admin/compliance/tcpa-litigators/match-stats` — comptes horaires des blocages / contournements consentis / avertissements souples pour la graphique en sparkline. Toutes sont réservées au super-admin et journalisées en audit. *** ## Connexes * [Barrières d'envoi](/compliance/send-gates) — les heures de silence, DNC, RND, RMD et l'arrêt d'urgence s'exécutent aux côtés de cette barrière au moment de l'envoi. * [Balayage DNC](/compliance/dnc-scrub) — la pré-vérification Do-Not-Call par rapport à vos propres listes et aux registres nationaux. * [Gestion du consentement](/compliance/consent-management) — les enregistrements de consentement que le contournement lit. * [Codes d'erreur](/reference/error-codes) — la ligne `TCPA_KNOWN_LITIGATOR_BLOCKED` avec le format complet de la charge utile.