){kind=small}
Verify APIの柔軟なワークフロー
所要時間：1 分
Nexmoの Verify APIは、ユーザーにPINコードを送信して入力させることで、ユーザーが正しく有効な電話番号を提供したことを確認できるように設計されています。
デフォルトでは、まずPINコードを含むSMSを送信し、その後にPINを含む音声メッセージで電話をかける。最後に、2回目の電話をかけて、ユーザーと連絡を取ろうとします。
このマルチステップ・マルチモードのプロセスを持つことで、ユーザーの電話番号認証の成功率が大幅に向上します。しかし、これはすべてのユーザーにとって最良のワークフローではないことを私たちは知っていますので、Verify APIに新しい機能が加わりました：設定可能なワークフロー。
PINコードを送信する必要があるユーザーごとに、「正しい」ワークフローは異なるかもしれません。そのため、Verify APIでは、APIコールの際に workflow_idを指定できるようになり、5つのワークフローパターンから選択できるようになりました。
追加パラメーターは既存のパラメーターと一緒に追加されるので、APIコールは次のようになる（Node.jsの場合）：
nexmo.verify.request({
number: RECIPIENT_NUMBER,
brand: BRAND_NAME,
workflow_id: WORKFLOW_ID
}, (err, result) => {
if (err) {
console.error(err);
} else {
const verifyRequestId = result.request_id;
console.log('request_id', verifyRequestId);
}
});
この コードスニペットNexmo開発者ポータル
には1〜5の任意の整数を指定することができる。 workflow_idには1から5までの任意の整数を指定することができ、以下はこれらの数字が表すワークフローである：
PINコードをテキストメッセージで送信し、リクエストがまだVerifyされていなければ、その後2回音声通話でフォローアップする。これはデフォルトの動作であり、どちらを選ぶか迷っているのであれば、おそらく正しい選択だろう。
PINコードをテキストメッセージで送信し、2回目のテキストメッセージでフォローアップし、リクエストがVerifyされていない場合は最後に音声通話をする。SMSの方が音声通話よりも望ましい地域やユーザーの場合。
ユーザーに電話してPINコードを話し、リクエストがまだ確認されていない場合は2回目の電話でフォローアップする。電話がこのユーザーの状況にとって最も効果的であることがすでに分かっている場合は、リトライを伴う電話をかけるのがよい方法です。
PINコードをテキストメッセージで送信し、コードが確認されなかった場合は2回目のテキストメッセージでフォローアップします。電話が苦手なユーザーに最適。ミレニアル世代を含むが、これに限定されない。
PINコードをテキストメッセージで送信し、コードがVerifyされていない場合は音声通話でフォローアップする。テキストと音声の両方を提供するが、それぞれ1回のみの試行とすることで、押しつけがましくなく、多くの人を取り込むことができる。
アプリケーションを調整して、ユースケースに最適なワークフローを利用する（あるいは、顧客ごとに異なるオプションを使用する）ことで、顧客の検証率を大幅に向上させることができます。
ワークフローをどのように変更したか、またその理由をお聞かせください！Twitterでいつでも私たちを見つけることができます @NexmoDevメール devrel@nexmo.comまたは #verify-apiまたは NexmoコミュニティSlack.