Truecaller-SMS-Codes programmatisch empfangen

Wie sieht die API-Aufrufkette für Truecaller aus?

Die Dienst-ID von Truecaller lautet truecaller, und jeder der folgenden Aufrufe geht gegen https://otproute.com/api/v1 mit einem Bearer-Schlüssel, dessen Präfix or_live_ ist.

1. GET /api/v1/countries liefert die Länder-IDs; speichern Sie sie zwischen.
2. GET /api/v1/prices?country=<id>&service=truecaller gibt den aktuellen Preis zurück und zeigt, ob gerade eine Route offen ist.
3. POST /api/v1/activations mit {"service": "truecaller", "country": "in"} (oder einer anderen Länder-ID) reserviert die Nummer und gibt eine Aktivierungs-ID zurück.
4. Tragen Sie diese Nummer in der Truecaller-App auf Ihrem Testgerät ein und fordern Sie die Verifizierung an.
5. Der Code kommt als Webhook-Ereignis activation.sms_received, oder Sie fragen GET /api/v1/activations/{id} per Polling ab.
6. Wird der Test abgebrochen, erstattet POST /api/v1/activations/{id}/cancel sofort.

Ein Konto unterstützt 10 API-Schlüssel, 5 Webhook-Endpoints und 300 Anfragen pro Minute. Der Leitfaden zur API-Integration behandelt Wiederholungen und Timeouts.

Wie sollte der Webhook-Handler Truecaller-Ereignisse behandeln?

Jede Zustellung trägt X-OTPRoute-Signature: t=<unix>,v1=<hex>. Berechnen Sie HMAC-SHA256 über Zeitstempel, einen Punkt und den rohen Request-Body mit Ihrem Endpoint-Secret neu, vergleichen Sie in konstanter Zeit und weisen Sie zu alte Zeitstempel ab.

Verwenden Sie die Aktivierungs-ID als Schlüssel für die gesamte Verarbeitung. Webhooks können wiederholt werden; ein Handler, der den Code zweimal speichert oder einen Test zweimal weiterschaltet, erzeugt instabile Ergebnisse. Prüfen Sie daher, ob die Aktivierung bereits als abgeschlossen markiert ist, bevor Sie handeln. Behandeln Sie activation.expired und activation.cancelled als Endzustände, die Ihrem Test-Runner sagen, dass er nicht mehr warten soll. Polling funktioniert als Rückfallebene für die lokale Entwicklung, wo kein öffentlicher Endpoint existiert.

Warum verlangt Truecaller überhaupt eine Telefonnummer?

Truecaller ist eine App für Anruferkennung und Spam-Blockierung, und die Telefonnummer ist das Konto. Die Registrierung bestätigt, dass die Nutzenden die Nummer kontrollieren, bevor das Profil entsteht, und die Prüfung wiederholt sich, wenn die App neu installiert oder auf ein neues Gerät übertragen wird. Auf manchen Geräten versucht die App möglicherweise, per Anruf statt per SMS zu verifizieren. Eine OTP-Gateway-Nummer erfasst nur SMS, daher erzeugt eine anrufbasierte Prüfung keinen Code in der Aktivierung; das Fenster läuft einfach ab und das Guthaben wird erstattet.

Legitime Gründe, Truecaller-Konten zu verifizieren, sind etwa die Kontrolle, wie die ausgehenden Support- oder Liefernummern eines Unternehmens für Menschen in einem bestimmten Markt gekennzeichnet werden, QA bei Apps, die Anruferidentifikation einbinden, und Betriebsmitarbeitende, die ein Arbeitsprofil getrennt vom privaten Telefon brauchen.

Welche Länder haben Truecaller-Routen?

Der Live-Stand listet Truecaller-Routen in 198 Ländern, darunter Indien, Pakistan, Bangladesch, Nigeria, Kenia, Ägypten, Indonesien, Sri Lanka, Nepal, Saudi-Arabien, die Vereinigten Arabischen Emirate, Brasilien, Mexiko, Südafrika, das Vereinigte Königreich und die USA.

Wählen Sie das Land passend zum Testfall. Anruferkennzeichnungen, Spam-Meldungen und die Sprache der App richten sich nach dem Markt; wer prüfen will, wie die Support-Leitung in Lagos erscheint, sollte eine nigerianische Route nutzen und nicht die, die gerade am günstigsten ist. Die Verfügbarkeit ändert sich im Tagesverlauf; fragen Sie vor jedem Lauf den Preis-Endpoint ab.

Können Nicht-Entwickler das über das Dashboard erledigen?

Ja. Melden Sie sich an, öffnen Sie das OTP Gateway, wählen Sie Truecaller und ein Land, bestätigen Sie den angezeigten Preis, und die Nummer erscheint auf einer Aktivierungskarte. Tragen Sie sie in Truecaller ein, fordern Sie den Code an, und er erscheint auf derselben Karte, sobald die SMS eintrifft. Das 20-Minuten-Fenster ist auf der Karte sichtbar. Kommt kein Code oder stornieren Sie, wird der volle Betrag automatisch Ihrem Guthaben gutgeschrieben. Aufladungen funktionieren per Karte oder USDT/USDC, mit einer PDF-Rechnung per E-Mail für jede; siehe Preise.

Warum kommt ein Truecaller-Code möglicherweise nicht an?

Häufige Ursachen:

• Truecaller hat die Nummer abgelehnt, weil es sie als virtuell einstuft. Manche Dienste tun das; deshalb werden Sie erstattet.
• Die App hat die anrufbasierte Verifizierung statt SMS gewählt.
• Die Route war kurzzeitig überlastet. Versuchen Sie es später oder mit einem anderen Land, das zu Ihrem Test passt.
• Die Nummer wurde ohne Ländervorwahl oder mit einer überflüssigen führenden Null (nationales Präfix) eingegeben.

Bearbeiten Sie den Bestell-Endpoint nicht in einer Schleife. Legen Sie Abstände zwischen die Versuche und protokollieren Sie jede Aktivierungs-ID, damit Sie Muster erkennen.

Wann ist für Truecaller eine Dedicated Number sinnvoller?

Eine Einmalnummer ist nach der Aktivierung weg. Muss ein Truecaller-Profil später erneut verifiziert werden, etwa auf dem zurückgesetzten Arbeitsgerät eines Support-Teams, nutzen Sie stattdessen eine Dedicated Number. Diese sind sofort in den USA und Kanada ab $1.95/Monat verfügbar, empfangen SMS im Dashboard und über den Webhook number.sms_received und verlängern sich aus dem Guthaben, bis Sie sie freigeben. Siehe virtuelle Nummern.

Nutzen Sie OTP Route nur für Ihre eigenen legitimen Konten und Produkte: ein Konto pro realer Person oder Unternehmen, keine Meldungen oder Label-Änderungen gegen die Nummern anderer Personen und volle Beachtung der Bedingungen von Truecaller sowie der Acceptable Use Policy von OTP Route. Truecaller ist eine Marke ihres Inhabers, und OTP Route ist nicht mit dem Unternehmen verbunden.

Häufige Fragen

Wie lautet die Dienst-ID für Truecaller in der API?

Sie lautet truecaller. Kombinieren Sie sie in GET /api/v1/prices und im Body von POST /api/v1/activations mit einer Länder-ID.

Kann ich einen Truecaller-OTP auf einer virtuellen Nummer empfangen?

Oft, aber nicht immer; Truecaller kann Nummern ablehnen, die es als virtuell einstuft. Kommt innerhalb von 20 Minuten kein Code an, wird die Zahlung automatisch erstattet.

Warum hat Truecaller angerufen, statt eine SMS zu senden?

Die App kann auf manchen Geräten die anrufbasierte Verifizierung wählen. OTP-Gateway-Nummern erfassen nur SMS; fordern Sie daher die SMS-Option an, falls die App sie anbietet.

Welches Land sollte ich für Tests der Truecaller-SMS-Verifizierung wählen?

Das Land des Marktes, um den es in Ihrem Test geht, denn Anruferkennzeichnungen und Sprache folgen dem Land der Nummer. Prüfen Sie vorher über den Preis-Endpoint die Live-Verfügbarkeit.

Kann ich dieselbe Truecaller-Telefonnummer für spätere Anmeldungen behalten?

Ja, mit einer Dedicated Number in den USA oder Kanada ab $1.95/Monat. Einmalige Gateway-Nummern lassen sich nicht wiederverwenden.

Wie verhindere ich, dass doppelte Webhook-Zustellungen meine Tests stören?

Machen Sie den Handler anhand der Aktivierungs-ID idempotent und prüfen Sie die Signatur, bevor Sie mit der Payload irgendetwas tun.

Ist OTP Route mit Truecaller verbunden?

Nein. Truecaller ist eine Marke ihres Inhabers; OTP Route stellt Nummern zum Testen und für den Betrieb Ihrer eigenen legitimen Konten bereit.

Dienstnamen sind Marken ihrer jeweiligen Inhaber. OTP Route steht in keiner Verbindung zu ihnen. Nutzen Sie die Nummern rechtmäßig und beachten Sie die Bedingungen des jeweiligen Dienstes sowie unsere Richtlinie zur akzeptablen Nutzung.