Scegliere una rotta +55 per la verifica SMS in Brasile

Un test sul Brasile deve usare l'OTP Gateway o una linea a lungo termine?

Parti dalla forma del lavoro, perché è lei a decidere il prodotto. Un test di verifica brasiliano di solito richiede un solo codice, una sola volta: una schermata di registrazione in portoghese, una richiesta di accesso, un passaggio di cambio telefono. È esattamente ciò per cui è costruito l'OTP Gateway. Scegli un servizio e il Brasile, ricevi un numero +55 per un solo codice e l'attivazione si chiude dopo 20 minuti o quando arriva l'SMS.

Una linea a lungo termine è un'altra storia. I Dedicated Numbers sono un prodotto per Stati Uniti e Canada, venduti istantaneamente dalla dashboard da $1.95/month, con SMS in ingresso, SMS in uscita e chiamate dal browser. Non esiste un numero +55 a lungo termine in self-service. Se il tuo team ha davvero bisogno di una linea brasiliana da conservare, scrivi a [email protected] descrivendo il caso d'uso; la fattibilità dipende dalle normative locali e non si promette nulla.

Una regola pratica veloce:

• Un codice per caso di test, stato pulito a ogni esecuzione: OTP Gateway con br.
• Un account di staging che deve accedere di nuovo il mese prossimo: un Dedicated Number statunitense o canadese, se il servizio lo accetta.
• Dubbi: leggi numeri temporanei e dedicati prima di comprare qualsiasi cosa.

Quali app possono inviare codici a un numero brasiliano in questo momento?

La rotta del Brasile copre attualmente più di 2.900 servizi e tra i più popolari nell'istantanea live ci sono WhatsApp, Telegram, Google (Gmail & YouTube), Instagram, Facebook, TikTok, Uber, Discord, Microsoft & Outlook, LinkedIn, Netflix, Airbnb, Shopee e AliExpress.

Considera quell'elenco un'istantanea e non un contratto. La disponibilità cambia durante la giornata mentre i nostri partner di rete aggiungono e ruotano le rotte, quindi una pipeline dovrebbe chiedere all'API invece di fidarsi di un elenco scritto nel codice. La directory dei paesi mostra gli stessi dati live a chi preferisce un browser.

Che aspetto ha in pratica la sequenza dell'API OTP per il Brasile?

Ogni chiamata va a https://otproute.com/api/v1 con una chiave Bearer con prefisso or_live_, generata nella Developer console. L'id paese del Brasile è br.

1. Risolvi gli id dei servizi una volta sola con GET /api/v1/services e conservali nella configurazione.
2. Prima di ordinare, chiama GET /api/v1/prices?country=br&service=whatsapp (o il tuo id di servizio). La risposta contiene prezzo e disponibilità aggiornati per quella coppia.
3. Crea l'attivazione con POST /api/v1/activations e il corpo {"service": "whatsapp", "country": "br"}. Salva l'id dell'attivazione accanto alla tua esecuzione di test.
4. Digita il numero +55 nel flusso che stai testando.
5. Ascolta l'evento activation.sms_received su un webhook; come ripiego, controlla GET /api/v1/activations/{id} ogni pochi secondi.
6. Se il test viene interrotto, rilascia il numero con POST /api/v1/activations/{id}/cancel così i fondi tornano subito.

Le consegne webhook sono firmate in X-OTPRoute-Signature come t=<unix>,v1=<hex>: un HMAC-SHA256 di <t>.<raw body> calcolato con il secret dell'endpoint. Verificalo, scarta i timestamp obsoleti e rendi l'handler idempotente rispetto all'id dell'attivazione. Il riferimento completo è nella documentazione API.

Chi lavora nel team growth può farlo senza scrivere codice?

Sì. La dashboard esegue lo stesso OTP routing senza alcuno script:

1. Crea un account con la tua email e un codice email di 6 cifre, oppure con l'accesso Google.
2. Aggiungi fondi al wallet in USD.
3. Scegli il Brasile e il servizio, controlla il prezzo mostrato e ordina.
4. Incolla il numero +55 nell'app e osserva il codice comparire sulla scheda di attivazione.

Marketing, supporto e revisori della localizzazione usano spesso questo percorso per confermare che una schermata di onboarding in portoghese si comporti bene prima di un rilascio, mentre gli ingegneri riservano l'API alle esecuzioni automatizzate.

Come vanno salvati e normalizzati i numeri +55?

I numeri brasiliani hanno un prefisso di zona di due cifre (DDD) seguito dal numero di abbonato, e i cellulari hanno nove cifre che iniziano con 9. All'interno del Brasile si compone uno 0 iniziale più un codice di selezione dell'operatore per le chiamate a lunga distanza, ed è per questo che l'input degli utenti spesso contiene cifre in più che non vanno salvate.

Salva tutto in E.164: +55, il prefisso di zona, poi il numero di abbonato, senza spazi, senza 0 iniziale e senza codice dell'operatore. Normalizza in input, confronta sul valore normalizzato e formatta solo per la visualizzazione. I codici dei mittenti brasiliani di solito arrivano in portoghese, a volte in inglese, quindi analizza le cifre invece di cercare una frase fissa.

I team testano questo mercato per un lancio in Brasile, per il QA di localizzazione in portoghese e per flussi di onboarding che convivono con gli obblighi della legge brasiliana sulla protezione dei dati, la LGPD. La nostra pagina sull'onboarding fintech tratta l'aspetto della verifica di questo lavoro.

E se un codice brasiliano non compare?

Per prima cosa, lascia scorrere la finestra di 20 minuti: alcuni mittenti sono più lenti di altri e il recapito dipende dal servizio e dalla rotta. Se scade, l'addebito viene stornato automaticamente e puoi riprovare un po' più tardi oppure su un'altra rotta elencata dall'API.

• Verifica che il servizio accetti numeri virtuali: alcuni no, ed è proprio per questo che esiste la regola del rimborso.
• Non riordinare in un ciclo serrato. Aumenta l'attesa tra i tentativi e registra ogni id di attivazione.
• Controlla che la tua app abbia inviato il numero in forma internazionale completa, non in un formato locale con le cifre interurbane.

La guida a ridurre i recapiti OTP falliti elenca altre diagnosi.

Come si combinano wallet, fatture e sandbox?

OTP Route fattura da un unico wallet prepagato in USD: pay as you go, senza canone mensile e senza piani da scegliere. Ricarica con carta o con USDT o USDC e ogni ricarica arriva con una fattura PDF via email. Le tariffe complete sono nella pagina dei prezzi e nell'API.

Per il lavoro di integrazione, chiedi al supporto di passare un account di sviluppo in sandbox. Restituisce numeri e codici simulati, così puoi provare il percorso di attivazione e webhook end-to-end senza toccare i fondi del wallet. Usalo solo per i tuoi prodotti, rispetta i termini di ciascun servizio e ricorda che l'Acceptable Use Policy si applica a ogni account.

Domande frequenti

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

Sì. Ordina un numero +55 dall'OTP Gateway per la tua app o per un servizio supportato, inseriscilo nel flusso e leggi il codice nella dashboard o tramite l'API.

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

È br. Passalo come campo country quando crei un'attivazione o come parametro di query country sull'endpoint dei prezzi.

Mi viene addebitato qualcosa se WhatsApp non invia mai il codice al mio numero +55?

No. Se nessun SMS raggiunge il numero entro 20 minuti, o se annulli prima, l'intero importo torna automaticamente sul tuo wallet.

Posso comprare un numero brasiliano e tenerlo per mesi?

Non come prodotto self-service. I Dedicated Numbers a lungo termine sono venduti solo per Stati Uniti e Canada; per il Brasile puoi scrivere a [email protected] per chiedere, senza alcuna promessa di disponibilità.

Devo conservare lo zero iniziale di un numero brasiliano?

No. Elimina lo 0 interurbano e qualsiasi codice di selezione dell'operatore, poi salva il numero in forma E.164 che inizia con +55 e il prefisso di zona di due cifre.

In che lingua sono i messaggi di verifica brasiliani?

La maggior parte arriva in portoghese e alcuni servizi globali inviano testo in inglese. Estrai il codice numerico invece di fare affidamento sulla formulazione.

Posso provare l'API prima di ricaricare il wallet?

Chiedi la modalità sandbox su un account di sviluppo. Simula numeri e codici, così l'intera integrazione può essere testata senza spendere fondi del wallet.

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.