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, le système tentera d'abord d'envoyer le message par SMS. Si cela n'aboutit pas à une conversion réussie, le système essaiera ensuite le RCS, puis la voix si les deux tentatives précédentes échouent.

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": "rcs",
            "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 fonctionne en tirant parti de la vérification du réseau mobile basée sur l'IP en arrière-plan, offrant ainsi une meilleure expérience à l'utilisateur. Il est idéal pour réduire les abandons pendant les flux d'inscription ou de connexion.

Authentification silencieuse avancée [Alpha]

Authentification silencieuse avancée vous permet de vérifier l'identité des utilisateurs finaux sans qu'ils aient à saisir manuellement un mot de passe à usage unique (OTP). Cette solution utilise une vérification cryptographique basée sur la carte SIM via le protocole GSMA TS.43, effectuant des contrôles directement entre la carte SIM et le cœur de réseau de l'opérateur. Cette méthode cryptographique garantit que la carte SIM reste associée au numéro de téléphone, que l'utilisateur utilise les données mobiles, le Wi-Fi ou un VPN.

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 un nombre limité de pays et sur les appareils compatibles, avec des projets d'extension à venir.

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.