Instradare i codici di verifica della Repubblica del Congo (+242) nel tuo stack di test

Quali chiamate API recuperano un codice +242 dall'inizio alla fine?

Tutto vive sotto https://otproute.com/api/v1 e si autentica con una chiave Bearer che inizia per or_live_. Genera le chiavi nella Developer console; un account può averne fino a 10, il che permette di dare a staging, CI e al portatile di un collega credenziali separate, revocabili in modo indipendente.

Una tipica esecuzione di test per il mercato di Brazzaville procede così:

1. Recupera GET /api/v1/services e GET /api/v1/countries e metti in cache gli id. La Repubblica del Congo è cg (da non confondere con il vicino più grande, che ha un proprio id e una pagina dedicata: Congo (RDC)).
2. Chiedi a GET /api/v1/prices?country=cg&service=<id> il prezzo live e la disponibilità dell'app che stai testando.
3. Crea l'attivazione con POST /api/v1/activations e un corpo come {"service": "telegram", "country": "cg"}. Ricevi un id di attivazione e un numero +242.
4. Digita quel numero nella schermata di registrazione o di accesso del tuo prodotto.
5. Recupera il codice congolese da una consegna webhook o interrogando GET /api/v1/activations/{id}. Se il test viene interrotto, rilascialo con POST /api/v1/activations/{id}/cancel.

Esegui GET /api/v1/balance prima dell'avvio di una suite, così un portafoglio vuoto fa fallire subito il job invece che a metà. Il limite di 300 richieste al minuto lascia ampio margine per qualche worker in parallelo. Le forme complete di richieste e risposte sono nella documentazione per sviluppatori.

Come collego un webhook firmato per le attivazioni congolesi?

Il polling va bene per un ingegnere che prova un flusso a mano; un webhook è più gentile con una flotta di CI. Aggiungi un endpoint nella Developer console (ne sono consentiti cinque per account) e sottoscrivi activation.sms_received, activation.expired e activation.cancelled.

Ogni richiesta porta X-OTPRoute-Signature: t=<unix>,v1=<hex>. Ricostruisci l'HMAC-SHA256 di "<t>.<raw body>" usando il secret di quell'endpoint, confrontalo con v1 con un controllo a tempo costante e scarta tutto ciò che ha un timestamp obsoleto. Calcola l'hash sui byte grezzi prima di qualsiasi parsing JSON, perché un JSON riserializzato raramente coincide byte per byte.

Tratta gli eventi come identificati dall'id di attivazione. Se lo stesso evento arriva due volte, il tuo handler dovrebbe accorgersi che l'id è già risolto e restituire semplicemente uno stato di successo. La guida alla cattura via webhook mostra schemi di accodamento che evitano timeout ai runner di test lenti.

Quali servizi può coprire un numero di verifica del Congo?

Lo snapshot di oggi per cg comprende WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Claude, Microsoft & Outlook, LinkedIn, Signal, Viber e imo. In totale il paese ha più di 1.000 servizi sull'OTP Gateway.

Quell'elenco cambia durante la giornata mentre le rotte si aprono e si chiudono, quindi non scriverlo mai direttamente nel codice. Lascia che il tuo harness di test chieda all'endpoint dei prezzi il servizio che gli serve e che salti o riprogrammi con garbo quando la disponibilità è vuota. Nell'offerta congolese dominano le app di messaggistica, il che corrisponde a come molti clienti conoscono per la prima volta un prodotto: tramite un link condiviso in un gruppo di chat, non con una ricerca in un app store.

Come vanno memorizzati e normalizzati i numeri +242?

I numeri della Repubblica del Congo hanno nove cifre dopo il prefisso internazionale e, a differenza di molti piani di numerazione, lo 0 iniziale fa parte del numero dell'abbonato e non è un prefisso interurbano. I cellulari si scrivono comunemente 06… o 05… a livello locale e +242 06… a livello internazionale. Un normalizzatore copiato da una base di codice europea che elimina qualsiasi zero iniziale li corromperebbe in silenzio, quindi salva esattamente la stringa E.164 che l'API restituisce e valida la lunghezza per paese invece di usare un'unica regola globale.

Il francese è la lingua ufficiale e quella abituale degli SMS di verifica, anche se lingala e kituba sono molto parlati nella vita quotidiana. Aspettati caratteri accentati in alcuni template e fai in modo che il tuo parser estragga le cifre con un pattern, senza affidarsi a formulazioni inglesi fisse.

I team di solito testano qui quando portano un prodotto nell'Africa centrale francofona, assistono il personale operativo a Brazzaville o Pointe-Noire, oppure servono clienti congolesi all'estero che si registrano ancora con un numero del paese d'origine. Controllare l'intero flusso su una vera rotta +242 fa emergere problemi di formattazione e di testi che un simulatore non vedrebbe.

E se nessun codice arriva al numero +242?

Il silenzio di solito è un problema di rotta o di accettazione, non un bug dell'integrazione. Un piano sensato:

• Lascia che la finestra di 20 minuti faccia il suo corso prima di trarre conclusioni; alcuni mittenti accorpano il loro traffico in uscita.
• Verifica che il servizio di destinazione accetti numeri virtuali. Diversi non lo fanno, ed è proprio per questo che un codice non ricevuto non costa nulla.
• Riprova più tardi, oppure passa a un'altra rotta di servizio, invece di lanciare nuovi ordini in un ciclo serrato che consuma il limite di richieste.
• Annulla i numeri che non ti servono più, così i fondi tornano subito invece di aspettare la scadenza.

Il nostro articolo su come ridurre i mancati recapiti OTP tratta più a fondo backoff e budget di retry.

Posso tenere una linea congolese a lungo termine?

Per la Repubblica del Congo non esiste un numero a lungo termine in self-service. L'OTP Gateway emette un numero per ogni codice di verifica, ed è l'unico prodotto offerto per cg al momento.

I numeri virtuali dedicati di OTP Route sono un prodotto per Stati Uniti e Canada a partire da $1.95/month, con SMS in entrata e in uscita più chiamate dal browser. Se il tuo team ha davvero bisogno di una linea congolese stabile, scrivi a [email protected]; se si possa organizzare qualcosa dipende dalle norme locali, quindi consideralo una domanda, non una promessa. I compromessi sono riassunti in numeri temporanei e numeri dedicati.

Come si fattura e si testa in sicurezza una configurazione di routing OTP per il Congo?

La fatturazione si basa su un unico portafoglio prepagato in USD, senza abbonamenti né livelli di piano. Ricarichi con carta o con le stablecoin USDT/USDC e ogni ricarica produce una fattura PDF via email per il tuo reparto finanza.

Prima di collegare denaro vero a una pipeline, chiedi al supporto di portare un account di sviluppo in modalità sandbox. Restituisce numeri e codici simulati, così puoi provare l'intero percorso dell'API di verifica SMS end to end senza spendere nulla. Usa OTP Route solo sui tuoi prodotti e su account che hai il diritto di gestire; valgono comunque i termini di ogni servizio e la nostra Acceptable Use Policy. Vedi i prezzi per capire come addebiti e rimborsi compaiono nel portafoglio.

Domande frequenti

Qual è l'id paese della Repubblica del Congo nell'API di OTP Route?

È cg. La Repubblica Democratica del Congo è un paese separato con un proprio id, quindi controlla bene a quale dei due fa riferimento la tua configurazione.

Posso testare la registrazione congolese della mia app senza una SIM locale?

Sì. Ordina un numero +242 per i test dall'OTP Gateway, inseriscilo nella tua app e leggi il codice nella dashboard o tramite API.

Devo togliere lo zero iniziale quando salvo un numero +242?

No. Nella Repubblica del Congo lo 0 appartiene al numero di abbonato di nove cifre, quindi conserva il valore E.164 esattamente come lo restituisce l'API.

In che lingua saranno i messaggi di verifica congolesi?

La maggior parte arriva in francese, a volte in inglese per le app internazionali. Estrai le cifre con un pattern invece di cercare parole specifiche.

Mi viene addebitato qualcosa se il codice non arriva?

No. Se la finestra si chiude senza SMS, o annulli prima, l'intero importo torna automaticamente nel tuo portafoglio.

Quanto costa ricevere un SMS OTP dal Congo?

Da $0.20 per codice; il prezzo +242 di ogni app viene indicato in tempo reale, quindi consultalo prima di ordinare.

Esiste una sandbox per sviluppare l'integrazione?

Sì, su richiesta. Il supporto può portare un account di sviluppo in modalità sandbox, che restituisce numeri e codici simulati senza toccare i fondi del portafoglio.

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.