Verify – Übersicht

Bird Verify bestätigt, dass eine Person eine E-Mail-Adresse oder Telefonnummer kontrolliert. Fordern Sie Bird auf, einen Einmal-Bestätigungscode zu senden, erfassen Sie ihn in Ihrer App und fragen Sie Bird, ob er übereinstimmt. Der Ablauf verwendet zwei API-Aufrufe: POST /v1/verify/verifications sendet den Code und POST /v1/verify/verifications/check prüft ihn. Die gemeinsam genutzten Absender von Bird erfordern keine Absenderregistrierung und kein Template-Setup. E-Mail, SMS und WhatsApp können standardmäßig Bird Verify, Authifly oder einen Absender Ihres Workspace verwenden; Telegram nutzt ein eigenes verifiziertes Benachrichtigungskonto. Absender und Branding behandelt die Auswahl.

Sie erstellen eine Verifizierung mit einem Empfänger: einer E-Mail-Adresse, einer Telefonnummer oder beidem. Bird erzeugt einen numerischen Bestätigungscode und stellt ihn über die Kanäle des Empfängers zu. Eine E-Mail-Adresse erhält den Code per E-Mail; eine Telefonnummer erhält ihn per SMS oder WhatsApp, in der Reihenfolge und Verfügbarkeit, die Ihre Länderkonfiguration für das Zielland festlegt. Die Person gibt den Code in Ihre App ein, und Sie übermitteln ihn an den Check-Endpoint, der mit success: true oder false samt Begründung antwortet.

Eine Verifizierung durchläuft einen kleinen Lebenszyklus: Sie startet mit pending und endet mit verified (ein korrekter Code kam rechtzeitig an), failed (zu viele Fehlversuche) oder expired (das Zeitfenster ist abgelaufen). Die Seite Verifications zeigt jede Verifizierung und ihren Status; jeder Status und jede Begründung wird unter Verifizierungen senden behandelt.

Im Dashboard ist Verify eine der Apps des Workspace. Die Seiten und wo die jeweilige Anleitung zu finden ist:

Die Seite Verifications listet jede Verifizierung im Workspace auf und zeigt Empfänger, Kanalplan und Zeitdetails. Programmatisch liefert die Check-Antwort den aktuellen Status der Verifizierung. Abonnieren Sie Verify-Events für Erstellungs-, Zustellungs- und erfolgreiche Verifizierungsupdates. List- und Read-Endpoints stehen dem Dashboard zur Verfügung, nicht aber der öffentlichen API.

Verify stellt Codes über vier Kanäle zu. Welchen Kanal ein Empfänger erhält, hängt vom Empfängertyp und bei Telefonnummern von Ihrer Länderkonfiguration ab.

Bei einem Telefonempfänger wird WhatsApp zuerst versucht, und SMS dient in den meisten Ländern als Fallback, wobei einige standardmäßig SMS zuerst verwenden. Telegram steht in der Plattform-Fallback-Reihenfolge nach SMS und vor E-Mail. Sie können die Reihenfolge ändern oder einen Kanal pro Land deaktivieren. Schlägt ein Sendeversuch fehl, rückt die Zustellung zum nächsten Kanal im Plan vor. Sie können auch manuell vorrücken, wenn eine Person meldet, dass der Code nicht angekommen ist; siehe Code über einen anderen Kanal senden. Absender und Branding zeigt jede Nachricht und die verfügbaren Absenderoptionen.

Ihr Workspace startet mit den Plattformstandards von Bird für den Code selbst (Länge, Gültigkeitsdauer), das Limit für Prüfversuche und den Cooldown für erneutes Senden. Alles ist im Dashboard unter Configure anpassbar, die Codelänge auch pro Anfrage; Werte und Bereiche finden Sie unter Verifizierungseinstellungen. Darüber hinaus greifen Missbrauchs-Schutzmechanismen, die Sie nicht konfigurieren: Sende- und Prüflimits pro Empfänger, aufgeführt unter Missbrauchs-Schutzmechanismen. Die Code-Nachricht verwendet standardmäßig die Sprache der Telefonnummer des Empfängers, eine von 40 integrierten Übersetzungen, und options.language überschreibt sie pro Anfrage. Siehe Nachrichtensprache.