10DLC-Ablehnungen, Re-Vetting und der Nach-Genehmigungs-Lebenszyklus

Der 10DLC-Registrierungsleitfaden endet bei „Versand beginnen”. Dieser Leitfaden behandelt, was danach passiert — eine Ablehnung mit einem kryptischen Code, ein Vetting-Score, der Ihren Durchsatz deckelt, oder eine genehmigte Kampagne, deren Tagesobergrenze nicht mehr zu Ihrem Volumen passt. Alles hier ist eine Kontrolle über Ihre eigenen Registrierungen; Carrier- und Registry-Entscheidungen bleiben deren.

Wo Ablehnungen herkommen

Eine Ablehnung ist eines von zwei Dingen, und der Unterschied entscheidet alles, was Sie als Nächstes tun:

Registry-Ablehnungen (TCR und die CSPs, die ihn proxyen) feuern während oder nach der Registrierungsprüfung — die Einreichung selbst wird verweigert. Diese erscheinen als FAILED-/REJECTED-Statusdatensätze mit einer rejectionReason-Zeichenfolge, an drei Stellen: dem Einstellungen > Compliance > 10DLC-Wizard, einer Dashboard-Benachrichtigung beim terminalen Übergang und dem rejectionReason-Feld auf GET /api/v1/compliance/10dlc/campaigns/:id/status.
Carrier-Ablehnungen (AT&T, T-Mobile) können nach TCR-Genehmigung landen, innerhalb der Carrier-mnoStatuses-Map — ein direktes Carrier-Audit auf der Marke, oder ein Carrier, der mit der CSP-Ebenen-Entscheidung nicht einverstanden ist.

Einige Codes werden vor jeder TCR-Entscheidung emittiert: DUPLICATE-BRAND und der Kleinbuchstaben-usecase-Fehler sind Einreichungszeit-Signale, keine Prüfungsphasen-Ergebnisse. Eine Ablehnung, die der Wizard unmittelbar nach Ihrer Einreichung zeigt, fällt üblicherweise in diese Klasse. Zwei Ablehnungen sperren den Datensatz statt eine Korrektur anzufordern — BRAND-DCA-FAIL und DUPLICATE-BRAND geben eine Fix-Karte mit resubmit_allowed: false zurück, was bedeutet, dass die Marken-ID verbrannt ist und der Fix eine frische Registrierung ist, nicht eine Bearbeitung.

Einen rohen Ablehnungscode in eine Fix-Karte dekodieren

TCR und die CSPs geben Codes wie 30883, 40016 und EIN-MISMATCH mit einer einzeiligen Freitext-Begründung und ohne feldspezifische Korrektur zurück. Die Remediation-Tabelle unter Troubleshooting: 10DLC-Kampagne abgelehnt deckt die gängigen Fälle statisch ab; der Decoder-Endpunkt wendet denselben Katalog auf jeden Code an — einschließlich Formulierungen und Codes, die die Tabelle nicht auflistet. POST /api/v1/compliance/10dlc/decode-rejection Übergeben Sie den rohen code, plus den Freitext-rejectionReason, wenn Sie ihn haben — der Freitext disambiguiert Codes, die auf mehrere Ursachen mappen:

curl -X POST https://api.orbit.devotel.io/api/v1/compliance/10dlc/decode-rejection \
  -H "X-API-Key: $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "30883",
    "free_text": "Sample messages include prohibited SHAFT content"
  }'

Antwort (200 OK):

{
  "data": {
    "code": "30883",
    "title": "Content violation",
    "meaning": "Carrier (typically T-Mobile) determined the sample messages or use case describe content prohibited under 10DLC policy — SHAFT-C, gambling-without-license, loans without a registered FCRA disclosure, or messaging unrelated to the declared vertical.",
    "fix": "Rewrite sample messages to match the declared use case verbatim; remove SHAFT-C wording, shortener domains, and generic 'click here' CTAs. Re-state the opt-in moment in message_flow.",
    "resubmit_allowed": true,
    "category": "content",
    "field": "campaign.sample_message",
    "references": [
      "https://support.twilio.com/hc/en-us/articles/4424803542043",
      "https://www.csptcr.com/wp-content/uploads/2023/03/Campaign-Registry-Common-Rejections.pdf"
    ]
  },
  "meta": {
    "request_id": "req_dec001",
    "timestamp": "2026-09-01T09:00:00Z"
  }
}

Lesen Sie vier Felder von der Karte ab:

fix — der einzelne höchstwahrscheinliche Korrekturschritt, in demselben Register, das der Ablehnungsbanner des Wizards verwendet.
resubmit_allowed — das Urteil, das Ihren nächsten Aufruf entscheidet. true: die Payload korrigieren und dieselbe Marke oder Kampagne erneut einreichen. false: der Datensatz ist gesperrt; eine frische Registrierung starten.
category — ein stabiler Bucket (eligibility, content, identity, throughput, format, dca, unknown) zur Gruppierung in Ihrer eigenen UI.
field — der Wizard-Schritt, auf den sich der Fix bezieht (campaign.sample_message, brand.ein, …), sodass Sie den Operator zum richtigen Formular zurückdeep-linken können.

Der Decoder ist eine reine Regel-Engine — er speichert nichts, erstellt nichts und normalisiert den Code für Sie: TCR-30883, Twilio Error 30883 und ein_mismatch lösen alle zu ihren kanonischen Einträgen auf. Ein nicht erkannter Code gibt eine Karte der Kategorie unknown zurück, deren fix Sie an Devotel-Compliance weiterleitet, sodass eine UI, die die Karte rendert, niemals ein leeres Panel zeigt.

Führen Sie den Decoder aus, bevor Sie Remediation laufen lassen. Wenn der fix der Karte eine Beispielnachricht oder Beschreibung umschreibt, führen Sie die korrigierte Payload durch den Preflight-Linter, bevor Sie erneut einreichen — er erfasst die Sekundär-Ablehnung, die der Fix oft einführt.

Ausgearbeitetes Beispiel: ‘Use-Case-Mismatch’

Ein Kampagnen-Status-Poll gibt zurück:

{
  "data": {
    "campaignId": "C9X27A",
    "status": "FAILED",
    "rejectionReason": "use case mismatch — samples describe promotional traffic filed under CUSTOMER_CARE"
  }
}

Die Begründungszeichenfolge nennt die Ursache, aber keinen TCR-Code. Der Decoder arbeitet mit einem oder dem anderen, also übergeben Sie, was Sie haben — den Freitext allein:

curl -X POST https://api.orbit.devotel.io/api/v1/compliance/10dlc/decode-rejection \
  -H "X-API-Key: $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code": "unknown", "free_text": "use case mismatch"}'

Antwort — die 30898-Karte:

{
  "data": {
    "code": "30898",
    "title": "Use case mismatch with declared vertical",
    "fix": "Either change the brand's vertical to match the actual messaging, or pick a different use case that aligns with the brand identity (MARKETING / MIXED for promotional content).",
    "resubmit_allowed": true,
    "category": "eligibility",
    "field": "campaign.usecase"
  }
}

resubmit_allowed: true sagt korrigieren-und-erneut-einreichen. Reichen Sie jetzt die korrigierte Kampagne gegen dieselbe Marke erneut ein — derselbe Aufruf wie die Ersteinreichung, wie-für-wie erneut eingereicht:

curl -X POST https://api.orbit.devotel.io/api/v1/compliance/10dlc/campaign \
  -H "X-API-Key: $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brand_id": "B4D2E1",
    "usecase": "MARKETING",
    "description": "Acme sends weekend promotional offers to customers who opted in at checkout.",
    "sample_message": [
      "Acme: 20% off today at https://acme.com/sale. Reply STOP to unsubscribe."
    ],
    "message_flow": "Customers opt in at checkout and tick the SMS consent checkbox. Reply STOP to opt out.",
    "help_message": "Reply HELP for assistance or email support@acme.com.",
    "optout_message": "You have been unsubscribed and will receive no further messages."
  }'

Erwarten Sie dieselben 1–5 Werktage wie die Ersteinreichung; pollen Sie den Status-Endpunkt oder beobachten Sie die Dashboard-Benachrichtigung.

Ein zweites ausgearbeitetes Beispiel: ‘SHAFT-Sample’

Dies ist dieselbe Schleife mit einer Inhaltsklasse-Karte. Eine Begründung wie "Sample 2 flagged: SHAFT sample" dekodiert zu 30883 — Inhaltsverstoß — mit resubmit_allowed: true und field: "campaign.sample_message". Schreiben Sie das beanstandete Sample um, um das deklarierte Vertical zu nennen und die verbotene Formulierung zu entfernen, dann reichen Sie die Kampagne wie-für-wie erneut ein. Der Punkt der Schleife: ein Decoder-Aufruf, eine korrigierte Einreichung, und nichts davon hängt davon ab, welche Formulierung TCR zurückgab.

Re-Vet vs. Neuesreichung

Ablehnungen von Inhalten bedeuten Neuesreichung. Ein niedriger Vetting-Score ist ein anderer Blocker — keine Korrektur an einer Kampagnen-Payload repariert ihn, und er deckelt jede Kampagne auf der Marke, nicht nur die unter Prüfung. Der Score entscheidet das Limit, also ist das Mittel ein Re-Vet, nicht eine Neuesreichung. POST /api/v1/compliance/10dlc/brands/:id/revet

curl -X POST https://api.orbit.devotel.io/api/v1/compliance/10dlc/brands/B4D2E1/revet \
  -H "X-API-Key: $ORBIT_API_KEY"

Antwort (200 OK):

{
  "data": {
    "brandId": "B4D2E1",
    "status": "PENDING",
    "provider": "telnyx"
  },
  "meta": {
    "request_id": "req_rev004",
    "timestamp": "2026-09-01T09:30:00Z"
  }
}

provider nennt, welcher Registrar die Marke trägt; status ist der aktualisierte Markenstatus, sobald das Re-Vet startet. Bevor Sie re-veten, vollständigen Sie den Markendatensatz — EIN, rechtlicher Name abgeglichen mit IRS-Aufzeichnungen, Website, Support-E-Mail auf Ihrer eigenen Domain — das Re-Vet bewertet dieselben Informationen erneut, und ein unveränderter Datensatz gibt einen unveränderten Score zurück. Der Registrar ratenlimitiert Re-Vets (einmal sofort nach Registrierung, dann einmal pro ungefähr drei Monate), sodass ein ratenlimitierter Aufruf 422 mit dem Warte-bis-Text des Registrars zurückgibt — lesen Sie ihn, nicht in einer Schleife erneut versuchen.

Durchsatzplanung: Was der Score gewährt

Zwei Endpunkte wandeln den Vetting-Score in die Limits um, unter denen Sie operieren. GET /api/v1/compliance/10dlc/brands/:id/vetting gibt das rohe Ergebnis zurück:

{
  "data": {
    "brandId": "B4D2E1",
    "provider": "telnyx",
    "vettingScore": 78,
    "vettingClass": "PASS",
    "vettedDate": "2026-08-30T12:00:00Z"
  }
}

vettingScore: null bedeutet, der EVP verarbeitet noch — rendern Sie „Ausstehend”, nicht 0. GET /api/v1/compliance/10dlc/brands/:id/throughput leitet die Carrier-zugewiesenen Limits aus diesem Score ab:

curl "https://api.orbit.devotel.io/api/v1/compliance/10dlc/brands/B4D2E1/throughput?entity_type=PRIVATE_PROFIT&sent_today=9800" \
  -H "X-API-Key: $ORBIT_API_KEY"

Antwort (200 OK):

{
  "data": {
    "brandId": "B4D2E1",
    "provider": "telnyx",
    "vettingScore": 78,
    "vettingClass": "PASS",
    "vettedDate": "2026-08-30T12:00:00Z",
    "throughput": {
      "trust_score": 78,
      "provisional": false,
      "entity_type": "PRIVATE_PROFIT",
      "tmobile": {
        "tier": "HIGH",
        "daily_cap": 200000,
        "unlimited": false,
        "label": "High (200k message parts/day)"
      },
      "att": {
        "class": "A",
        "mpm": 600,
        "label": "Class A (600 MPM)"
      }
    },
    "consumption": {
      "daily_cap": 200000,
      "unlimited": false,
      "sent_today": 9800,
      "remaining": 190200,
      "percent_used": 5,
      "status": "ok"
    }
  }
}

att.class — AT&T weist eine Durchsatzklasse pro Kampagne zu, D→C→B→A (15 → 75 → 240 → 600 Nachrichten pro Minute), bei Trust-Score-Stufen 0/25/50/75.
tmobile.tier — T-Mobile weist eine Tagesobergrenzen-Stufe pro Marke zu (2k / 10k / 40k / 200k / unbegrenzt), die jede Kampagne und Nummer auf der Marke abdeckt.
entity_type (optionaler Query-Param) — Sole-Proprietor-Marken sind unabhängig vom Score auf der 2k-Stufe und Klasse D gedeckelt; übergeben Sie den registrierten Entity-Typ, damit die Ableitung den Sonderfall sieht.
sent_today (optionaler Query-Param) — Message-Parts, die im aktuellen rollierenden 24h-Fenster bereits gesendet wurden. Wenn Sie ihn übergeben, meldet consumption Headroom vor der Silent-Filter-Zone: ok unter 80 % der Obergrenze, warning bei 80 %, critical bei 95 %, exceeded bei 100 %.

Beide Query-Params sind optional; consumption ist null, bis Sie sent_today liefern.

Re-Vet, oder die Stufe akzeptieren?

Verwenden Sie die warning-/critical-Schwellwerte als Signal. Wenn Ihr Vordergrundvolumen konsistent im Warnband landet, planen Sie ein Re-Vet — es ist ratenlimitiert, also verbrennen Sie es nur bei einer echten Trajektorienänderung. Wenn die Decke die Tagesobergrenze statt der Klasse ist, ist die Einschränkung pro Marke: Das Zuweisen weiterer Nummern zur Kampagne hebt sie nicht an, aber ein SOLE_PROPRIETOR-Upgrade auf einen vollständigen Markendatensatz tut es — das ist eine Entity-Typ-Änderung, kein Re-Vet.

Neuesreichung, Re-Vet: Was jede kostet

TCR erhebt pro Neuesreichung und pro Re-Vet eine neue Vetting-Gebühr (typischerweise wenige USD), und Carrier behandeln jede Neuesreichung als frische Prüfung — unabhängiges Timing von Ihren vorherigen Versuchen.

Siehe auch

10DLC-Registrierungsleitfaden — Marke → Kampagne → Genehmigung, Use-Case-Codes und die Durchsatzstufen-Tabelle
Troubleshooting: 10DLC-Kampagne abgelehnt — die statische Symptom → Ursache → Fix-Matrix, die der Decoder dieses Leitfadens anwendet
Pre-Submit-Linter — die korrigierte Payload vor der Neuesreichung durch Preflight laufen lassen

Getting Started

Channels

Channels (Voice)

AI Agents

Flows

Numbers & Verify

Concepts

Features

Billing

Webhooks

Security & SSO

Compliance

Legal

Changelog

10DLC-Ablehnungen, Re-Vetting und der Nach-Genehmigungs-Lebenszyklus

10DLC-Ablehnungen, Re-Vetting und der Nach-Genehmigungs-Lebenszyklus

Wo Ablehnungen herkommen

Einen rohen Ablehnungscode in eine Fix-Karte dekodieren

Ausgearbeitetes Beispiel: ‘Use-Case-Mismatch’

Ein zweites ausgearbeitetes Beispiel: ‘SHAFT-Sample’

Re-Vet vs. Neuesreichung

Durchsatzplanung: Was der Score gewährt

Re-Vet, oder die Stufe akzeptieren?

Neuesreichung, Re-Vet: Was jede kostet

Siehe auch

​10DLC-Ablehnungen, Re-Vetting und der Nach-Genehmigungs-Lebenszyklus

​Wo Ablehnungen herkommen

​Einen rohen Ablehnungscode in eine Fix-Karte dekodieren

​Ausgearbeitetes Beispiel: ‘Use-Case-Mismatch’

​Ein zweites ausgearbeitetes Beispiel: ‘SHAFT-Sample’

​Re-Vet vs. Neuesreichung

​Durchsatzplanung: Was der Score gewährt

​Re-Vet, oder die Stufe akzeptieren?

​Neuesreichung, Re-Vet: Was jede kostet

​Siehe auch

10DLC-Ablehnungen, Re-Vetting und der Nach-Genehmigungs-Lebenszyklus

Wo Ablehnungen herkommen

Einen rohen Ablehnungscode in eine Fix-Karte dekodieren

Ausgearbeitetes Beispiel: ‘Use-Case-Mismatch’

Ein zweites ausgearbeitetes Beispiel: ‘SHAFT-Sample’

Re-Vet vs. Neuesreichung

Durchsatzplanung: Was der Score gewährt

Re-Vet, oder die Stufe akzeptieren?

Neuesreichung, Re-Vet: Was jede kostet

Siehe auch