Portare i codici di verifica del Ciad (+235) nel tuo stack

Qual è la sequenza di chiamate per una richiesta all'API OTP del Ciad?

Le richieste per il Ciad usano lo stesso URL di base di ogni altro mercato, https://otproute.com/api/v1, con una chiave Bearer or_live_. Le chiavi si creano nella console sviluppatori; un account può averne fino a 10 e fare 300 richieste al minuto.

Un'esecuzione tipica per il Ciad richiede quattro chiamate:

1. GET /api/v1/countries e GET /api/v1/services per confermare che td sia elencato e per cercare l'id del servizio a cui punta il tuo test.
2. GET /api/v1/prices?country=td&service=<id> per leggere il prezzo live di quella coppia prima di spendere qualsiasi cosa.
3. POST /api/v1/activations con un corpo come {"service": "telegram", "country": "td"}. La risposta contiene un id di attivazione e il numero +235 da digitare nell'app sotto test.
4. Attendi il codice, poi lascia completare l'attivazione oppure chiama POST /api/v1/activations/{id}/cancel se il test si interrompe prima.

Vale la pena chiamare GET /api/v1/balance all'inizio di un job CI, così la pipeline fallisce subito e in modo chiaro su un wallet vuoto invece di andare in timeout a metà. Il riferimento completo è nella documentazione per sviluppatori.

Come dovrebbe trattare un ricevitore webhook i codici +235?

Fare polling su GET /api/v1/activations/{id} ogni pochi secondi va bene per un singolo script. Quando più runner di test condividono una chiave, un webhook è più pulito. Registra un endpoint (cinque per account) e iscriviti a activation.sms_received, activation.expired e activation.cancelled.

Ogni richiesta include un header X-OTPRoute-Signature nella forma t=<unix>,v1=<hex>. Ricostruisci la stringa <t>.<raw body>, firmala con HMAC-SHA256 usando il secret dell'endpoint e confronta con v1 in tempo costante. Rifiuta tutto ciò che ha un timestamp vecchio; così si chiude la porta alle richieste riproposte. La nostra guida su come proteggere i webhook OTP con HMAC la illustra in diversi linguaggi.

Considera l'id di attivazione come chiave di idempotenza. Se lo stesso evento viene consegnato due volte, la seconda scrittura non deve cambiare nulla, e il tuo handler dovrebbe restituire subito un 2xx ed eseguire dopo il lavoro lento.

Quali app possono inviare codici a un numero di verifica del Ciad?

L'istantanea live per td elenca più di 1.500 servizi. Tra i più diffusi ci sono WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Viber, imo, Signal, Microsoft & Outlook, LinkedIn, ChatGPT (OpenAI) e AliExpress.

La disponibilità non è statica. Le rotte si aprono e si chiudono durante la giornata mentre i nostri partner carrier spostano la capacità, quindi un servizio visibile stamattina potrebbe mancare nel pomeriggio. Leggi il catalogo a tempo di esecuzione invece di fissarlo nel codice e tieni un secondo servizio nel piano di test nel caso il primo sia temporaneamente indisponibile per il Ciad.

Come si memorizza e si normalizza un numero +235?

Il Ciad usa un piano di numerazione chiuso: i numeri nazionali hanno otto cifre e non c'è un prefisso di linea da eliminare, quindi la forma E.164 è semplicemente +235 seguito da quelle otto cifre. Questo rende il Ciad uno dei mercati più semplici da validare.

• Salva l'intera stringa E.164 in un'unica colonna invece di separare prefisso paese e numero di abbonato.
• Se il tuo modulo accetta spazi o il raggruppamento a coppie che le persone digitano spesso, eliminali prima del salvataggio.
• Verifica nei test che un valore con uno 0 iniziale spurio venga rifiutato o ripulito, perché gli utenti che vengono da altri piani a volte lo aggiungono per abitudine.

Il francese e l'arabo sono le lingue ufficiali. La formulazione di un SMS di verifica, però, segue la lingua impostata sull'app o sull'account, quindi una suite di localizzazione dovrebbe controllare separatamente i modelli in francese, arabo e inglese.

Perché i team di prodotto eseguono test in Ciad?

Pochi team di ingegneria hanno sede a N'Djamena, ed è proprio per questo che un numero +235 remoto è utile. Ecco i motivi più comuni:

• Lanci nell'Africa centrale francofona, dove un prodotto già attivo nei mercati vicini aggiunge il Ciad al selettore di paese della registrazione e ha bisogno della prova che il flusso funzioni.
• QA della localizzazione in arabo e francese, compreso il layout da destra a sinistra della schermata di inserimento del codice.
• Clienti della diaspora che mantengono un numero ciadiano mentre vivono all'estero, cosa che influisce su come le tue regole antifrode leggono il prefisso paese.
• Team operativi che gestiscono account di messaggistica aziendale per partner regionali.

Lo schema più ampio è descritto in instradamento per paese degli OTP.

Cosa fare se il codice del Ciad non arriva?

Un numero muto è di solito un problema di rotta o di accettazione, non un bug del tuo codice. Procedi in quest'ordine:

• Dai una possibilità alla finestra di 20 minuti; alcuni mittenti raggruppano i messaggi.
• Verifica che il servizio di destinazione accetti numeri virtuali. Alcuni non li accettano, ed è per questo che esiste il rimborso.
• Riprova più tardi, o con un servizio diverso sullo stesso paese, invece di rifare l'ordine in un ciclo serrato. I retry rapidi possono far scattare i limiti di frequenza del mittente.
• Controlla che il tuo handler abbia verificato correttamente la firma; un webhook rifiutato sembra un codice mancante.

Se la finestra si chiude o annulli, l'intero importo torna nel wallet senza ticket di assistenza. Altre tattiche sono nella guida su come ridurre i fallimenti nella consegna degli OTP.

Esiste una linea del Ciad a lungo termine e come viene fatturata?

Per il Ciad non esiste un numero a lungo termine in self-service. I Numeri Dedicati sono un prodotto per Stati Uniti e Canada, da $1.95/month, con SMS in entrata e in uscita e chiamate dal browser. Se ti serve una linea +235 duratura, scrivi a [email protected]; la disponibilità dipende dalle norme locali e non possiamo prometterla.

Gli addebiti per i codici +235 vengono prelevati da un unico saldo prepagato in USD; non c'è un livello di abbonamento né un canone mensile. La ricarica avviene con carta o con stablecoin USDT/USDC, e dopo ogni deposito arriva nella tua casella una fattura PDF. Le tariffe attuali sono nella pagina dei prezzi. Per il lavoro di integrazione, chiedi il passaggio alla sandbox: restituisce numeri e codici simulati, così puoi provare il flusso senza toccare i fondi del wallet. Aprire un nuovo account richiede un codice email di sei cifre, oppure l'accesso Google se il tuo team preferisce.

Domande frequenti

Qual è l'id paese del Ciad nell'API di OTP Route?

Usa td nel campo country di POST /api/v1/activations e nella query dei prezzi.

Posso testare il flusso di registrazione della mia app per il Ciad senza una SIM locale?

Sì. Ordina un numero +235 dall'OTP Gateway, inseriscilo nella tua app e leggi il codice dalla dashboard, dall'API o da un webhook.

Per quanto tempo un numero +235 resta utilizzabile?

Un'attivazione resta aperta per 20 minuti e copre un solo codice. Dopo, ordinane una nuova.

Pago se l'SMS non arriva mai?

No. Se nessun messaggio arriva prima della chiusura della finestra, oppure annulli, l'importo viene riaccreditato automaticamente nel tuo wallet.

Nei numeri del Ciad bisogna eliminare un prefisso di linea?

No. Il Ciad non ha prefisso di linea, quindi la forma salvata è +235 più il numero nazionale di otto cifre.

Posso tenere un numero del Ciad per accessi futuri?

Non in self-service. I Numeri Dedicati a lungo termine esistono solo negli Stati Uniti e in Canada; per il Ciad scrivi al team per chiedere cosa è possibile.

Ci sono regole d'uso?

Sì. Rispetta i termini di ciascun servizio e l'Acceptable Use Policy di OTP Route; il gateway serve per testare e gestire i tuoi prodotti e account legittimi.

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.