Flujos de trabajo y eventos

Verify API te ofrece la mejor oportunidad de llegar a tus usuarios combinando llamadas SMS y TTS (Text-To-Speech) en secuencia. El modelo básico es que cuando crear una solicitud Verifyse le asigna un request_id y Vonage comenzará la secuencia de acciones para llegar al usuario con un código PIN. Cuando el usuario te envía el código, tú envías el código junto con el request_id a través de Vonage a compruebe que el código es correcto.

Cuando envíe el código y request_idVonage confirmará si el código es el esperado (o no). Si la verificación es correcta, la secuencia se detendrá y no se enviarán más llamadas ni mensajes al usuario. Si la verificación no es exitosa, la secuencia continuará y permanecerá activa hasta que el PIN haya caducado o se hayan enviado tres códigos incorrectos.

La API Verify le permite seleccionar el mejor flujo de trabajo para su caso de uso. Esto puede depender del tipo de verificación que se realice, de las preferencias de los usuarios o de su ubicación geográfica. Puede especificar qué flujo de trabajo utilizar para cada solicitud de Verify API configurando el parámetro workflow_id a un valor entero de 1 a 7. Los detalles de cada uno de estos flujos de trabajo preestablecidos se detallan a continuación.

Puede personalizar aún más la experiencia ajuste de los tiempos al crear una solicitud de Verify, y puede desencadenar el siguiente intento de verificación programáticamente si lo desea.

Flujo de trabajo 1 (flujo de trabajo por defecto): SMS -> TTS -> TTS

Envíe un código PIN por SMS y realice dos llamadas de voz si la solicitud aún no se ha verificado.

  1. Enviar SMS al usuario con código PIN
  2. Espere a que next_event_wait segundos (espera por defecto: 125 segundos)
  3. Llamar al usuario y darle TTS Código PIN
  4. Espere a que next_event_wait segundos (espera por defecto: 180 segundos)
  5. (Con los tiempos predeterminados, el PIN caducará y se generará uno nuevo, contrólelo configurando el parámetro pin_expiry campo)
  6. Llamar al usuario y darle TTS Código PIN
  7. Espere a que next_event_wait segundos (espera por defecto: 300 segundos)
  8. La solicitud expira

Flujo de trabajo 2: SMS -> SMS -> TTS

Envíe un código PIN por mensaje de texto, siga con un segundo mensaje de texto y, por último, una llamada de voz si la solicitud no se ha verificado.

  1. Enviar SMS al usuario con código PIN
  2. Espere a que next_event_wait segundos (espera por defecto: 125 segundos)
  3. Enviar SMS al usuario con código PIN
  4. Espere a que next_event_wait segundos (espera por defecto: 180 segundos)
  5. (Con los tiempos predeterminados, el PIN caducará y se generará uno nuevo, contrólelo configurando el parámetro pin_expiry campo)
  6. Llamar al usuario y darle TTS Código PIN
  7. Espere a que next_event_wait segundos (espera por defecto: 300 segundos)
  8. La solicitud expira

Flujo de trabajo 3: TTS -> TTS

Llame al usuario y dígale un código PIN, realice una segunda llamada si la solicitud aún no se ha verificado.

  1. Llamar al usuario y darle TTS Código PIN
  2. Espere a que next_event_wait segundos (espera por defecto: 150 segundos)
  3. Llamar al usuario y darle TTS Código PIN
  4. Espere a que next_event_wait segundos (espera por defecto: 150 segundos)
  5. La solicitud expira

Flujo de trabajo 4: SMS -> SMS

Envíe un código PIN por SMS y envíe un segundo SMS si el código no se ha verificado.

  1. Enviar SMS al usuario con código PIN
  2. Espere a que next_event_wait segundos (espera por defecto: 120 segundos)
  3. Enviar SMS al usuario con código PIN
  4. Espere a que next_event_wait segundos (espera por defecto: 180 segundos)
  5. La solicitud expira

Flujo de trabajo 5: SMS -> TTS

Envía un código PIN por mensaje de texto, realiza una llamada de voz si el código no se ha verificado.

  1. Enviar SMS al usuario con código PIN
  2. Espere a que next_event_wait segundos (espera por defecto: 120 segundos)
  3. Llamar al usuario y darle TTS Código PIN
  4. Espere a que next_event_wait segundos (espera por defecto: 180 segundos)
  5. La solicitud expira

Flujo de trabajo 6: SMS

Envía un código PIN por SMS una sola vez.

  1. Enviar SMS al usuario con código PIN
  2. La solicitud expira después de pin_expiry segundos (caducidad por defecto: 300 segundos)

Flujo de trabajo 7: TTS

Llame al usuario y diga un código PIN una sola vez.

  1. Llamar al usuario y darle TTS Código PIN
  2. La solicitud expira después de pin_expiry segundos (caducidad por defecto: 300 segundos)