​

10DLC-Registrierungs-Wizard

• Speichern und wieder aufnehmen — Ihr Entwurf bleibt über Sitzungen, Tabs und Wochen hinweg erhalten. Schließen Sie den Tab oder kommen Sie morgen zurück; Sie setzen dort fort, wo Sie aufgehört haben.
• Zwischen Schritten nicht-linear wechseln — der Wizard verfolgt brand, campaign und review als unabhängige Schritte. Füllen Sie die Kampagnen-Samples aus, während der Markenabschnitt noch unvollständig ist, und die Fortschritts-Payload hält beide Zähler.
• Vor dem Zahlen validieren — feldspezifische Validierung feuert bei jedem Speichern, und ein Pre-Submission-Lint-Durchlauf bewertet den gespeicherten Entwurf gegen bekannte TCR-Ablehnungsmuster, bevor die Upstream-Registrierungsgebühr fällig wird.

​

Rollen und Ratenlimits

• Lesen (GET /wizard, GET /wizard/draft) — jede authentifizierte Rolle in der Organisation.
• Schreiben (PUT /wizard/draft, DELETE /wizard/draft, POST /wizard/phone/send, POST /wizard/phone/confirm, POST /wizard/preflight, POST /wizard/submit) — Owner- oder Admin-Rolle.
• Schreibprofil: 10 Anfragen pro Minute, entsprechend den Legacy-Marken/Kampagnen-Endpunkten. Wizard-Preflight: 30 Anfragen pro Minute, entsprechend dem Ad-hoc-Preflight-Endpunkt.

​

GET /10dlc/wizard — Fortschritts-Payload

curl https://api.orbit.devotel.io/api/v1/compliance/10dlc/wizard \
  -H "X-API-Key: dv_live_sk_your_key_here"

{
  "data": {
    "state": "in_progress",
    "current_step": "campaign",
    "brand": {
      "completed_fields": 10,
      "total_fields": 10,
      "missing_fields": []
    },
    "campaign": {
      "completed_fields": 4,
      "total_fields": 6,
      "missing_fields": ["message_flow", "optout_message"]
    },
    "next_action": "fill_campaign"
  },
  "meta": {
    "request_id": "req_wiz001",
    "timestamp": "2026-09-02T10:00:00Z"
  }
}

​

PUT /10dlc/wizard/draft — Teilspeichern

curl -X PUT https://api.orbit.devotel.io/api/v1/compliance/10dlc/wizard/draft \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "brand": {
      "entity_type": "PRIVATE_PROFIT",
      "display_name": "Acme Corp",
      "company_name": "Acme Corporation Inc.",
      "email": "compliance@acme.com"
    },
    "current_step": "brand"
  }'

​

Sole-Proprietor-Telefonverifizierung (OTP)

# 1. Die Challenge an das brand.phone des Entwurfs senden
curl -X POST https://api.orbit.devotel.io/api/v1/compliance/10dlc/wizard/phone/send \
  -H "X-API-Key: dv_live_sk_your_key_here"

{
  "data": {
    "verification_id": "vf_abc123",
    "status": "pending",
    "channel": "sms",
    "expires_at": "2026-09-02T10:10:00Z"
  },
  "meta": {
    "request_id": "req_wiz002",
    "timestamp": "2026-09-02T10:00:00Z"
  }
}

# 2. Den Code aus der SMS bestätigen
curl -X POST https://api.orbit.devotel.io/api/v1/compliance/10dlc/wizard/phone/confirm \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"code": "483921"}'

{
  "data": {
    "status": "verified",
    "phone": "+14155551234",
    "verified_at": "2026-09-02T10:04:12Z"
  },
  "meta": {
    "request_id": "req_wiz003",
    "timestamp": "2026-09-02T10:04:12Z"
  }
}

​

POST /10dlc/wizard/preflight — Den gespeicherten Entwurf linten

curl -X POST https://api.orbit.devotel.io/api/v1/compliance/10dlc/wizard/preflight \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

​

POST /10dlc/wizard/submit — Atomare Marke + Kampagne

curl -X POST https://api.orbit.devotel.io/api/v1/compliance/10dlc/wizard/submit \
  -H "X-API-Key: dv_live_sk_your_key_here"

{
  "data": {
    "state": "brand_pending",
    "current_step": "review",
    "brand_id": "BXXXXXX",
    "campaign_id": "CXXXXXX",
    "next_action": "done"
  },
  "meta": {
    "request_id": "req_wiz004",
    "timestamp": "2026-09-02T10:05:00Z"
  }
}

• Marke upstream abgelehnt — keine Kampagne wird eingereicht. Der Entwurf bleibt mit dem Markenablehnungsgrund gestempelt erhalten, und next_action wechselt auf amend_brand. Korrigieren Sie die Markenfelder und reichen Sie erneut ein.
• Kampagne upstream abgelehnt — die akzeptierte brand_id wird persistiert, der Zustand bleibt bei brand_pending, und der Kampagnenablehnungsgrund wird gestempelt. Eine Neuesreichung überspringt die Markenstufe komplett, sodass die Markengebühr niemals erneut belastet wird; nur die Kampagne zahlt wieder.
• Upstream 5xx oder Provider nicht verfügbar — der Entwurf bleibt verbatim erhalten, und Sie können ihn so erneut versuchen.

​

DELETE /10dlc/wizard/draft — Zurücksetzen

curl -X DELETE https://api.orbit.devotel.io/api/v1/compliance/10dlc/wizard/draft \
  -H "X-API-Key: dv_live_sk_your_key_here"

​

Vollständiger Lebenszyklus

1. PUT /10dlc/wizard/draft — Marke + Kampagne progressiv füllen.
2. (nur SOLE_PROPRIETOR) POST /10dlc/wizard/phone/send → POST /10dlc/wizard/phone/confirm.
3. POST /10dlc/wizard/preflight — Befunde beheben, bis das Urteil durchgeht.
4. POST /10dlc/wizard/submit — atomare Einreichung.
5. GET /10dlc/wizard — Zustand pollen bis ready (oder GET /10dlc/campaigns/:id/status für die Carrier-Map, wie auf der Registrierungsseite).
6. DELETE /10dlc/wizard/draft — optionales Nach-Genehmigungs-Aufräumen.