ワークフローとイベント

Verify APIは、SMSとTTS(Text-To-Speech)コールを順番に組み合わせることで、ユーザーに到達する最良の機会を提供します。基本的なモデルは Verifyリクエストの作成が割り当てられる。 request_id と入力すると、VonageはユーザーにPINコードを送信する一連の動作を開始します。ユーザーからコードが送られてきたら、そのコードを request_id Vonageを通じて コードが正しいかチェックする.

コードを送信し request_idVonageは、コードが期待通りであるか（またはそうでないか）を確認します。認証に成功した場合、シーケンスは停止し、それ以降の通話やメッセージは送信されません。認証に失敗した場合、PINの有効期限が切れるか、不正なコードが3回送信されるまで、シーケンスは継続され、アクティブなままになります。

Verify APIを使用することで、ユースケースに最適なワークフローを選択することができます。これは、検証の種類、ユーザーの好み、または地理的な場所によって異なります。を設定することで、Verify API リクエストごとに使用するワークフローを指定できます。 workflow_id フィールドを1～7の整数値に設定する。各プリセット・ワークフローの詳細は以下の通り。

さらに、次のようなカスタマイズも可能だ。 タイミングの設定 Verify リクエストを作成するときに、次のことができる。 次の検証を試みる お望みなら、プログラム的に。

ワークフロー1（デフォルトのワークフロー）：SMS -> TTS -> TTS

PINコードをテキストメッセージで送信し、リクエストがまだVerifyされていなければ、その後2回音声通話でフォローアップする。

  1. 送信 ショートメール PINコードでユーザーへ
  2. 待つ next_event_wait おかわり (デフォルトは125秒）
  3. ユーザーに電話をかけて TTS PINコード
  4. 待つ next_event_wait おかわり (デフォルトは180秒）
  5. (デフォルトのタイミングでは、PINは失効し、新しいPINが生成されます。 pin_expiry フィールド)
  6. ユーザーに電話をかけて TTS PINコード
  7. 待つ next_event_wait おかわり (デフォルトは300秒）
  8. リクエスト期限切れ

ワークフロー2：SMS -> SMS -> TTS

PINコードをテキストメッセージで送信し、2回目のテキストメッセージでフォローアップし、リクエストがVerifyされていない場合は最後に音声通話をする。

  1. 送信 ショートメール PINコードでユーザーへ
  2. 待つ next_event_wait おかわり (デフォルトは125秒）
  3. 送信 ショートメール PINコードでユーザーへ
  4. 待つ next_event_wait おかわり (デフォルトは180秒）
  5. (デフォルトのタイミングでは、PINは失効し、新しいPINが生成されます。 pin_expiry フィールド)
  6. ユーザーに電話をかけて TTS PINコード
  7. 待つ next_event_wait おかわり (デフォルトは300秒）
  8. リクエスト期限切れ

ワークフロー3：TTS -> TTS

ユーザーに電話してPINコードを話し、リクエストがまだVerifyされていなければ、2回目の電話でフォローアップする。

  1. ユーザーに電話をかけて TTS PINコード
  2. 待つ next_event_wait おかわり (デフォルトは150秒）
  3. ユーザーに電話をかけて TTS PINコード
  4. 待つ next_event_wait おかわり (デフォルトは150秒）
  5. リクエスト期限切れ

ワークフロー4：SMS→SMS

PINコードをテキストメッセージで送信し、コードがVerifyされていない場合は2回目のテキストメッセージでフォローアップする。

  1. 送信 ショートメール PINコードでユーザーへ
  2. 待つ next_event_wait おかわり (デフォルトは120秒）
  3. 送信 ショートメール PINコードでユーザーへ
  4. 待つ next_event_wait おかわり (デフォルトは180秒）
  5. リクエスト期限切れ

ワークフロー5：SMS→TTS

PINコードをテキストメッセージで送信し、コードがVerifyされていない場合は音声通話でフォローアップする。

  1. 送信 ショートメール PINコードでユーザーへ
  2. 待つ next_event_wait おかわり (デフォルトは120秒）
  3. ユーザーに電話をかけて TTS PINコード
  4. 待つ next_event_wait おかわり (デフォルトは180秒）
  5. リクエスト期限切れ

ワークフロー6：SMS

一度だけPINコードをテキストメッセージで送信する。

  1. 送信 ショートメール PINコードでユーザーへ
  2. リクエストの有効期限は pin_expiry おかわり (デフォルト有効期限：300秒）

ワークフロー7：TTS

ユーザーを呼び出し、一度だけPINコードを話す。

  1. ユーザーに電話をかけて TTS PINコード
  2. リクエストの有効期限は pin_expiry おかわり (デフォルト有効期限：300秒）