Ricevere i codici SMS di Truecaller in modo programmatico

Che aspetto ha la catena di chiamate API per Truecaller?

L'id di servizio di Truecaller è truecaller e tutte le chiamate qui sotto vanno a https://otproute.com/api/v1 con una chiave Bearer il cui prefisso è or_live_.

1. GET /api/v1/countries restituisce gli id dei paesi; mettili in cache.
2. GET /api/v1/prices?country=<id>&service=truecaller restituisce il prezzo in tempo reale e indica se una rotta è aperta in questo momento.
3. POST /api/v1/activations con {"service": "truecaller", "country": "in"} (o qualsiasi altro id paese) riserva il numero e restituisce un id di attivazione.
4. Inserisci quel numero nell'app Truecaller sul tuo dispositivo di test e richiedi la verifica.
5. Il codice arriva come evento webhook activation.sms_received, oppure interroghi GET /api/v1/activations/{id}.
6. Se il test viene abbandonato, POST /api/v1/activations/{id}/cancel rimborsa subito.

Un account supporta 10 chiavi API, 5 endpoint webhook e 300 richieste al minuto. La guida all'integrazione dell'API tratta nuovi tentativi e timeout.

Come deve trattare il gestore del webhook gli eventi di Truecaller?

Ogni consegna porta X-OTPRoute-Signature: t=<unix>,v1=<hex>. Ricalcola l'HMAC-SHA256 su timestamp, un punto e corpo grezzo della richiesta con il secret dell'endpoint, confrontalo in tempo costante e rifiuta i timestamp troppo vecchi.

Basa tutta l'elaborazione sull'id di attivazione. I webhook possono essere ritentati, quindi un gestore che salva il codice due volte o fa avanzare un test due volte produrrà risultati instabili; controlla se l'attivazione è già contrassegnata come completata prima di agire. Tratta activation.expired e activation.cancelled come stati terminali che dicono al tuo test runner di smettere di aspettare. Il polling funziona come ripiego nello sviluppo locale, dove non c'è un endpoint pubblico.

Perché Truecaller chiede un numero di telefono?

Truecaller è un'app di identificazione delle chiamate e di blocco dello spam, e il numero di telefono è l'account. La registrazione conferma che l'utente controlla il numero prima della creazione del profilo, e il controllo si ripete quando l'app viene reinstallata o spostata su un nuovo dispositivo. Su alcuni dispositivi l'app può provare a verificare con una chiamata invece che con un SMS. Un numero dell'OTP Gateway cattura solo gli SMS, quindi una verifica basata sulla chiamata non produrrà un codice sull'attivazione; la finestra si esaurisce e il wallet viene rimborsato.

Motivi legittimi per cui i team verificano account Truecaller: controllare come vengono etichettati, per le persone di un dato mercato, i numeri di assistenza o di consegna in uscita di un'azienda, il QA su app che integrano l'identificazione del chiamante e il personale operativo che ha bisogno di un profilo di lavoro separato dal telefono personale.

Quali paesi hanno rotte per Truecaller?

L'istantanea in tempo reale elenca rotte Truecaller in 198 paesi, tra cui India, Pakistan, Bangladesh, Nigeria, Kenya, Egitto, Indonesia, Sri Lanka, Nepal, Arabia Saudita, Emirati Arabi Uniti, Brasile, Messico, Sudafrica, Regno Unito e Stati Uniti.

Scegli il paese in base al caso di test. Le etichette delle chiamate, le segnalazioni di spam e la lingua dell'app seguono il mercato, quindi per controllare come appare la tua linea di assistenza di Lagos serve una rotta nigeriana, non quella che risulta più economica. La disponibilità cambia durante la giornata; interroga l'endpoint dei prezzi prima di ogni esecuzione.

Le persone non sviluppatrici possono farlo dalla dashboard?

Sì. Accedi, apri l'OTP Gateway, scegli Truecaller e un paese, conferma il prezzo mostrato e il numero compare su una scheda di attivazione. Inseriscilo in Truecaller, richiedi il codice e lo vedrai sulla stessa scheda quando arriva l'SMS. La finestra di 20 minuti è visibile sulla scheda. Se non arriva nessun codice, o se annulli, l'intero importo torna automaticamente nel tuo wallet. Le ricariche funzionano con carta o USDT/USDC, con una fattura PDF via email per ciascuna; vedi i prezzi.

Perché un codice Truecaller potrebbe non arrivare?

Cause comuni:

• Truecaller ha rifiutato il numero perché lo considera virtuale. Alcuni servizi lo fanno; è per questo che ricevi un rimborso.
• L'app ha scelto la verifica tramite chiamata invece dell'SMS.
• La rotta era brevemente congestionata. Riprova più tardi o con un altro paese coerente con il tuo test.
• Il numero è stato inserito senza prefisso internazionale, oppure con uno 0 di troppo davanti.

Non martellare in ciclo l'endpoint degli ordini. Distanzia i tentativi e registra ogni id di attivazione per individuare gli schemi.

Quando ha più senso un Numero Dedicato per Truecaller?

Un numero monouso sparisce dopo l'attivazione. Se un profilo Truecaller deve essere riverificato in seguito, ad esempio il dispositivo di lavoro di un team di assistenza che viene reimpostato, usa invece un Numero Dedicato. Sono disponibili subito negli Stati Uniti e in Canada da $1.95/mese, ricevono SMS nella dashboard e tramite il webhook number.sms_received e si rinnovano dal wallet finché non li rilasci. Vedi i numeri virtuali.

Usa OTP Route solo per i tuoi account e prodotti legittimi: un account per persona o attività reale, nessuna segnalazione né modifica di etichette sui numeri di altre persone e pieno rispetto dei termini di Truecaller e dell'Acceptable Use Policy di OTP Route. Truecaller è un marchio del suo titolare e OTP Route non è affiliata ad esso.

Domande frequenti

Qual è l'id di servizio di Truecaller nell'API?

È truecaller. Abbinalo a un id paese in GET /api/v1/prices e nel corpo di POST /api/v1/activations.

Posso ricevere un OTP di Truecaller su un numero virtuale?

Spesso sì, ma non sempre; Truecaller può rifiutare i numeri che classifica come virtuali. Se entro 20 minuti non arriva nessun codice, l'addebito viene rimborsato automaticamente.

Perché Truecaller ha chiamato invece di inviare un SMS?

Su alcuni dispositivi l'app può scegliere la verifica tramite chiamata. I numeri dell'OTP Gateway catturano solo gli SMS, quindi richiedi l'opzione SMS se l'app la offre.

Quale paese scegliere per testare la verifica SMS di Truecaller?

Scegli il mercato su cui verte il tuo test, dato che etichette delle chiamate e lingua seguono il paese del numero. Controlla prima la disponibilità in tempo reale con l'endpoint dei prezzi.

Posso tenere lo stesso numero Truecaller per gli accessi futuri?

Sì, con un Numero Dedicato negli Stati Uniti o in Canada da $1.95/mese. I numeri monouso del Gateway non possono essere riutilizzati.

Come evito che le consegne duplicate dei webhook rovinino i miei test?

Rendi il gestore idempotente sull'id di attivazione e verifica la firma prima di fare qualsiasi cosa con il payload.

OTP Route è affiliata a Truecaller?

No. Truecaller è un marchio del suo titolare; OTP Route fornisce numeri per testare e gestire i tuoi account legittimi.

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.