Verify Workflow (flux de travail)

Un flux de travail définit la séquence d'actions que Vonage utilise pour atteindre l'utilisateur final que vous souhaitez vérifier à l'aide d'un code PIN. Vous pouvez personnaliser votre propre flux de travail en spécifiant les canaux à utiliser et dans quel ordre, ce qui permet d'envoyer des messages de vérification à plusieurs numéros de téléphone, adresses électroniques, etc.

Le flux de travail est configuré à l'aide d'un tableau dans votre demande de vérification :

• Le premier canal de la liste est utilisé en premier ;
• Si le message n'est pas converti avec succès, le canal suivant de la liste est utilisé.

Dans l'exemple ci-dessous, on essaie d'abord d'envoyer un SMS. En cas d'échec, le système vocal est utilisé.

curl -X POST "https://api.nexmo.com/v2/verify" \
    -H "Authorization: Bearer $JWT" \
    -H 'Content-Type: application/json' \
    -d $'{
        "brand": "TestVerify",
        "locale": "es-es",
        "code_length": 4,
        "channel_timeout": 300,
        "workflow": [
        {
            "channel": "sms",
            "to": "'$PHONE_NUMBER'"
        },
        {
            "channel": "voice",
            "to": "'$PHONE_NUMBER'"
        }
    ]
}'

Vérifier le Spécification API pour une liste complète des paramètres disponibles et des descriptions détaillées.

Canaux pris en charge

Verify prend en charge plusieurs canaux pour fournir des mots de passe à usage unique (OTP) en fonction des préférences de l'utilisateur et de la connectivité régionale. Voici un aperçu de chaque canal pris en charge :

Authentification silencieuse

Authentification silencieuse vous permet de vérifier les utilisateurs finaux sans qu'ils aient à saisir manuellement un OTP. Il exploite les données du réseau mobile en arrière-plan, ce qui améliore l'expérience de l'utilisateur. Il est idéal pour réduire les abandons pendant les flux d'inscription ou de connexion.

RCS

En tant qu'amélioration du canal SMS, RCS permet d'envoyer des messages par Wi-Fi ou par données mobiles aux applications de messagerie par défaut sur Android et iPhone.

RCS se distingue comme une alternative supérieure aux SMS en raison de son soutien à la validation de la marque et de sa faible latence d'acheminement. Pour utiliser le canal RCS, un Agent RCS ou ID de l'expéditeur est nécessaire.

Actuellement, RCS est disponible dans un nombre limité de pays et sur des appareils compatibles, avec des plans d'expansion future.

SMS

Le SMS est le canal le plus populaire et le plus largement adopté pour l'authentification à deux facteurs (2FA).

Il offre une large portée puisque presque tout le monde peut recevoir des messages textuels, et l'intégration est transparente. En fait, Google a constaté que le SMS 2FA permettait de bloquer :

• 100% des bots automatisés
• 96% des attaques de phishing en masse
• 76% des attaques ciblées

En raison de sa fiabilité et de son omniprésence, le SMS est souvent le premier canal utilisé dans le cadre d'un processus de Verify.

WhatsApp

WhatsApp est un excellent canal pour l'authentification à deux facteurs en raison de sa popularité mondiale et de sa capacité à envoyer des messages par WiFi, ce qui le rend particulièrement utile dans les zones où la couverture mobile est limitée.

L'ajout de WhatsApp en tant que canal secondaire peut améliorer de manière significative vos taux de conversion de vérification.

Pour utiliser l'API Verify avec WhatsApp, vous devez disposer de votre propre WhatsApp Business Account (WABA). Pour créer un WABA, accédez à la page d'accueil de WhatsApp. Canaux sociaux du tableau de bord du développeur et suivez les instructions sous WhatsApp.

Si un utilisateur n'a pas installé WhatsApp, Verify peut le détecter automatiquement et se rabattre sur un autre canal.

Modes de vérification de WhatsApp

Verify v2 prend en charge deux expériences de vérification de WhatsApp :

• OTP (par défaut) : envoie un code à usage unique à WhatsApp pour que l'utilisateur le saisisse.
• Zero-tap (Android) : une expérience de vérification plus transparente pour les applications Android. Activez-la en définissant mode à zero_tap lors de l'utilisation de channel = whatsapp.

Les mode est facultatif. S'il n'est pas spécifié, il prend par défaut la valeur otp_code.

Voix

La vérification vocale est un moyen efficace de remplacer les SMS, en particulier dans les régions où la vérification vocale n'est pas possible :

• La livraison des SMS n'est pas fiable.
• Les réglementations locales imposent des restrictions ou exigent un enregistrement préalable pour le trafic SMS.

Avec les appels vocaux, l'OTP est délivré par un appel téléphonique automatisé, ce qui permet aux utilisateurs des régions les moins accessibles de mener à bien leur processus de vérification en toute fiabilité.

Courriel

Le courrier électronique peut également être utilisé pour délivrer des OTP, ce qui en fait une alternative solide aux canaux basés sur la téléphonie mobile.

Il est particulièrement utile :

• Pendant les périodes de congestion du réseau.
• Pour les utilisateurs qui préfèrent recevoir les vérifications par l'intermédiaire de leur Account.