Testare le registrazioni in Mozambico quando nessuno del team ha una SIM +258

Il nostro lancio in Mozambico è fermo alla verifica telefonica. Da dove partiamo?

La storia è sempre quella: l'app è tradotta, le schermate di pagamento sono pronte e l'ultimo ticket aperto dice che qualcuno deve confermare che un cliente mozambicano riesca davvero a completare la registrazione. Nessuno ha una SIM +258, il roaming è lento da organizzare e il telefono personale di un collega non è una fixture di test.

L'OTP Gateway elimina questa dipendenza. Richiedi un numero +258 per un servizio specifico, lo usi una volta sulla schermata sotto test e il codice in arrivo torna a te. È adatto a QA e test automation, checklist di lancio e team di supporto che riproducono la segnalazione di un cliente senza farsi prestare il telefono di nessuno.

Che aspetto ha un numero +258 e come conviene salvarlo?

Il prefisso internazionale del Mozambico è +258 e i numeri nazionali sono lunghi nove cifre senza alcuno zero di linea da togliere, quindi la forma locale e quella internazionale differiscono solo per il prefisso. I numeri mobili iniziano con 8. In pratica significa:

• Conserva la forma E.164, +258 seguito dalle nove cifre, e formatta per la visualizzazione separatamente.
• Rifiuta gli input che aggiungono uno zero iniziale per abitudine da altri mercati, oppure rimuovilo in silenzio prima della validazione.
• Mantieni il prefisso internazionale anche per gli utenti che compongono solo numeri locali; il tuo mittente SMS e ogni consumer di webhook ne hanno bisogno.

La lingua ufficiale è il portoghese, quindi i messaggi possono arrivare in portoghese o in inglese a seconda del servizio e della lingua dell'account. Se i tuoi template sono in portoghese, controlla come vengono resi caratteri accentati come ç e ã, dato che il testo non ASCII cambia la codifica dell'SMS e può dividere un messaggio in più parti.

Quali servizi possono inviare un codice a un numero di verifica del Mozambico?

Tra tutti i servizi, lo snapshot per il Mozambico ne conta più di 1.600. Tra quelli richiesti più spesso ci sono WhatsApp, Telegram, Facebook, Instagram, Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, Uber, Signal, Viber, Netflix, Airbnb, Discord e Claude.

La disponibilità è live e non fissa: lo stesso servizio può essere ben fornito a una certa ora e scarseggiare più tardi. Leggila dall'API o dalla dashboard prima di ogni ordine invece di scrivere un elenco nel piano di test.

Come funziona da capo a fondo il flusso dell'API OTP del Mozambico?

Per gli sviluppatori l'integrazione è una breve sequenza contro https://otproute.com/api/v1, autenticata con una chiave Bearer che inizia con or_live_:

1. Ricava l'id del Mozambico (mz) e l'id del servizio da GET /api/v1/countries e GET /api/v1/services.
2. Controlla GET /api/v1/prices?country=mz&service=<id> per il prezzo live e per sapere se ci sono numeri disponibili.
3. Invia POST /api/v1/activations con {"service": "telegram", "country": "mz"} e conserva l'id dell'attivazione e il numero restituiti.
4. Raccogli il codice quando activation.sms_received raggiunge il tuo endpoint, oppure interroga GET /api/v1/activations/{id} ogni pochi secondi.
5. Chiama POST /api/v1/activations/{id}/cancel se il test viene abbandonato.

Le richieste webhook portano un header X-OTPRoute-Signature (t=<unix>,v1=<hex>), un HMAC-SHA256 di <t>.<raw body> con il secret del tuo endpoint. Verificalo, rifiuta i timestamp vecchi e rendi l'handler idempotente sull'id dell'attivazione. Le chiavi si trovano nella console Developer (fino a 10, più 5 endpoint webhook) e il limite di frequenza è di 300 richieste al minuto. La guida all'integrazione dell'API OTP mostra lo stesso flusso dell'API di verifica SMS con la gestione degli errori.

Un non sviluppatore può ordinare un numero +258 dalla dashboard?

Sì, e usa esattamente lo stesso routing OTP dell'API. Dopo aver creato un account con email e un codice di 6 cifre (oppure con Google), aggiungi fondi, apri l'OTP Gateway, scegli Mozambico e il servizio e conferma il prezzo mostrato. Il numero compare subito; incollalo nell'app e il codice viene visualizzato nella stessa pagina quando arriva. Per l'account stesso è disponibile l'accesso a due fattori con un'app di autenticazione.

Perché il codice non è arrivato e cosa proviamo dopo?

Ogni attivazione ha una finestra di 20 minuti. Se si chiude senza SMS, oppure annulli, l'intero importo viene riaccreditato automaticamente sul wallet; paghi solo quando arriva un codice.

Se un'esecuzione continua a restare vuota:

• Dai tempo alla finestra. La rapidità con cui arriva un codice dipende dal servizio e dalla rotta.
• Verifica se quel servizio accetta numeri virtuali; alcuni li rifiutano del tutto.
• Riprova dopo una pausa, oppure scegli un'altra rotta quando il test non richiede specificamente un numero mozambicano.
• Distanzia i tentativi invece di martellare l'endpoint degli ordini e registra l'id di ogni attivazione per poter confrontare i fallimenti.

Esiste una linea mozambicana permanente e come viene fatturata?

Per il Mozambico non esiste un numero a lungo termine in self-service. Le linee dedicate sono vendute solo per Stati Uniti e Canada, da $1.95/month. I team che hanno bisogno di una linea mozambicana continuativa possono scrivere a [email protected] per chiedere; la fattibilità dipende dalle norme locali e potrebbe non esserci.

Il pagamento passa da un unico wallet prepagato in USD, pay as you go, senza abbonamento. Sono accettate ricariche con carta e con stablecoin USDT/USDC, ciascuna seguita da una fattura PDF via email. Per sviluppo e debug, un account di sviluppo può essere portato in sandbox su richiesta, così numeri e codici simulati attraversano il tuo codice senza spendere nulla. Consulta i prezzi per vedere come vengono mostrate le tariffe.

Domande frequenti

Posso testare un flusso di registrazione in Mozambico dall'estero?

Sì. Il numero +258 proviene dall'OTP Gateway, quindi il tuo team può eseguire il test da qualsiasi luogo e leggere il codice nella dashboard o tramite API.

Qual è l'id del Mozambico nell'API?

Usa mz in GET /api/v1/prices e nel corpo di POST /api/v1/activations.

I numeri mozambicani richiedono uno zero iniziale?

No. Il Mozambico non ha un prefisso di linea nazionale, quindi la forma da salvare è semplicemente +258 seguito da nove cifre.

Quanto costa ricevere un OTP SMS del Mozambico?

I codici partono da $0.20 per codice e il prezzo esatto per ogni servizio viene restituito live dall'API e mostrato nella dashboard prima dell'ordine.

Un numero di test +258 funzionerà ancora per accedere la settimana prossima?

Conta sul fatto che non funzioni. Un numero dell'OTP Gateway serve per un solo codice, e i numeri dedicati a lungo termine sono offerti solo negli Stati Uniti e in Canada.

Ci sono regole su cosa possiamo verificare con questi numeri?

Sì. Usali solo per testare e gestire i tuoi prodotti e account legittimi, rispetta i termini di ciascun servizio e resta entro l'Acceptable Use Policy di OTP Route.

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.