Monouso o di lungo periodo? Scegliere la route +1 787 per i test di verifica

Un progetto a Porto Rico deve usare l'OTP Gateway o un numero dedicato?

Parti da quanto deve durare il numero. L'OTP Gateway assegna un numero +1 787 per un solo codice, adatto a un test di registrazione, a un controllo di localizzazione o a un job CI che verifica una volta e passa oltre. Un numero dedicato è una linea che conservi, indicata per un account di staging che deve riaccedere la settimana prossima o per una casella di supporto condivisa.

Per Porto Rico la scelta è di fatto già fatta. Pur essendo un territorio degli Stati Uniti, i suoi numeri non fanno parte dell'inventario self-service dei numeri dedicati; quel prodotto copre Stati Uniti e Canada, da $1.95/month. Se per un account ricorrente va bene una linea statunitense continentale, la pagina dei numeri virtuali spiega le opzioni. Se ti serve proprio una linea portoricana di lungo periodo, scrivi a [email protected]; la possibilità di realizzarla dipende dalle norme locali e non è garantita.

Quali chiamate dell'API OTP per Porto Rico creano e leggono un'attivazione?

L'API si trova su https://otproute.com/api/v1 e richiede chiavi Bearer con prefisso or_live_. L'id di Porto Rico è pr.

1. Recupera gli id con GET /api/v1/services e GET /api/v1/countries e tienili in cache per ogni deployment.
2. Calcola il prezzo: GET /api/v1/prices?country=pr&service=<id> restituisce la cifra attuale e mostra se una route è aperta.
3. Ordina con POST /api/v1/activations, corpo {"service": "<id>", "country": "pr"}.
4. Inserisci il numero restituito nel flusso sotto test.
5. Ricevi il codice tramite activation.sms_received sul tuo webhook, oppure fai polling su GET /api/v1/activations/{id}.
6. Annulla con POST /api/v1/activations/{id}/cancel se il job si interrompe prima.

Le chiamate webhook portano X-OTPRoute-Signature: t=<unix>,v1=<hex>. Ricalcola l'HMAC-SHA256 di <t>.<raw body> con il secret dell'endpoint, confronta a tempo costante, rifiuta i timestamp vecchi e ignora gli eventi ripetuti per un id di attivazione già gestito. Ogni account ha 10 chiavi, 5 endpoint webhook e 300 richieste al minuto. La guida all'integrazione dell'API OTP approfondisce l'argomento.

Perché i numeri +1 787 e +1 939 danno problemi nei moduli?

Porto Rico appartiene al piano di numerazione nordamericano, quindi i suoi numeri sembrano quelli statunitensi: prefisso 1, un prefisso distrettuale di tre cifre (787 o il 939 in sovrapposizione) e sette cifre, scritti in E.164 come +1787 o +1939 più sette cifre.

Questa somiglianza causa bug reali. Alcune app elencano Porto Rico come paese a sé con codice ISO PR, altre lo uniscono agli Stati Uniti, e i moduli di indirizzo possono aspettarsi PR come valore di stato. Verifica che selettore del paese, validatore del telefono e campi dell'indirizzo siano coerenti tra loro e che a chi seleziona Porto Rico non venga mai detto che il suo numero +1 non è valido. Salva i numeri in E.164 e ricava la regione dal prefisso distrettuale invece che dal +1 iniziale.

Quali servizi possono ricevere codici SMS OTP di Porto Rico?

La route di Porto Rico include attualmente più di 900 servizi. Tra i mittenti più diffusi ci sono WhatsApp, Uber, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), Amazon, ChatGPT (OpenAI), Microsoft & Outlook, LinkedIn, Discord, Airbnb, Netflix e Telegram. La disponibilità cambia durante la giornata, quindi fidati della risposta dell'API al momento dell'ordine più che di qualsiasi elenco.

Senza scrivere codice, apri l'OTP Gateway nella dashboard, scegli Porto Rico e un servizio, conferma il prezzo mostrato e ordina. Il numero di verifica di Porto Rico compare con il suo conto alla rovescia e il codice viene stampato accanto quando arriva l'SMS.

E se il codice non arriva entro 20 minuti?

Ogni attivazione dura 20 minuti e paghi solo quando arriva un codice. Se la finestra scade a vuoto, oppure annulli, l'intero importo torna automaticamente nel wallet.

Se i codici portoricani non arrivano:

• Concedi all'attivazione l'intera finestra prima di dare il test per fallito.
• Riprova un po' più tardi, oppure scegli un'altra route di servizio.
• Verifica che il servizio accetti numeri virtuali; alcuni li rifiutano, e il rimborso serve ad assorbire proprio questo caso.
• Non lanciare nuovi ordini a raffica; aggiungi un backoff esponenziale tra i tentativi.

Per gli schemi più generali, leggi come ridurre le consegne OTP non riuscite.

Perché i team verificano i flussi in spagnolo e in inglese per Porto Rico?

Spagnolo e inglese sono entrambi lingue ufficiali, e lo spagnolo è quella che la maggior parte dei residenti usa ogni giorno. Questo rende Porto Rico un luogo pratico per controllare l'onboarding bilingue: l'SMS di verifica arriva in spagnolo quando l'app è impostata in spagnolo? La schermata di inserimento del codice gestisce i testi con gli accenti? Parte il template giusto quando l'utente cambia lingua a metà flusso? L'isola usa il dollaro statunitense e molte aziende USA la servono già, quindi app di pagamento, piattaforme di consegna, marketplace e banche che estendono un lancio negli Stati Uniti hanno spesso bisogno di un numero +1 787 per i test. Esegui questi controlli su account che controlli tu, rispetta i termini di ogni servizio e resta entro la Acceptable Use Policy di OTP Route. Per automatizzarli, vedi i test CI/CD.

Come funzionano wallet e sandbox per i test a Porto Rico?

Non c'è alcun abbonamento. Un unico wallet prepagato in USD finanzia ogni ordine, senza canone mensile e senza piani da scegliere. Ricarica con carta o con USDT/USDC e per ogni ricarica e acquisto di numero arriva via email una fattura PDF. Prima di andare in produzione, chiedi di passare il tuo account di sviluppo alla sandbox, che restituisce numeri e codici simulati così da provare l'intero flusso di OTP routing senza spendere fondi. Quando sei pronto, crea un account con un'email e un codice di 6 cifre oppure con l'accesso Google, e attiva l'autenticazione a due fattori TOTP per il team.

Domande frequenti

Posso testare un flusso di registrazione di Porto Rico senza una SIM locale?

Sì. Ordina un numero +1 787 dall'OTP Gateway, inseriscilo nella tua app e ritira il codice nella dashboard o tramite l'API di verifica SMS e i webhook.

Nell'API Porto Rico è trattato come gli Stati Uniti?

No. Ha un proprio id di paese, pr, che usi nelle richieste di prezzo e di attivazione al posto di quello degli Stati Uniti.

Posso acquistare un numero dedicato +1 787?

Non dalla dashboard. I numeri dedicati in self-service coprono solo Stati Uniti e Canada; per una linea portoricana scrivi a [email protected] per chiedere.

L'SMS di verifica sarà in spagnolo?

Dipende dal mittente e spesso dall'impostazione della lingua dell'app. Se il tuo prodotto supporta entrambe, testa sia la localizzazione spagnola sia quella inglese.

Quali prefissi distrettuali posso vedere su un numero di Porto Rico?

Porto Rico usa 787 e 939. Qualunque tu riceva, salvalo in E.164 in modo che i tuoi dati restino coerenti.

Quanto costa un codice di verifica di Porto Rico?

Da $0.20 per codice. Il prezzo esatto per ogni servizio viene da GET /api/v1/prices e dalla dashboard, e non viene addebitato nulla se il codice non arriva.

Quanti test paralleli posso eseguire?

L'account consente 300 richieste al minuto e 10 chiavi. La maggior parte di quel budget se ne va nel polling, quindi i webhook lasciano più margine per i job paralleli.

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.