Tunesien (+216): SMS-Verifizierung, eine Checkliste für Entwickler

Was gehört auf die Pre-Flight-Checkliste, bevor ich eine +216-Nummer bestelle?

Gehen Sie diese Liste einmal durch, und die meisten Tunesien-Testläufe verlaufen glatt:

• API-Schlüssel bereit. Erstellen Sie in der Developer-Konsole einen Bearer-Schlüssel; Live-Schlüssel beginnen mit or_live_.
• Guthaben aufgeladen. Das OTP Gateway bucht von Ihrem vorausbezahlten USD-Guthaben ab; GET /api/v1/balance bestätigt es aus einem Skript.
• Webhook erreichbar. Registrieren Sie einen HTTPS-Endpoint, speichern Sie sein Secret und stellen Sie sicher, dass die Uhr Ihres Servers genau geht, damit die Zeitstempelprüfungen bestehen.
• Preis geprüft. Rufen Sie GET /api/v1/prices?country=tn&service=<id> für den Dienst auf, den Sie testen wollen.
• Telefonfeld getestet. Stellen Sie sicher, dass Ihr eigenes Formular eine achtstellige tunesische nationale Nummer und eine eingefügte internationale +216-Nummer akzeptiert.
• Parser tolerant. Bestätigen Sie, dass die Code-Extraktion für arabische, französische und englische Nachrichtentexte funktioniert (siehe unten).
• Bedingungen geprüft. Sie testen Ihr eigenes Produkt oder betreiben Ihr eigenes legitimes Konto, im Einklang mit den Regeln des Dienstes und der Acceptable Use Policy von OTP Route.

Wie werden tunesische Nummern für E.164 formatiert?

Tunesien verwendet einen geschlossenen Nummernplan: Jede Teilnehmernummer hat acht Ziffern, und es gibt kein Trunk-Präfix, sodass vor dem Voranstellen der Landesvorwahl nichts entfernt werden muss. Das E.164-Format ist schlicht +216 gefolgt von diesen acht Ziffern. Einheimische schreiben Nummern oft in Gruppen wie xx xxx xxx; entfernen Sie beim Normalisieren daher Leerzeichen, Punkte und Bindestriche. Validieren Sie nicht gegen eine feste Liste führender Ziffern; die Längenprüfung plus eine anerkannte Telefonbibliothek ist sicherer als eine handgeschriebene Bereichstabelle.

In welchen Sprachen kommen tunesische Verifizierungstexte an?

Arabisch ist Amtssprache, im Alltag spricht man tunesisches Arabisch, und Französisch ist in Wirtschaft, Verwaltung und vielen Apps verbreitet. Dadurch kann ein einzelner Testlauf Codes auf Französisch, Englisch oder Arabisch sehen, je nach Absender und Gerätesprache.

Arabische Nachrichten werden als Unicode-SMS übertragen und können Richtungsmarken für Rechts-nach-links-Text um die Ziffern enthalten. Ein Regex, der die erste Folge von vier bis acht ASCII-Ziffern greift, nachdem unsichtbare Marken entfernt wurden, übersteht alle drei Sprachen. Teams nehmen Tunesien meist in ihre Matrix auf für Launches im französischsprachigen Nordafrika neben Marokko und Algerien, für die Lokalisierungs-QA von Rechts-nach-links-Layouts oder weil sie tunesische Kunden in Europa bedienen; eine +216-Nummer zum Testen deckt jeden dieser Fälle ab.

Schritt für Schritt: eine Tunesien-OTP über die API empfangen

Der Live-Stand listet für Tunesien mehr als 1.700 Dienste, darunter Facebook, WhatsApp, Instagram, Telegram, TikTok, Google (Gmail & YouTube), Snapchat, Signal, LinkedIn, Discord, ChatGPT (OpenAI), Microsoft & Outlook, Amazon und Uber. Die Verfügbarkeit ändert sich im Tagesverlauf; lassen Sie Ihre OTP-Routing-Logik sie daher beim Start eines Laufs aus GET /api/v1/services und GET /api/v1/countries lesen.

1. Senden Sie POST /api/v1/activations mit {"service": "facebook", "country": "tn"} und speichern Sie die Aktivierungs-ID.
2. Geben Sie die zurückgegebene Nummer in der zu testenden App ein und lösen Sie den Code aus.
3. Behandeln Sie activation.sms_received an Ihrem Webhook: Prüfen Sie X-OTPRoute-Signature (HMAC-SHA256 über Zeitstempel, einen Punkt und den Rohtext des Bodys), lehnen Sie alte Zeitstempel ab und ignorieren Sie Duplikate für eine bereits verarbeitete Aktivierungs-ID.
4. Ohne Webhook fragen Sie GET /api/v1/activations/{id} per Polling ab und bleiben dabei deutlich unter dem Limit von 300 Anfragen pro Minute.
5. Rufen Sie POST /api/v1/activations/{id}/cancel auf, falls der Test abgebrochen wird.

Die API-Dokumentation listet jedes Feld, und der CI-Testleitfaden zeigt, wie Sie das in eine Pipeline einbinden.

Schritt für Schritt über das Dashboard

1. Erstellen Sie ein Konto mit Ihrer E-Mail und einem sechsstelligen Code oder per Google-Anmeldung und aktivieren Sie die TOTP-Zwei-Faktor-Authentifizierung.
2. Laden Sie Guthaben per Karte oder USDT/USDC auf.
3. Wählen Sie Tunesien, dann den Dienst, und prüfen Sie den angezeigten Preis.
4. Bestellen Sie, kopieren Sie die +216-Nummer und fordern Sie den Code in der Ziel-App an.
5. Kopieren Sie den tunesischen Code aus dem Dashboard, sobald er erscheint, und schließen Sie die getestete Registrierung ab.

Fehlerbehebung: Was, wenn der +216-Code nie erscheint?

Jede Aktivierung läuft 20 Minuten, und Sie zahlen nur, wenn ein Code ankommt. Läuft das Fenster ab oder stornieren Sie, geht der volle Betrag zurück ins Guthaben.

• Es kam überhaupt nichts an: Lassen Sie das Fenster ablaufen und versuchen Sie es dann später oder, wenn der Test es zulässt, über eine andere Dienstroute erneut.
• Der Dienst hat die Nummer abgelehnt: Manche Dienste lehnen virtuelle Nummern ab; die Erstattung deckt diesen Fall ab.
• Webhook stumm, aber das Dashboard zeigt den Code: Ihre Signaturprüfung schlägt wahrscheinlich fehl; vergleichen Sie gegen den Rohtext des Bodys, nicht gegen neu serialisiertes JSON, und prüfen Sie die Uhrenabweichung.
• Mehrere Fehlschläge in Folge: Bauen Sie einen Back-off ein; Neubestellungen in enger Schleife helfen selten.

Langzeitleitungen, Abrechnung und Sandbox für Tunesien

Eine Self-Service-Langzeitnummer für Tunesien gibt es nicht. Dedicated Numbers sind ein Produkt für die USA und Kanada ab $1.95/month; für eine dauerhafte +216-Leitung schreiben Sie an [email protected] und bedenken dabei, dass die Verfügbarkeit von den lokalen Vorschriften abhängt.

Das Guthaben funktioniert nach Verbrauch ohne Monatsgebühr, und jede Aufladung erhält eine PDF-Rechnung per E-Mail. Entwicklungskonten können den Sandbox-Modus anfordern, in dem simulierte Nummern und Codes die Integration belegen, ohne Guthaben auszugeben.

Häufige Fragen

Kann ich einen tunesischen Registrierungsablauf ohne tunesische SIM testen?

Ja. Nutzen Sie eine +216-Nummer aus dem OTP Gateway und holen Sie den Code im Dashboard oder über die SMS-Verifizierungs-API und Webhooks ab.

Haben tunesische Nummern ein Trunk-Präfix, das entfernt werden muss?

Nein. Tunesische Nummern haben acht Ziffern ohne Trunk-Präfix, das E.164-Format ist also nur +216 plus diese Ziffern.

Wie lautet die Länderkennung der Tunesien-OTP-API?

Verwenden Sie tn in der Preisabfrage und im Request-Body von POST /api/v1/activations.

Was kostet eine Verifizierungsnummer für Tunesien?

Ab $0.20 per code; der genaue Betrag hängt vom Dienst ab und erscheint vor der Bestellung im Dashboard und im Preis-Endpoint. Siehe Preise.

Mein Parser scheitert an arabischen OTP-Nachrichten. Was sollte ich ändern?

Entfernen Sie Unicode-Richtungsmarken und gleichen Sie die Ziffernfolge statt der umgebenden Wörter ab, damit dieselbe Regel für arabische, französische und englische Nachrichtentexte funktioniert.

Kann ich eine +216-Nummer für spätere Anmeldungen behalten?

Nicht per Self-Service. Eine Gateway-Nummer deckt einen einzelnen Code ab, und sofort verfügbare Langzeitleitungen gibt es nur in den USA und Kanada.

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.