Programowe odbieranie kodów SMS z Truecaller

Jak wygląda łańcuch wywołań API dla Truecaller?

Id usługi Truecaller to truecaller, a każde poniższe wywołanie kierujesz na https://otproute.com/api/v1 z kluczem Bearer o prefiksie or_live_.

1. GET /api/v1/countries zwraca id krajów; zapisz je w pamięci podręcznej.
2. GET /api/v1/prices?country=<id>&service=truecaller zwraca aktualną cenę i informację, czy trasa jest teraz otwarta.
3. POST /api/v1/activations z {"service": "truecaller", "country": "in"} (lub dowolnym innym id kraju) rezerwuje numer i zwraca id aktywacji.
4. Wpisz ten numer w aplikacji Truecaller na urządzeniu testowym i poproś o weryfikację.
5. Kod przychodzi jako zdarzenie webhooka activation.sms_received, albo odpytujesz GET /api/v1/activations/{id}.
6. Jeśli test zostanie porzucony, POST /api/v1/activations/{id}/cancel zwraca środki od razu.

Konto obsługuje 10 kluczy API, 5 endpointów webhooków i 300 żądań na minutę. Przewodnik integracji API omawia ponowienia i limity czasu.

Jak handler webhooka ma traktować zdarzenia Truecaller?

Każda dostawa niesie X-OTPRoute-Signature: t=<unix>,v1=<hex>. Oblicz ponownie HMAC-SHA256 ze znacznika czasu, kropki i surowej treści żądania przy użyciu sekretu endpointu, porównaj w stałym czasie i odrzucaj zbyt stare znaczniki czasu.

Kluczuj całe przetwarzanie po id aktywacji. Webhooki mogą być ponawiane, więc handler, który zapisze kod dwa razy albo dwukrotnie posunie test naprzód, da niestabilne wyniki; przed działaniem sprawdź, czy aktywacja nie jest już oznaczona jako zakończona. Traktuj activation.expired i activation.cancelled jako stany końcowe, które mówią uruchamiaczowi testów, by przestał czekać. Odpytywanie działa jako rozwiązanie zapasowe w lokalnym rozwoju, gdzie nie ma publicznego endpointu.

Dlaczego Truecaller w ogóle prosi o numer telefonu?

Truecaller to aplikacja do identyfikacji dzwoniących i blokowania spamu, a numer telefonu jest kontem. Rejestracja potwierdza, że użytkownik kontroluje numer, zanim powstanie profil, a sprawdzenie powtarza się po ponownej instalacji aplikacji lub przeniesieniu na nowe urządzenie. Na niektórych urządzeniach aplikacja może próbować weryfikacji połączeniem zamiast SMS-em. Numer z OTP Gateway przechwytuje wyłącznie SMS-y, więc weryfikacja przez połączenie nie wygeneruje kodu w aktywacji; okno po prostu się kończy, a portfel zostaje zwrócony.

Uprawnione powody weryfikowania kont Truecaller w zespołach to sprawdzenie, jak numery wychodzącego wsparcia lub dostaw firmy są oznaczane dla osób na danym rynku, QA aplikacji integrujących identyfikację dzwoniących oraz pracownicy operacyjni, którzy potrzebują profilu służbowego odrębnego od prywatnego telefonu.

W których krajach są trasy Truecaller?

Bieżący zrzut wymienia trasy Truecaller w 198 krajach, między innymi w Indiach, Pakistanie, Bangladeszu, Nigerii, Kenii, Egipcie, Indonezji, Sri Lance, Nepalu, Arabii Saudyjskiej, Zjednoczonych Emiratach Arabskich, Brazylii, Meksyku, RPA, Wielkiej Brytanii i Stanach Zjednoczonych.

Wybierz kraj odpowiadający przypadkowi testowemu. Etykiety dzwoniących, zgłoszenia spamu i język aplikacji zależą od rynku, więc sprawdzenie, jak wyświetla się Twoja linia wsparcia w Lagos, powinno używać trasy nigeryjskiej, a nie tej, która akurat jest najtańsza. Dostępność zmienia się w ciągu dnia; przed każdym uruchomieniem zapytaj endpoint cen.

Czy osoby nietechniczne zrobią to z panelu?

Tak. Zaloguj się, otwórz OTP Gateway, wybierz Truecaller i kraj, potwierdź wyświetloną cenę, a numer pojawi się na karcie aktywacji. Wpisz go w Truecaller, poproś o kod, a gdy SMS dotrze, zobaczysz go na tej samej karcie. 20-minutowe okno jest widoczne na karcie. Jeśli kod nie dotrze albo anulujesz zamówienie, cała kwota automatycznie wraca do portfela. Portfel doładujesz kartą lub USDT/USDC, a za każde doładowanie dostaniesz e-mailem fakturę PDF; zobacz cennik.

Dlaczego kod z Truecaller może nie dotrzeć?

Częste przyczyny:

• Truecaller odrzucił numer, ponieważ traktuje go jako wirtualny. Niektóre usługi tak robią; dlatego dostajesz zwrot.
• Aplikacja wybrała weryfikację przez połączenie zamiast SMS-a.
• Trasa była chwilowo przeciążona. Spróbuj później albo z innym krajem pasującym do testu.
• Numer został wpisany bez numeru kierunkowego kraju albo ze zbędnym zerem wiodącym.

Nie zasypuj endpointu zamówień w pętli. Rozłóż próby w czasie i loguj id każdej aktywacji, aby widzieć wzorce.

Kiedy Dedicated Number ma więcej sensu dla Truecaller?

Numer jednorazowy znika po aktywacji. Jeśli profil Truecaller trzeba będzie zweryfikować ponownie, na przykład na służbowym urządzeniu zespołu wsparcia, które zostaje zresetowane, użyj Dedicated Number. Są dostępne od ręki w Stanach Zjednoczonych i Kanadzie od $1.95/miesiąc, odbierają SMS-y w panelu i przez webhook number.sms_received, a odnawiają się z portfela, dopóki ich nie zwolnisz. Zobacz numery wirtualne.

Używaj OTP Route wyłącznie do własnych, legalnych kont i produktów: jedno konto na realną osobę lub firmę, żadnych zgłoszeń ani zmian etykiet dotyczących cudzych numerów oraz pełne poszanowanie regulaminu Truecaller i Acceptable Use Policy OTP Route. Truecaller jest znakiem towarowym swojego właściciela, a OTP Route nie jest z nim powiązane.

Najczęstsze pytania

Jakie jest id usługi Truecaller w API?

To truecaller. Połącz je z id kraju w GET /api/v1/prices i w treści POST /api/v1/activations.

Czy mogę odebrać OTP z Truecaller na numerze wirtualnym?

Często tak, ale nie zawsze; Truecaller może odrzucać numery, które klasyfikuje jako wirtualne. Jeśli kod nie dotrze w ciągu 20 minut, opłata jest zwracana automatycznie.

Dlaczego Truecaller zadzwonił zamiast wysłać SMS?

Aplikacja może na niektórych urządzeniach wybrać weryfikację przez połączenie. Numery OTP Gateway przechwytują wyłącznie SMS-y, więc poproś o opcję SMS, jeśli aplikacja ją oferuje.

Jaki kraj wybrać do testów weryfikacji SMS Truecaller?

Wybierz rynek, którego dotyczy test, ponieważ etykiety dzwoniących i język zależą od kraju numeru. Najpierw sprawdź aktualną dostępność w endpoincie cen.

Czy mogę zachować ten sam numer Truecaller do późniejszych logowań?

Tak, dzięki Dedicated Number w Stanach Zjednoczonych lub Kanadzie od $1.95/miesiąc. Jednorazowych numerów z bramki nie można użyć ponownie.

Jak zapobiec temu, by zduplikowane dostawy webhooków psuły moje testy?

Spraw, by handler był idempotentny po id aktywacji i zweryfikuj podpis, zanim zrobisz cokolwiek z danymi.

Czy OTP Route jest powiązane z Truecaller?

Nie. Truecaller jest znakiem towarowym swojego właściciela; OTP Route dostarcza numery do testowania i obsługi własnych, legalnych kont.

Nazwy usług są znakami towarowymi ich właścicieli. OTP Route nie jest z nimi powiązany. Korzystaj z numerów zgodnie z prawem oraz przestrzegaj regulaminów poszczególnych usług i naszej Polityki akceptowalnego użytkowania.