Workflow verifizieren
Ein Workflow definiert die Abfolge von Aktionen, die Vonage verwendet, um den Endbenutzer zu erreichen, den Sie mit einem PIN-Code verifizieren möchten. Sie können Ihren eigenen Workflow anpassen, indem Sie festlegen, welche Kanäle in welcher Reihenfolge verwendet werden sollen, und so Verifizierungsnachrichten an mehrere Telefonnummern, E-Mail-Adressen und mehr senden.
Der Arbeitsablauf wird mithilfe eines Arrays in Ihrem Überprüfungsantrag konfiguriert:
- Der erste Kanal in der Liste wird zuerst verwendet;
- Wenn die Nachricht nicht erfolgreich umgewandelt wird, wird der nächste Kanal in der Liste verwendet.
Im nachstehenden Beispiel würde zuerst die SMS versucht werden. Wenn die Umwandlung fehlschlägt, wird als Nächstes die Sprachübertragung verwendet.
curl -X POST "https://api.nexmo.com/v2/verify" \
-H "Authorization: Bearer $JWT" \
-H 'Content-Type: application/json' \
-d $'{
"brand": "TestVerify",
"locale": "es-es",
"code_length": 4,
"channel_timeout": 300,
"workflow": [
{
"channel": "sms",
"to": "'$PHONE_NUMBER'"
},
{
"channel": "voice",
"to": "'$PHONE_NUMBER'"
}
]
}'
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
brand | Ja | Zeichenfolge | Der Name Ihres Unternehmens oder Ihrer Dienstleistung, der dem Nutzer in der Bestätigungsmeldung angezeigt wird (Your Brand in diesem Beispiel) |
locale | Nein | Zeichenfolge | Gibt die Sprache für die 2FA-Nachricht an. Muss folgen ISO 639-1 Format (z.B., es-es für Spanisch). Siehe die Standort Leitfaden. |
channel_timeout | Nein | Integer | Geben Sie die Wartezeit (in Sekunden) an, bis der Verifizierungscode geliefert und vom Benutzer eingegeben wurde, um die Verifizierung abzuschließen, bevor der nächste Kanal versucht wird. Höchstwert: 900 Sekunden. |
code_length | Nein | Integer | Gibt die Länge des Verifizierungscodes an, die zwischen zwei Werten liegen kann 4 und 10 Ziffern. |
workflow | Ja | Array | Legt die Reihenfolge der Kanäle zur Übermittlung des OTP fest (z. B. SMS, Sprache). |
workflow.channel | Ja | Zeichenfolge | Der zu verwendende Lieferkanal (sms und voice im Beispiel). |
workflow.to | Ja | Zeichenfolge | Die Telefonnummer, an die das OTP gesendet werden soll, im E.164-Format (z. B., +44111223344). |
Prüfen Sie die API-Spezifikation für eine vollständige Liste der verfügbaren Parameter und detaillierte Beschreibungen.
Unterstützte Kanäle
Verify unterstützt mehrere Kanäle zur Bereitstellung von One-Time-Passwörtern (OTPs), je nach Benutzerpräferenzen und regionaler Konnektivität. Hier finden Sie einen Überblick über jeden unterstützten Kanal:
Stille Authentifizierung
Stille Authentifizierung ermöglicht es Ihnen, Endbenutzer zu verifizieren, ohne dass diese manuell ein OTP eingeben müssen. Die Funktion nutzt die Daten des Mobilfunknetzes im Hintergrund und sorgt so für ein besseres Nutzererlebnis. Es ist ideal, um Abbrüche bei der Anmeldung oder dem Login zu reduzieren.
Wenn Sie den Kanal für die stille Authentifizierung verwenden möchten, ist es wichtig zu beachten, dass es muss der erste Arbeitsablauf sein.
RCS
Als Erweiterung des SMS-Kanals ermöglicht RCS die Übermittlung von Nachrichten über Wi-Fi oder mobile Daten an Standard-Messaging-Apps auf Android und iPhone.
RCS ist aufgrund seiner Unterstützung für die Markenvalidierung und seiner geringen Übermittlungslatenz eine hervorragende Alternative zu SMS. Um den RCS-Kanal zu nutzen, muss ein RCS-Agent oder Absender-ID erforderlich ist.
Derzeit ist RCS in einer begrenzten Anzahl von Ländern und auf kompatiblen Geräten verfügbar, eine Ausweitung ist jedoch geplant.
SMS
SMS ist der beliebteste und am weitesten verbreitete Kanal für die Zwei-Faktoren-Authentifizierung (2FA).
Sie bietet eine große Reichweite, da fast jeder Textnachrichten empfangen kann, und das Onboarding ist nahtlos. Google fand sogar heraus, dass SMS 2FA beim Blockieren half:
- 100% der automatisierten Bots
- 96 % der Massenphishing-Angriffe
- 76 % der gezielten Angriffe
Aufgrund ihrer Zuverlässigkeit und Allgegenwärtigkeit ist die SMS oft der erste Kanal, der in einem Verify-Workflow versucht wird.
WhatsApp ist dank seiner weltweiten Popularität und der Möglichkeit, Nachrichten über WiFi zu versenden, ein hervorragender Kanal für die Zwei-Faktor-Authentifizierung, was es besonders wertvoll in Gebieten mit begrenzter Mobilfunkabdeckung macht.
Die Hinzufügung von WhatsApp als sekundärer Kanal kann die Konversionsraten Ihrer Verifizierung insgesamt erheblich verbessern.
Um Verify API mit WhatsApp zu nutzen, müssen Sie einen eigenen WhatsApp Business Account (WABA) haben. Um ein WABA zu erstellen, navigieren Sie zum Soziale Kanäle im Developer Dashboard und folgen Sie den Anweisungen unter WhatsApp.
Wenn ein Nutzer WhatsApp nicht installiert hat, kann Verify dies automatisch erkennen und auf einen anderen Kanal zurückgreifen.
Für nicht verwaltete Accounts wenden Sie sich bitte an Vertrieb um Verify für die Nutzung des WhatsApp Business Accounts Ihres Unternehmens zu konfigurieren. Für verwaltete Accounts wenden Sie sich bitte an Ihren zuständigen Account Manager.
Stimme
Die Sprachüberprüfung ist eine leistungsstarke Ergänzung zur SMS, insbesondere in Regionen, in denen:
- Die SMS-Zustellung ist unzuverlässig.
- Örtliche Vorschriften sehen Einschränkungen vor oder verlangen eine Vorregistrierung für den SMS-Verkehr.
Bei Sprachanrufen wird das OTP über einen automatisierten Telefonanruf übermittelt, so dass auch Nutzer in schwer zugänglichen Regionen den Verifizierungsprozess zuverlässig abschließen können.
E-Mail kann auch für die Übermittlung von OTPs verwendet werden und ist damit eine gute Alternative zu mobilen Kanälen.
Sie ist besonders nützlich:
- In Zeiten der Überlastung des Netzes.
- Für Benutzer, die es vorziehen, Bestätigungen über ihr E-Mail-Konto zu erhalten.
Unsere E-Mail-Lösung unterstützt die Domainregistrierung. Wenn Sie planen, die E-Mail-Verifizierung mit Verify auf ein hohes Volumen zu skalieren, und Sie ein nicht verwalteter Kunde sind, kontaktieren Sie bitte Vertrieb um Ihren Account richtig zu konfigurieren. Für verwaltete Accounts wenden Sie sich bitte an Ihren zuständigen Account Manager.