Verifizierungscodes aus dem Tschad (+235) in den eigenen Stack holen

Wie sieht die Aufrufabfolge für eine Tschad-OTP-API-Anfrage aus?

Anfragen für den Tschad gehen an dieselbe Basis-URL wie in jedem anderen Markt, https://otproute.com/api/v1, signiert mit einem or_live_-Bearer-Schlüssel. Schlüssel erstellen Sie in der Developer-Konsole; ein Konto kann bis zu 10 davon halten und 300 Anfragen pro Minute stellen.

Ein typischer Lauf für den Tschad besteht aus vier Aufrufen:

1. GET /api/v1/countries und GET /api/v1/services, um zu bestätigen, dass td gelistet ist, und die Service-ID Ihres Tests nachzuschlagen.
2. GET /api/v1/prices?country=td&service=<id>, um den Live-Preis für diese Kombination zu lesen, bevor Sie etwas ausgeben.
3. POST /api/v1/activations mit einem Body wie {"service": "telegram", "country": "td"}. Die Antwort enthält eine Aktivierungs-ID und die +235-Nummer, die Sie in die zu testende App eingeben.
4. Warten Sie auf den Code und lassen Sie die Aktivierung dann abschließen oder rufen Sie POST /api/v1/activations/{id}/cancel auf, falls der Test vorzeitig abbricht.

GET /api/v1/balance lohnt sich zu Beginn eines CI-Jobs, damit eine Pipeline bei leerem Guthaben laut scheitert, statt auf halber Strecke in ein Timeout zu laufen. Die vollständige Referenz finden Sie in der Entwicklerdokumentation.

Wie sollte ein Webhook-Empfänger +235-Codes behandeln?

Für ein einzelnes Skript genügt es, GET /api/v1/activations/{id} alle paar Sekunden abzufragen. Sobald mehrere Test-Runner einen Schlüssel teilen, ist ein Webhook sauberer. Registrieren Sie einen Endpunkt (fünf pro Konto) und abonnieren Sie activation.sms_received, activation.expired und activation.cancelled.

Jede Anfrage enthält einen Header X-OTPRoute-Signature der Form t=<unix>,v1=<hex>. Bauen Sie den String <t>.<raw body> nach, signieren Sie ihn mit HMAC-SHA256 und dem Endpunkt-Secret und vergleichen Sie ihn in konstanter Zeit mit v1. Weisen Sie alles zurück, dessen Zeitstempel veraltet ist; das verhindert wiederholt eingespielte Anfragen. Unser Leitfaden zum Absichern von OTP-Webhooks mit HMAC führt durch das Verfahren in mehreren Sprachen.

Behandeln Sie die Aktivierungs-ID als Idempotenzschlüssel. Wird dasselbe Ereignis zweimal zugestellt, darf der zweite Schreibvorgang nichts ändern, und Ihr Handler sollte schnell ein 2xx zurückgeben und langsame Arbeit erst danach erledigen.

Welche Apps können Codes an eine Verifizierungsnummer des Tschad senden?

Die Live-Momentaufnahme für td listet mehr als 1.500 Dienste. Beliebt sind unter anderem WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Viber, imo, Signal, Microsoft & Outlook, LinkedIn, ChatGPT (OpenAI) und AliExpress.

Die Verfügbarkeit ist nicht statisch. Routen öffnen und schließen sich im Tagesverlauf, wenn unsere Carrier-Partner Kapazität verschieben, ein heute Morgen sichtbarer Dienst kann am Nachmittag fehlen. Lesen Sie den Katalog zur Laufzeit, statt ihn fest zu codieren, und halten Sie in Ihrem Testplan einen zweiten Dienst bereit, falls der erste für den Tschad vorübergehend nicht verfügbar ist.

Wie speichere und normalisiere ich eine +235-Nummer?

Der Tschad verwendet einen geschlossenen Nummerierungsplan: Nationale Nummern haben acht Ziffern, und es gibt kein Trunk-Präfix, das entfernt werden müsste, die E.164-Form ist also einfach +235 gefolgt von diesen acht Ziffern. Damit ist der Tschad einer der einfacher zu validierenden Märkte.

• Speichern Sie den vollständigen E.164-String in einer einzigen Spalte, statt Landesvorwahl und Teilnehmernummer zu trennen.
• Akzeptiert Ihr Formular Leerzeichen oder die Gruppierung in Zweierpaaren, die Leute oft eintippen, entfernen Sie diese vor dem Speichern.
• Prüfen Sie in Tests, dass ein Wert mit einer verirrten führenden 0 abgelehnt oder bereinigt wird, denn Nutzer aus anderen Plänen hängen aus Gewohnheit manchmal eine an.

Französisch und Arabisch sind die Amtssprachen. Der Wortlaut einer Verifizierungs-SMS folgt jedoch der Sprache, auf die App oder Konto eingestellt sind, eine Lokalisierungs-Suite sollte daher französische, arabische und englische Vorlagen getrennt prüfen.

Warum führen Produktteams Tests im Tschad durch?

Nur wenige Entwicklungsteams sitzen in N'Djamena, und genau deshalb ist eine entfernte +235-Nummer nützlich. Häufige Gründe, die wir sehen:

• Launches im frankophonen Zentralafrika, bei denen ein Produkt, das in Nachbarmärkten bereits läuft, den Tschad in seine Länderauswahl bei der Registrierung aufnimmt und einen Nachweis braucht, dass der Ablauf funktioniert.
• QA der arabischen und französischen Lokalisierung, einschließlich des Rechts-nach-links-Layouts des Bildschirms zur Codeeingabe.
• Kunden aus der Diaspora, die im Ausland leben, aber eine tschadische Nummer behalten, was beeinflusst, wie Ihre Betrugsregeln die Landesvorwahl bewerten.
• Operations-Teams, die Business-Messaging-Konten für regionale Partner verwalten.

Das übergeordnete Muster beschreibt der Beitrag zum Länder-Routing für OTP.

Was tun, wenn der Tschad-Code nie ankommt?

Eine stumme Nummer ist meist ein Routen- oder Akzeptanzproblem, kein Fehler in Ihrem Code. Gehen Sie in dieser Reihenfolge vor:

• Geben Sie dem 20-Minuten-Fenster die Chance abzulaufen; manche Absender bündeln ihre Nachrichten.
• Prüfen Sie, ob der Zieldienst virtuelle Nummern akzeptiert. Manche tun es nicht, deshalb gibt es die Erstattung.
• Versuchen Sie es später erneut oder mit einem anderen Dienst im selben Land, statt in einer engen Schleife neu zu bestellen. Schnelle Wiederholungen können die eigenen Ratenlimits des Absenders auslösen.
• Bestätigen Sie, dass Ihr Handler die Signatur korrekt geprüft hat; ein abgelehnter Webhook sieht aus wie ein fehlender Code.

Läuft das Fenster ab oder brechen Sie ab, geht der volle Betrag ohne Support-Ticket ans Guthaben zurück. Weitere Taktiken finden Sie unter Fehlgeschlagene OTP-Zustellungen verringern.

Gibt es eine langfristige Leitung für den Tschad, und wie wird sie abgerechnet?

Eine selbst buchbare langfristige Nummer für den Tschad gibt es nicht. Dedicated Numbers sind ein Produkt für die Vereinigten Staaten und Kanada, ab $1.95/Monat, mit ein- und ausgehenden SMS und Telefonie im Browser. Brauchen Sie eine dauerhafte +235-Leitung, schreiben Sie an [email protected]; die Verfügbarkeit hängt von den lokalen Vorschriften ab und können wir nicht versprechen.

Die Kosten für +235-Codes werden von einem einzigen vorausbezahlten USD-Guthaben abgebucht; es gibt keine Abo-Stufe und keine monatliche Gebühr. Aufgeladen wird per Karte oder mit USDT/USDC-Stablecoins, und nach jeder Einzahlung landet eine PDF-Rechnung in Ihrem Posteingang. Aktuelle Preise stehen auf der Preisseite. Für Integrationsarbeit beantragen Sie die Sandbox-Umstellung: Sie liefert simulierte Nummern und Codes, sodass Sie den Ablauf einüben können, ohne das Guthaben anzutasten. Ein neues Konto eröffnen Sie mit einem sechsstelligen E-Mail-Code oder per Google-Anmeldung, falls Ihr Team das bevorzugt.

Häufige Fragen

Wie lautet die Länder-ID für den Tschad in der OTP-Route-API?

Verwenden Sie td im Feld country von POST /api/v1/activations und in der Preisabfrage.

Kann ich den Registrierungsablauf meiner App für den Tschad ohne lokale SIM-Karte testen?

Ja. Bestellen Sie im OTP Gateway eine +235-Nummer, geben Sie sie in Ihrer App ein und lesen Sie den Code im Dashboard, über die API oder per Webhook.

Wie lange bleibt eine +235-Nummer nutzbar?

Eine Aktivierung ist 20 Minuten offen und deckt einen einzelnen Code ab. Danach bestellen Sie eine neue.

Zahle ich, wenn die SMS nie ankommt?

Nein. Kommt vor Ablauf des Fensters keine Nachricht an oder brechen Sie ab, wird der Betrag automatisch Ihrem Guthaben gutgeschrieben.

Muss bei tschadischen Nummern ein Trunk-Präfix entfernt werden?

Nein. Der Tschad hat kein Trunk-Präfix, die gespeicherte Form ist also +235 plus die achtstellige nationale Nummer.

Kann ich eine Nummer des Tschad für spätere Anmeldungen behalten?

Nicht per Self-Service. Langfristige Dedicated Numbers gibt es nur in den USA und Kanada; für den Tschad fragen Sie das Team per E-Mail, was möglich ist.

Gibt es Nutzungsregeln?

Ja. Beachten Sie die Bedingungen jedes Dienstes und die Acceptable Use Policy von OTP Route; das Gateway dient dem Testen und Betreiben Ihrer eigenen legitimen Produkte und Konten.

Dienstnamen sind Marken ihrer jeweiligen Inhaber. OTP Route steht in keiner Verbindung zu ihnen. Nutzen Sie die Nummern rechtmäßig und beachten Sie die Bedingungen des jeweiligen Dienstes sowie unsere Richtlinie zur akzeptablen Nutzung.