Compartir:
){kind=small}
Lorna es ingeniera de software con un incurable hábito bloguero. Intenta domar las palabras y el código a partes iguales.
Flujos de trabajo flexibles para Verify API
Tiempo de lectura: 2 minutos
Nexmo Verify API de Nexmo está diseñada para permitirle confirmar que un usuario ha proporcionado un número de teléfono correcto y válido, enviándole un código PIN y pidiéndole que lo introduzca.
Por defecto, esto se hace enviando primero un SMS con el código PIN y, a continuación, una llamada telefónica con un mensaje hablado que contiene el PIN. Por último, se realiza una segunda llamada telefónica para intentar localizar al usuario.
Disponer de este proceso de varios pasos y modos realmente mejora las tasas de éxito de la verificación del número de teléfono del usuario. Sin embargo, sabemos que éste no es el mejor flujo de trabajo posible para todos los usuarios, por lo que Verify API cuenta ahora con una nueva función: Flujos de trabajo configurables.
Para cada usuario al que necesite enviar un código PIN, el flujo de trabajo "correcto" puede ser diferente. Por eso Verify API le permite ahora especificar un flujo de trabajo workflow_id cuando realice la llamada a la API, permitiéndole elegir entre cualquiera de los cinco posibles patrones de flujo de trabajo.
El parámetro adicional se añade junto a los ya existentes, por lo que su llamada a la API se parece a esto (en 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);
}
});
También encontrará este fragmento de código en otros idiomas en el portal para desarrolladores de Nexmo
El workflow_id puede ser cualquier número entero entre 1 y 5, y aquí están los flujos de trabajo que estos números representan:
Envía un código PIN por mensaje de texto y realiza dos llamadas de voz si la solicitud aún no se ha verificado. Este es el comportamiento por defecto y probablemente una buena opción si no estás seguro de qué elegir.
Enviar un código PIN por mensaje de texto, seguir con un segundo mensaje de texto y finalmente una llamada de voz si la solicitud no ha sido verificada. Para zonas geográficas y/o usuarios en los que es preferible un SMS a una llamada de voz.
Llame al usuario y dígale un código PIN, realice una segunda llamada si la solicitud no se ha verificado. Si ya sabes que una llamada telefónica funciona mejor para la situación de este usuario, una llamada telefónica con un reintento es una buena manera de llegar a ellos.
Envíe un código PIN por SMS y envíe un segundo SMS si el código no se ha verificado. Ideal para usuarios a los que no les gustan las llamadas telefónicas. Incluidos, entre otros, los mileniales.
Envíe un código PIN por mensaje de texto, siga con una llamada de voz si el código no se ha verificado. Ofrecer tanto texto como voz, pero con un solo intento en cada caso, incluye a mucha gente sin ser demasiado intrusivo.
Ajustar su aplicación para hacer uso del mejor flujo de trabajo para su caso de uso (o incluso utilizar diferentes opciones para diferentes clientes) puede mejorar realmente las tasas de verificación de sus clientes.
Estamos muy contentos de que esta función esté disponible públicamente: ¡dinos cómo has cambiado tus flujos de trabajo y por qué! Siempre puedes encontrarnos en Twitter @NexmoDevo envíanos un correo electrónico a devrel@nexmo.com o hacer una pregunta en el #verify-api en el canal de Comunidad Nexmo Slack.