Telefonverifizierungs-API: OTP, SMS & WhatsApp

Die Telefonverifizierung von Didit bietet eine zuverlässige Methode zur Verifizierung der Telefonnummern von Benutzern mittels Einmalcodes (OTP). Diese Funktion fügt Ihrem Identitätsverifizierungsprozess eine wesentliche Sicherheitsebene hinzu und stellt sicher, dass die Kontaktinformationen der Benutzer legitim sind. In der Academy-Lektion zum Auslesen eines Verifizierungsergebnisses behandelt das Kapitel bei 8:08 die Telefonverifizierung und die Duplikatserkennung.

​

Funktionsweise

Unsere Telefonverifizierungslösung bietet eine umfassende Validierung von Telefonnummern über einen einfachen, benutzerfreundlichen Prozess. Das System kombiniert die OTP-Verifizierung mit einer fortschrittlichen Risikobewertung, um eine zuverlässige Telefonverifizierung im großen Maßstab zu ermöglichen.

​

Verifizierungsfunktionen

Unser Telefonverifizierungs-Service bietet mehrere wichtige Funktionen zur Optimierung Ihres Verifizierungsprozesses:

​

OTP-Verifizierung

• Sichere Codegenerierung: Zufällig generierte Einmalcodes
• SMS-Zustellung: Schnelle und zuverlässige Zustellung an Mobilgeräte
• Konfigurierbare Timeouts: Legen Sie Ablaufzeiten basierend auf Ihren Sicherheitsanforderungen fest
• Wiederholungsoptionen: Ermöglichen Sie Benutzern das Anfordern neuer Codes mit einem angemessenen Rate-Limit
• Gebrandete Codes: SMS-Codes nennen Ihre Marke, anstatt eine generische Nachricht zu senden – ohne zusätzliche Kosten. Siehe Gebrandete Verifizierungsnachrichten.
• Eigene WhatsApp-Nummer: WhatsApp-Codes können von Ihrer eigenen WhatsApp-Business-Nummer stammen. Siehe WhatsApp-Codes von Ihrer eigenen Nummer senden.

​

Gebrandete Verifizierungsnachrichten

SMS-Verifizierungscodes können Ihre Marke nennen, damit Ihre Benutzer die Nachricht als Ihre erkennen:

123456 ist Ihr Verifizierungscode für Acme Bank

Nur der Name kann angepasst werden. Der Rest des Wortlauts ist ein Standardtext, der bei Mobilfunkanbietern in jedem Land registriert ist, was verhindert, dass Codes als Spam gefiltert werden, und er wird in die Sprache des Empfängers übersetzt. Branding ist kostenlos: Ein gebrandeter Code kostet genauso viel wie ein ungebrandeter. Legen Sie Ihren SMS-Absendernamen fest in der Business Console unter Phone Verification → Settings eines Workflows oder unter White Label → SMS. Er gehört zu Ihrer Anwendung, nicht zu einem einzelnen Workflow: Er signiert jeden SMS-Code, den die Anwendung sendet, in jedem Workflow und über die Standalone-API, mit oder ohne White-Label-Anpassung. Welchen Namen ein Code trägt, die erste Übereinstimmung gilt:

1. options.sms_sender_name bei POST /v3/phone/send/, für diesen einzelnen Code.
2. Der SMS-Absendername Ihrer Anwendung.
3. Nur bei White-Label-Versendungen (ein Workflow mit White-Label-Anpassung oder options.use_white_label_customization: true über die API): Ihr öffentlicher White-Label-Name.
4. Andernfalls wird der Code ohne Namen gesendet.

Ein Absendername umfasst 1 bis 30 Zeichen: nur Buchstaben, Ziffern, Leerzeichen sowie ’ & - !, nicht nur Ziffern, mit jeweils einem Leerzeichen zwischen Wörtern. Die API weist einen Namen außerhalb dieser Regeln mit 400 ab, bevor ein Code gesendet wird.

• Kanäle: Der Name wird zu SMS-Nachrichten hinzugefügt, einschließlich einer SMS, die als Fallback von einem anderen Kanal gesendet wird. WhatsApp-Codes werden mit einer festen Nachricht gesendet und enthalten ihn nicht; um Ihren Unternehmensnamen darauf anzuzeigen, senden Sie sie von Ihrer eigenen Nummer.
• Änderungen pro Tag: Jede Anwendung kann pro Tag (UTC) bis zu zwei neue Namen in Betrieb nehmen, wobei sowohl neue Absendernamen als auch neue sms_sender_name-Werte zählen. Danach behalten Codes bis zum nächsten Tag den aktuellen Namen der Anwendung, und ein neuer Name pro Anfrage wird mit dem Namen der Anwendung gesendet. Ein zuvor bereits verwendeter Name zählt nicht erneut.
• Zustellung hat Vorrang: Ein Branding-Problem hält einen Code niemals auf. Wenn ein Name nicht angewendet werden kann, wird der Code mit dem Namen der Anwendung oder ohne Namen gesendet.

​

Eigenen SMS-Text und eigene Absender-ID festlegen

Sie können den Text Ihrer SMS-Codes und den Absender, den Ihre Benutzer sehen, ersetzen. Legen Sie beides in der Business Console unter White Label → SMS fest. Sie gehören wie der SMS-Absendername zu Ihrer Anwendung und gelten für jeden SMS-Code, den sie sendet – in jedem Workflow und über die Standalone-API. Ihr eigener Text wird pro Sprache verfasst. Ein Code wird mit Ihrem Text gesendet, wenn Sie einen für die Sprache verfasst haben, in der der Code gesendet wird; alle anderen Sprachen behalten den übersetzten Text von Didit. Verwenden Sie {code} für den Code und optional {brand} für Ihren SMS-Absendernamen, zum Beispiel Acme: {code} is your login code for {brand}. Ein Text muss:

• {code} genau einmal enthalten und keinen anderen Platzhalter außer {code} und {brand};
• keine Links enthalten: Mobilfunkanbieter blockieren Verifizierungscodes, die Links enthalten;
• mit einem 8-stelligen Code und einem 30-Zeichen-Namen in eine einzelne SMS passen: bis zu 160 Zeichen oder 70, wenn Zeichen außerhalb des lateinischen Basisalphabets verwendet werden (beispielsweise kyrillisch, arabisch oder Emojis).

Ihre eigene Absender-ID verwendet 3 bis 11 Buchstaben, Ziffern und Leerzeichen, nicht nur Ziffern, zum Beispiel AcmeBank. Sie wird in den Ländern verwendet, in denen Didit benutzerdefinierte Absender-IDs aktiviert – das sind die Länder, deren Mobilfunkanbieter einen Absendernamen ohne vorherige Registrierung akzeptieren; überall sonst werden Ihre Codes unter dem Absender von Didit versendet. Wenden Sie sich an den Support, um ein Land anzufragen, bei dem der Absender registriert werden muss.

• Zustellung hat Vorrang: Wenn ein Code über eine Route erneut gesendet wird, die Ihren Text oder Ihre Absender-ID nicht übermitteln kann, wird er mit Didits Text, Ihrem SMS-Absendernamen und Didits Absender gesendet, damit der Code immer ankommt.

​

WhatsApp-Codes von Ihrer eigenen Nummer senden

Standardmäßig stammen WhatsApp-Codes von Didits WhatsApp-Business-Nummer. Sie können stattdessen Ihre eigene WhatsApp-Business-Nummer verknüpfen, sodass Ihre Benutzer ihre Codes unter Ihrem Unternehmensnamen und Ihrer Nummer erhalten. Verknüpfen Sie eine Nummer in der Business Console unter Phone Verification → Settings → WhatsApp number eines Workflows und wählen Sie Connect WhatsApp number. Ein Anmeldefenster öffnet sich: Melden Sie sich bei dem Unternehmenskonto an, das Ihre WhatsApp-Business-Nummer verwaltet, und wählen Sie dann das WhatsApp-Business-Konto sowie die Nummer aus, von der gesendet werden soll. Didit registriert die Nummer anschließend für den Versand und erstellt deren Verifizierungsnachricht. Dafür ist die Berechtigung zum Bearbeiten von Anpassungen erforderlich, wie auch beim SMS-Absendernamen. Die Nummer gehört zu Ihrer Anwendung, nicht zu einem einzelnen Workflow: Sobald sie verknüpft ist, sendet sie jeden WhatsApp-Code, den die Anwendung sendet – in jedem Workflow und über die Standalone-API.

• Genehmigung: Die neue Verifizierungsnachricht benötigt eine Genehmigung, bevor die Nummer Codes senden kann, in der Regel innerhalb weniger Minuten. Die Karte zeigt die Nummer bis dahin als auf Genehmigung wartend an, und Codes werden in der Zwischenzeit weiterhin von Didits Nummer versendet.
• Nachrichtentext: Verifizierungsnachrichten auf WhatsApp verwenden einen Standardtext in der Sprache Ihres Benutzers: den Code, einen Sicherheitshinweis und eine Schaltfläche zum Kopieren. Der Text kann nicht bearbeitet werden, aber der Absender ist Ihr Unternehmen.
• Zustellung: Wenn ein Code nicht über WhatsApp zugestellt werden kann, wird er per SMS gesendet, signiert mit Ihrem SMS-Absendernamen.
• Abrechnung: Die von Ihrer Nummer gesendeten Nachrichten werden über Ihr WhatsApp-Business-Konto abgerechnet, sodass Didit für diese Codes nur seine Verifizierungsgebühr ($0.02) berechnet. Per SMS gesendete Codes werden wie gewohnt abgerechnet.
• Handlungsbedarf: Wenn die Nummer nicht mehr senden kann (wenn beispielsweise der Zugriff aus Ihrem Unternehmenskonto entfernt wurde), werden Codes wieder von Didits Nummer gesendet und die Karte fordert Sie auf, die Nummer erneut zu verknüpfen.
• Trennen Sie die Verbindung jederzeit über dieselbe Karte. Codes werden wieder von Didits Nummer gesendet; die Nummer und ihre Verifizierungsnachricht verbleiben in Ihrem WhatsApp-Business-Konto.

​

Telefonnummernanalyse

• Formatvalidierung: Sicherstellen, dass die Telefonnummer dem korrekten internationalen Format entspricht
• Netzbetreibererkennung: Den mit der Nummer verknüpften Telekommunikationsanbieter identifizieren
• Nummerntyp: Zwischen Mobilfunk-, Festnetz- und VoIP-Nummern unterscheiden
• Ländervalidierung: Überprüfen, ob die Telefonnummer dem erwarteten Länderformat entspricht

​

Risikobewertung

• Erkennung von Wegwerfnummern: Temporäre Nummern identifizieren, die verwendet werden, um eine Rückverfolgung zu vermeiden
• Identifizierung virtueller Nummern: Nummern kennzeichnen, bei denen es sich um virtuelle oder VoIP-basierte Nummern handeln könnte
• Aktivitätsüberwachung: Verdächtige Muster über Verifizierungsversuche hinweg nachverfolgen
• Sperrlistenprüfung: Abgleich mit internen Listen zuvor missbräuchlich genutzter Nummern

​

Preise

Die Telefonverifizierung wird pro gesendeter Nachricht mit transparenten, nutzungsabhängigen Preisen abgerechnet: Ihr Tarifrabatt gilt ausschließlich für die Didit-Gebühr von $0.02; die Netzbetreibergebühr wird zum Selbstkostenpreis weitergegeben und niemals rabattiert. Siehe Rabatte. Wir unterstützen mehrere Zustellungskanäle mit unterschiedlichen Preisen (die Verfügbarkeit variiert je nach Land): → Preise für die Telefonverifizierung