Numeri di verifica colombiani per QA, lanci e routing OTP

Quattro chiamate API per ricevere codici SMS OTP dalla Colombia

Un'integrazione con l'API OTP per la Colombia richiede solo poche richieste. Inizia confermando che la rotta sia aperta con GET /api/v1/prices?country=co&service=whatsapp, sostituendo il servizio che stai testando; la risposta riporta il prezzo live per quella coppia. Poi crea l'ordine con POST /api/v1/activations e un corpo JSON che indichi il servizio e co come paese. Ottieni un id di attivazione e il numero +57 da digitare nell'app in prova.

Poi aspetta il messaggio. La maggior parte dei team registra un endpoint webhook e resta in ascolto di activation.sms_received, mentre altri chiamano GET /api/v1/activations/{id} a intervalli rilassati. Infine, metti ordine: se il test ha cambiato direzione, POST /api/v1/activations/{id}/cancel libera i fondi riservati. La documentazione per sviluppatori descrive ogni richiesta nel dettaglio.

Quali app colombiane sono sulla rotta oggi?

Il routing OTP per la Colombia comprende più di 1.900 servizi nell'ultimo snapshot. Tra i più richiesti ci sono WhatsApp, Telegram, Google (Gmail & YouTube), Instagram, Facebook, TikTok, Uber, Microsoft & Outlook, Amazon, Discord, LinkedIn, Signal e Netflix. La capacità cambia nel corso della giornata, quindi un test pianificato dovrebbe chiedere a GET /api/v1/services e all'endpoint dei prezzi che cosa è disponibile in questo momento, invece di fidarsi di un elenco scritto nel codice.

Formattare i numeri mobili +57 per l'archiviazione in E.164

I numeri mobili colombiani hanno dieci cifre dopo il prefisso internazionale e iniziano con 3, quindi la forma E.164 è +57 3XX XXX XXXX. A livello nazionale si compongono senza zero iniziale, per cui la normalizzazione resta semplice: elimina spazi, trattini e parentesi, mantieni il segno più e il 57 e salva un'unica stringa canonica. Un controllo lato client sul 3 iniziale aiuta chi incolla per errore un numero fisso a vedere un messaggio chiaro, invece di un errore silenzioso al passaggio dell'SMS.

Cosa porta i team QA sul mercato colombiano?

La Colombia è uno dei mercati di lingua spagnola più grandi e molti lanci in America Latina partono da lì o dalle vicinanze. I messaggi di verifica arrivano di solito in spagnolo, quindi un passaggio di localizzazione dovrebbe confermare che il tuo template suoni naturale, che i caratteri accentati sopravvivano alla codifica e che le cifre restino facili da individuare all'interno di una frase più lunga. Prodotti di ride-hailing, consegne, pagamenti e marketplace dipendono tutti dai controlli telefonici nella regione, ed è per questo che un numero +57 per i test compare di continuo nelle checklist di rilascio. La nostra pagina sul QA testing raccoglie schemi che funzionano con qualsiasi API di verifica SMS.

Il codice +57 è in ritardo. E adesso?

Ogni attivazione resta aperta per 20 minuti. Se la finestra si chiude senza SMS, o annulli prima tu, l'intero importo torna automaticamente nel portafoglio e il tuo endpoint riceve activation.expired oppure activation.cancelled. Prima di riprovare:

• verifica che l'app in test accetti numeri virtuali;
• lascia scadere la finestra in corso invece di accumulare nuovi ordini;
• distanzia i tentativi invece di ordinare in un ciclo serrato;
• prova in un altro momento o con un'altra rotta per lo stesso servizio.

L'articolo su come ridurre i mancati recapiti OTP spiega il ragionamento dietro ogni passaggio.

Posso tenere una linea colombiana per mesi?

Non in self-service. I numeri virtuali dedicati, che includono SMS in entrata e in uscita più chiamate dal browser, sono venduti solo per Stati Uniti e Canada, da $1.95/month. Dalla dashboard non si può acquistare alcuna linea +57 a lungo termine. Se la tua attività ne ha bisogno, scrivi a [email protected]: se sia possibile organizzare qualcosa dipende dalle norme locali e non può essere promesso in anticipo.

Come si pagano le verifiche colombiane

OTP Route funziona con un portafoglio prepagato in USD, senza canone mensile e senza piani da scegliere. Puoi ricaricare con carta oppure con le stablecoin USDT/USDC, e l'amministrazione riceve via email una fattura PDF dopo ogni ricarica. Le rotte colombiane partono da $0.20 per codice e variano in base al servizio, con l'importo esatto mostrato prima di confermare. Durante l'integrazione puoi chiedere al supporto di portare un account di sviluppo in sandbox, dove numeri e codici simulati ti permettono di provare l'intero flusso senza toccare i fondi del portafoglio. Le tariffe attuali sono nella pagina dei prezzi.

Domande frequenti

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

Sì. Ordina un numero +57 per il servizio che stai controllando, inseriscilo nel modulo di registrazione e leggi il codice nella dashboard o dal tuo webhook. Non serve spedire né attivare nulla di fisico.

Come ordino un numero di verifica colombiano dalla dashboard?

Accedi, apri l'OTP Gateway, scegli il servizio e la Colombia, controlla il prezzo e conferma. Il numero compare a schermo e il codice appare accanto a esso non appena arriva l'SMS.

Quale id paese usa l'API per la Colombia?

Usa co nel campo country e nelle richieste di prezzo. Gli id dei servizi si ottengono da GET /api/v1/services, ad esempio telegram o uber.

Pago un numero +57 che non riceve mai un codice?

No. Quando la finestra di 20 minuti termina senza SMS, o quando annulli, l'intero addebito torna automaticamente nel tuo portafoglio.

In che lingua sarà l'SMS di verifica colombiano?

Dipende dal mittente, anche se gli utenti colombiani vedono per lo più template in spagnolo. Estrai le cifre invece di cercare una formulazione fissa, perché i template cambiano senza preavviso.

La mia pipeline CI può ricevere da sola codici SMS OTP dalla Colombia?

Sì. Crea l'attivazione dalla pipeline, attendi il webhook o interroga l'attivazione e passa il codice al test. La nostra nota sui test OTP in CI tratta timeout e pulizia.

Come faccio a sapere che un webhook proviene davvero da OTP Route?

Ogni richiesta include X-OTPRoute-Signature con un timestamp e un HMAC-SHA256 di quel timestamp, un punto e il corpo grezzo, calcolato con il secret del tuo endpoint. Ricalcolalo, confrontalo in tempo costante e scarta i timestamp obsoleti.

Ci sono limiti su ciò che posso verificare con un numero +57?

Sì. Usa i numeri solo per i tuoi prodotti e per account aziendali legittimi, rispetta i termini di ogni servizio e ricorda che la Acceptable Use Policy di OTP Route vale per ogni ordine.

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.