Comment utiliser l'agent par défaut RCS de Vonage Verify

Si vous envoyez déjà des mots de passe à usage unique (OTP) via l'API Vonage Verify, vous pouvez commencer à envoyer des messages RCS immédiatement, sans avoir à enregistrer d'agent ni à passer par un processus d'autorisation de l'opérateur. Le Agent par défaut de Vonage Verify RCS est un agent RCS préenregistré et géré de manière centralisée, exploité par Vonage sous le nom de Vonage Verify. Tout client de l'API Verify résidant dans un pays pris en charge peut l'utiliser en omettant simplement le from champ dans leur requête Verify V2 existante.

Conditions préalables

• A Account Vonage avec un Applications Vonage configuré (ID d'application et clé privée, pour Authentification JWT).
• Un système existant intégration avec l'API Verify V2.

Vérifiez que votre pays de destination est pris en charge

Commencez par vérifier que vos utilisateurs finaux se trouvent dans l'un des pays où l'agent par défaut est En direct:

Intégrez RCS à votre processus de Verify

Dans votre requête Verify V2 existante, ajoutez "channel": "rcs" au tableau des flux de travail. Omettre le from champ car Vonage achemine automatiquement le message via l'agent par défaut. Aucun identifiant d'agent n'est nécessaire.

curl -X POST "https://api.nexmo.com/v2/verify" \
    -H "Authorization: Bearer $JWT" \
    -H 'Content-Type: application/json' \
    -d $'{
        "brand": "YOUR_BRAND",
        "workflow": [
        {
            "channel": "rcs",
            "to": "'$PHONE_NUMBER'"
        },
        {
            "channel": "sms",
            "to": "'$PHONE_NUMBER'"
        }
    ]
}'

Gérer la réponse

Une requête réussie renvoie un request_id:

{
  "request_id": "REQUEST_ID"
}

Une fois que l'utilisateur final a saisi le mot de passe à usage unique (OTP), vérifiez le code à l'aide de la request_id exactement comme vous le feriez pour n'importe quelle autre chaîne Verify — voir Vérifier le code de vérification fourni.

Expérience RCS de l'utilisateur final

Lorsqu'un message de vérification est transmis via l'agent par défaut, les utilisateurs finaux disposant d'appareils Android pris en charge reçoivent un message RCS enrichi présentant les fonctionnalités suivantes :

• Badge « Expéditeur vérifié » — le message provient d'un expéditeur vérifié par l'opérateur Vonage Verify agent (VonageVFY à Singapour), ce qui renforce la confiance des utilisateurs.
• Mise en page riche de la carte — le mot de passe à usage unique (OTP) s'affiche bien en évidence dans une fiche stylisée, ce qui permet de le lire facilement d'un seul coup d'œil.
• Bouton « Copier le code » en un clic — une fonctionnalité de suggestion permet aux utilisateurs de copier le code directement dans leur presse-papiers, ce qui réduit les erreurs de saisie.
• Suggestion automatique de mot de passe à usage unique (OTP) — Sur les versions Android prises en charge, Google Messages peut afficher le code au-dessus du clavier sous forme de suggestion de saisie automatique accessible d'un simple clic.
• Corps du message de marque — ton brand Cette valeur apparaît dans le corps du message ; ainsi, les utilisateurs voient le nom de votre entreprise dans son contexte, même si le nom de l'agent est Vonage Verify.
• Aucune installation d'application n'est nécessaire — Le service RCS est intégré à l'application « Messages » par défaut d'Android. Aucun téléchargement ni aucune étape supplémentaire n'est nécessaire pour l'utilisateur.

Fonctionnement et limites

• Le nom de l'expéditeur de l'agent RCS est toujours Vonage Verify (VonageVFY à Singapour) et ne peut pas être personnalisé lorsque vous utilisez l'agent par défaut. Cependant, le nom de votre marque apparaît bien dans le corps du message via le brand paramètre : Your {brand} code is: {code}.
• Les désactivations s'appliquent uniquement à l'utilisateur final concerné et à votre clé API ; elles n'ont aucune incidence sur les autres clients utilisant le même agent par défaut.
• Aucune configuration supplémentaire, aucun ajout à la liste blanche ni aucune autre étape d'activation ne sont nécessaires. Tous les clients de l'API Verify situés dans les pays pris en charge peuvent utiliser immédiatement l'agent par défaut.
• Les limites d'utilisation standard de l'API Vonage Verify et les politiques d'utilisation équitable s'appliquent.
• La facturation est identique à celle du service Vonage Verify RCS standard. L'utilisation est attribuée à votre clé API personnelle.

Enregistrez votre propre agent RCS

L'agent par défaut constitue un point de départ recommandé et sert de solution de transition pendant la mise en place de votre agent personnalisé. Vous pouvez procéder à l'enregistrement de votre propre agent en parallèle tout en utilisant l'agent par défaut, sans perturber votre trafic existant. Pour commencer, utilisez la commande RCS Agent Builder dans le tableau de bord de l'API Vonage.

Voir aussi

• Référence de l'API Verify V2
• Verify Workflow (flux de travail)
• Concepts de chaînes RCS
• Intégrez RCS à vos processus d'authentification
• Guide de RCS Agent Builder