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, und ein Sprachanruf kommt von einer Bird-Nummer, die für das Ziel ausgewählt wird. Absender und Branding behandelt die Auswahl.

Wie eine Verifizierung funktioniert

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, WhatsApp, Telegram oder Sprachanruf, 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.

Die Verify-App im Dashboard

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

Sichtbarkeit

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.

Kanäle

Verify stellt Codes über fünf 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 in den meisten Ländern zuerst WhatsApp versucht, und SMS dient als Fallback; einige Länder verwenden standardmäßig zuerst SMS. Telegram steht in der Plattform-Fallback-Reihenfolge nach SMS und vor E-Mail. Sprachanrufe sind nicht Teil der Plattform-Fallback-Reihenfolge. Ein Land nutzt sie daher erst, wenn Sie sie dort aktivieren, etwa um Personen zu erreichen, die keine Textnachricht empfangen können. 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.

Standardwerte und Limits

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.

Nächste Schritte