Flux de travail et événements

Verify donne les meilleures chances d'atteindre vos utilisateurs en combinant les appels SMS et TTS (Text-To-Speech) en séquence. Le modèle de base est le suivant : lorsque vous créer une demande de Verifyil lui est attribué un request_id et Vonage commencera la séquence d'actions pour atteindre l'utilisateur avec un code PIN. Lorsque l'utilisateur vous envoie le code, vous l'envoyez avec le numéro de téléphone de l'utilisateur. request_id à Vonage à vérifier que le code est correct.

Lorsque vous envoyez le code et request_idVonage confirmera si le code est conforme aux attentes (ou non). Si la vérification est réussie, la séquence s'arrête et aucun autre appel ou message n'est envoyé à l'utilisateur. Si la vérification échoue, la séquence se poursuivra et restera active jusqu'à ce que le code PIN ait expiré ou que trois codes incorrects aient été envoyés.

L'API Verify vous permet de sélectionner le meilleur flux de travail pour votre cas d'utilisation. Cela peut dépendre du type de vérification en cours, des préférences de vos utilisateurs ou de leur situation géographique. Vous pouvez spécifier le flux de travail à utiliser pour chaque demande de l'API Verify en définissant l'attribut workflow_id à une valeur entière de 1 à 7. Les détails de chacun de ces flux de travail prédéfinis sont présentés ci-dessous.

Vous pouvez personnaliser davantage l'expérience en réglage des horaires lors de la création d'une demande de Verify, et peut déclencher la prochaine tentative de vérification de manière programmatique si vous le souhaitez.

Workflow 1 (Workflow par défaut) : SMS -> TTS -> TTS

Envoyez un code PIN par message texte, puis effectuez deux appels vocaux si la demande n'a pas déjà été vérifiée.

  1. Envoyer SMS à l'utilisateur avec un code PIN
  2. Attendre next_event_wait secondes (attente par défaut : 125 secondes)
  3. Appeler l'utilisateur et lui donner TTS Code PIN
  4. Attendre next_event_wait secondes (attente par défaut : 180 secondes)
  5. (Avec les délais par défaut, le code PIN expirera et un nouveau sera généré. pin_expiry champ)
  6. Appeler l'utilisateur et lui donner TTS Code PIN
  7. Attendre next_event_wait secondes (attente par défaut : 300 secondes)
  8. La demande expire

Flux de travail 2 : SMS -> SMS -> TTS

Envoyez un code PIN par message texte, faites suivre d'un second message texte et enfin d'un appel vocal si la demande n'a pas été vérifiée.

  1. Envoyer SMS à l'utilisateur avec un code PIN
  2. Attendre next_event_wait secondes (attente par défaut : 125 secondes)
  3. Envoyer SMS à l'utilisateur avec un code PIN
  4. Attendre next_event_wait secondes (attente par défaut : 180 secondes)
  5. (Avec les délais par défaut, le code PIN expirera et un nouveau sera généré. pin_expiry champ)
  6. Appeler l'utilisateur et lui donner TTS Code PIN
  7. Attendre next_event_wait secondes (attente par défaut : 300 secondes)
  8. La demande expire

Flux de travail 3 : TTS -> TTS

Appelez l'utilisateur et prononcez un code PIN, puis rappelez-le si la demande n'a pas déjà été vérifiée.

  1. Appeler l'utilisateur et lui donner TTS Code PIN
  2. Attendre next_event_wait secondes (attente par défaut : 150 secondes)
  3. Appeler l'utilisateur et lui donner TTS Code PIN
  4. Attendre next_event_wait secondes (attente par défaut : 150 secondes)
  5. La demande expire

Workflow 4 : SMS -> SMS

Envoyez un code PIN par SMS, puis envoyez un second SMS si le code n'a pas été vérifié.

  1. Envoyer SMS à l'utilisateur avec un code PIN
  2. Attendre next_event_wait secondes (attente par défaut : 120 secondes)
  3. Envoyer SMS à l'utilisateur avec un code PIN
  4. Attendre next_event_wait secondes (attente par défaut : 180 secondes)
  5. La demande expire

Flux de travail 5 : SMS -> TTS

Envoyez un code PIN par message texte, puis appelez-le si le code n'a pas été vérifié.

  1. Envoyer SMS à l'utilisateur avec un code PIN
  2. Attendre next_event_wait secondes (attente par défaut : 120 secondes)
  3. Appeler l'utilisateur et lui donner TTS Code PIN
  4. Attendre next_event_wait secondes (attente par défaut : 180 secondes)
  5. La demande expire

Workflow 6 : SMS

Envoyer un code PIN par message texte une seule fois.

  1. Envoyer SMS à l'utilisateur avec un code PIN
  2. La demande expire après pin_expiry secondes (expiration par défaut : 300 secondes)

Flux de travail 7 : TTS

Appelez l'utilisateur et prononcez un code PIN une seule fois.

  1. Appeler l'utilisateur et lui donner TTS Code PIN
  2. La demande expire après pin_expiry secondes (expiration par défaut : 300 secondes)