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

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

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.