Verifica SMS Tunisia (+216): una checklist per sviluppatori

Cosa deve contenere la checklist pre-volo prima di ordinare un numero +216?

Ripercorri questo elenco una volta e la maggior parte delle esecuzioni di test sulla Tunisia andrà liscia:

• Chiave API pronta. Crea una chiave Bearer nella Developer console; le chiavi live iniziano con or_live_.
• Portafoglio finanziato. L'OTP Gateway attinge dal tuo saldo USD prepagato; GET /api/v1/balance lo conferma da uno script.
• Webhook raggiungibile. Registra un endpoint HTTPS, conserva il suo secret e verifica che l'orologio del server sia preciso perché i controlli sui timestamp passino.
• Prezzo controllato. Chiama GET /api/v1/prices?country=tn&service=<id> per il servizio esatto che intendi testare.
• Campo telefono testato. Assicurati che il tuo modulo accetti un numero nazionale tunisino di otto cifre e uno internazionale +216 incollato.
• Parser tollerante. Conferma che l'estrazione del codice funzioni con messaggi in arabo, francese e inglese (vedi sotto).
• Termini verificati. Stai testando il tuo prodotto o gestendo il tuo account legittimo, nel rispetto delle regole del servizio e dell'Acceptable Use Policy di OTP Route.

Come si formattano i numeri tunisini in E.164?

La Tunisia usa un piano di numerazione chiuso: ogni numero di abbonato ha otto cifre e non esiste prefisso interurbano, quindi non c'è nulla da eliminare prima di aggiungere il prefisso internazionale. La forma E.164 è semplicemente +216 seguito da quelle otto cifre. Gli abitanti scrivono spesso i numeri in gruppi come xx xxx xxx, quindi rimuovi spazi, punti e trattini durante la normalizzazione. Evita di validare rispetto a un elenco fisso di cifre iniziali; il controllo della lunghezza insieme a una libreria di telefonia affidabile è più sicuro di una tabella di intervalli scritta a mano.

In quali lingue arrivano i messaggi di verifica tunisini?

L'arabo è la lingua ufficiale, l'arabo tunisino è quello parlato ogni giorno e il francese è diffuso negli affari, nell'amministrazione e in molte app. Di conseguenza una sola esecuzione di test può vedere codici in francese, inglese o arabo a seconda del mittente e delle impostazioni locali del dispositivo.

I messaggi in arabo viaggiano come SMS Unicode e possono contenere indicatori di direzione da destra a sinistra attorno alle cifre. Una regex che prende la prima sequenza di quattro-otto cifre ASCII, dopo aver rimosso i segni invisibili, regge tutte e tre le lingue. I team aggiungono di solito la Tunisia alla loro matrice per i lanci nel Nord Africa francofono insieme al Marocco e all'Algeria, per il QA di localizzazione dei layout da destra a sinistra, oppure perché servono clienti tunisini che vivono in Europa; un numero +216 per i test copre ognuno di questi casi.

Passo dopo passo: ricevere un OTP della Tunisia tramite API

L'istantanea in tempo reale elenca più di 1.700 servizi per la Tunisia, tra cui Facebook, WhatsApp, Instagram, Telegram, TikTok, Google (Gmail e YouTube), Snapchat, Signal, LinkedIn, Discord, ChatGPT (OpenAI), Microsoft & Outlook, Amazon e Uber. La disponibilità cambia durante la giornata, quindi lascia che sia la tua logica di instradamento OTP a leggerla da GET /api/v1/services e GET /api/v1/countries all'avvio di un'esecuzione.

1. Invia POST /api/v1/activations con {"service": "facebook", "country": "tn"} e salva l'id di attivazione.
2. Digita il numero restituito nell'app che stai testando e fai partire il codice.
3. Gestisci activation.sms_received sul tuo webhook: verifica X-OTPRoute-Signature (HMAC-SHA256 del timestamp, un punto e il corpo grezzo), rifiuta i timestamp vecchi e ignora i duplicati per un id di attivazione che hai già elaborato.
4. Senza webhook, fai polling su GET /api/v1/activations/{id}, restando ben al di sotto del limite di 300 richieste al minuto.
5. Chiama POST /api/v1/activations/{id}/cancel se il test viene interrotto.

La documentazione dell'API elenca ogni campo, e la guida ai test in CI mostra come integrare tutto in una pipeline.

Passo dopo passo dalla dashboard

1. Crea un account con la tua email e un codice a sei cifre, oppure con l'accesso Google, e attiva l'autenticazione a due fattori TOTP.
2. Aggiungi fondi con carta o USDT/USDC.
3. Scegli la Tunisia, poi il servizio, e controlla il prezzo mostrato.
4. Ordina, copia il numero +216 e richiedi il codice nell'app di destinazione.
5. Copia il codice tunisino dalla dashboard appena compare e completa la registrazione che stai testando.

Risoluzione dei problemi: e se il codice +216 non arriva mai?

Ogni attivazione dura 20 minuti e paghi solo quando arriva un codice. Se la finestra scade o annulli, l'intero importo torna nel portafoglio.

• Non è arrivato nulla: lascia scadere la finestra, poi riprova più tardi o con un'altra route di servizio se il test lo consente.
• Il servizio ha rifiutato il numero: alcuni servizi rifiutano i numeri virtuali; il rimborso copre questo caso.
• Il webhook tace ma la dashboard mostra il codice: il tuo controllo della firma probabilmente fallisce; confronta con il corpo grezzo, non con un JSON riserializzato, e controlla la deriva dell'orologio.
• Più fallimenti di fila: aggiungi un backoff; riordinare a raffica raramente aiuta.

Linee a lungo termine, fatturazione e sandbox per la Tunisia

Non esiste un numero tunisino a lungo termine in self-service. I Numeri Dedicati sono un prodotto per Stati Uniti e Canada da $1.95/mese; se ti serve una linea +216 duratura, scrivi a [email protected], tenendo presente che la disponibilità dipende dalle norme locali.

Il portafoglio è a consumo senza canone mensile, e ogni ricarica riceve una fattura PDF via email. Gli account di sviluppo possono richiedere la modalità sandbox, dove numeri e codici simulati ti permettono di provare l'integrazione senza spendere saldo.

Domande frequenti

Posso testare una registrazione tunisina senza una SIM tunisina?

Sì. Usa un numero +216 dell'OTP Gateway e raccogli il codice nella dashboard o tramite l'API di verifica SMS e i webhook.

I numeri tunisini hanno un prefisso interurbano da rimuovere?

No. I numeri tunisini hanno otto cifre senza prefisso interurbano, quindi la forma E.164 è semplicemente +216 più quelle cifre.

Qual è l'id paese dell'API OTP per la Tunisia?

Usa tn nella query dei prezzi e nel corpo della richiesta POST /api/v1/activations.

Quanto costa un numero di verifica della Tunisia?

Da $0.20 per codice; l'importo esatto dipende dal servizio e compare nella dashboard e nell'endpoint dei prezzi prima dell'ordine. Vedi i prezzi.

Il mio parser fallisce sui messaggi OTP in arabo. Cosa devo cambiare?

Rimuovi i segni di direzione Unicode e cerca la sequenza di cifre invece delle parole circostanti, così la stessa regola funziona per i corpi in arabo, francese e inglese.

Posso tenere un numero +216 per accessi futuri?

Non in self-service. Un numero Gateway copre un solo codice, e le linee a lungo termine disponibili subito esistono solo negli Stati Uniti e in Canada.

I nomi dei servizi sono marchi dei rispettivi proprietari. OTP Route non è affiliata a essi. Usa i numeri in modo lecito e rispetta i termini di ciascun servizio e la nostra Politica di Utilizzo Accettabile.