Arbeitsabläufe und Ereignisse

Verify API bietet die beste Möglichkeit, Ihre Nutzer zu erreichen, indem es SMS- und TTS-Anrufe (Text-To-Speech) nacheinander kombiniert. Das Grundmodell ist, dass Sie, wenn Sie eine Verify-Anfrage erstellenwird ihm ein request_id und Vonage beginnt mit der Abfolge von Aktionen, um den Benutzer mit einem PIN-Code zu erreichen. Wenn der Benutzer Ihnen den Code sendet, senden Sie den Code zusammen mit dem request_id durch zu Vonage zu Prüfen Sie, ob der Code korrekt ist..

Wenn Sie den Code senden und request_idVonage bestätigt, ob der Code den Erwartungen entspricht (oder nicht). Bei erfolgreicher Überprüfung wird die Sequenz gestoppt und es werden keine weiteren Anrufe oder Nachrichten an den Benutzer gesendet. Wenn die Überprüfung nicht erfolgreich war, wird die Sequenz fortgesetzt und bleibt aktiv, bis entweder die PIN abgelaufen ist oder drei falsche Codes gesendet wurden.

Mit der Verify-API können Sie den besten Workflow für Ihren Anwendungsfall auswählen. Dies kann von der Art der Überprüfung, den Präferenzen Ihrer Nutzer oder deren geografischem Standort abhängen. Sie können den zu verwendenden Workflow für jede Verify-API-Anfrage festlegen, indem Sie den workflow_id Feld auf einen ganzzahligen Wert 1-7. Die Einzelheiten dieser voreingestellten Arbeitsabläufe werden im Folgenden erläutert.

Sie können das Erlebnis weiter anpassen, indem Sie Einstellung der Zeitpunkte wenn Sie eine Verify-Anfrage erstellen, und können den nächsten Überprüfungsversuch auslösen programmatisch, wenn Sie dies wünschen.

Workflow 1 (Standard-Workflow): SMS -> TTS -> TTS

Senden Sie einen PIN-Code per Textnachricht und rufen Sie anschließend zweimal an, wenn die Anfrage noch nicht verifiziert wurde.

  1. Senden Sie SMS an Benutzer mit PIN-Code
  2. Warten auf next_event_wait Sekunden (Standardwartezeit: 125 Sekunden)
  3. Benutzer anrufen und mitteilen TTS PIN-Code
  4. Warten auf next_event_wait Sekunden (Standardwartezeit: 180 Sekunden)
  5. (Bei der Standardeinstellung läuft die PIN ab und es wird eine neue generiert; steuern Sie dies durch Setzen der pin_expiry Feld)
  6. Benutzer anrufen und mitteilen TTS PIN-Code
  7. Warten auf next_event_wait Sekunden (Standardwartezeit: 300 Sekunden)
  8. Antrag läuft ab

Arbeitsablauf 2: SMS -> SMS -> TTS

Senden Sie einen PIN-Code per Textnachricht, folgen Sie mit einer zweiten Textnachricht und schließlich einem Anruf, wenn die Anfrage nicht verifiziert wurde.

  1. Senden Sie SMS an Benutzer mit PIN-Code
  2. Warten auf next_event_wait Sekunden (Standardwartezeit: 125 Sekunden)
  3. Senden Sie SMS an Benutzer mit PIN-Code
  4. Warten auf next_event_wait Sekunden (Standardwartezeit: 180 Sekunden)
  5. (Bei der Standardeinstellung läuft die PIN ab und es wird eine neue generiert; steuern Sie dies durch Setzen der pin_expiry Feld)
  6. Benutzer anrufen und mitteilen TTS PIN-Code
  7. Warten auf next_event_wait Sekunden (Standardwartezeit: 300 Sekunden)
  8. Antrag läuft ab

Arbeitsablauf 3: TTS -> TTS

Rufen Sie den Benutzer an und geben Sie einen PIN-Code ein; rufen Sie ihn ein zweites Mal an, wenn die Anfrage noch nicht verifiziert wurde.

  1. Benutzer anrufen und mitteilen TTS PIN-Code
  2. Warten auf next_event_wait Sekunden (Standardwartezeit: 150 Sekunden)
  3. Benutzer anrufen und mitteilen TTS PIN-Code
  4. Warten auf next_event_wait Sekunden (Standardwartezeit: 150 Sekunden)
  5. Antrag läuft ab

Arbeitsablauf 4: SMS -> SMS

Senden Sie einen PIN-Code per Textnachricht und senden Sie eine zweite Textnachricht, wenn der Code nicht verifiziert wurde.

  1. Senden Sie SMS an Benutzer mit PIN-Code
  2. Warten auf next_event_wait Sekunden (Standardwartezeit: 120 Sekunden)
  3. Senden Sie SMS an Benutzer mit PIN-Code
  4. Warten auf next_event_wait Sekunden (Standardwartezeit: 180 Sekunden)
  5. Antrag läuft ab

Arbeitsablauf 5: SMS -> TTS

Senden Sie einen PIN-Code per Textnachricht und rufen Sie anschließend an, wenn der Code nicht verifiziert worden ist.

  1. Senden Sie SMS an Benutzer mit PIN-Code
  2. Warten auf next_event_wait Sekunden (Standardwartezeit: 120 Sekunden)
  3. Benutzer anrufen und mitteilen TTS PIN-Code
  4. Warten auf next_event_wait Sekunden (Standardwartezeit: 180 Sekunden)
  5. Antrag läuft ab

Arbeitsablauf 6: SMS

Senden Sie einmalig einen PIN-Code per Textnachricht.

  1. Senden Sie SMS an Benutzer mit PIN-Code
  2. Anfrage verfällt nach pin_expiry Sekunden (Standardablaufzeit: 300 Sekunden)

Arbeitsablauf 7: TTS

Rufen Sie den Benutzer an und sprechen Sie einmalig einen PIN-Code.

  1. Benutzer anrufen und mitteilen TTS PIN-Code
  2. Anfrage verfällt nach pin_expiry Sekunden (Standardablaufzeit: 300 Sekunden)