){kind=small}
Envoyer des vérifications RCS à l'aide de l'agent par défaut « Vonage Verify RCS »
Temps de lecture : 8 minutes
Vonage Verify L'agent par défaut RCS (Rich Communication Services) est un agent RCS pré-enregistré et géré de manière centralisée que tout client de la Verify API peut utiliser pour commencer à envoyer instantanément des messages RCS sans avoir à passer par le processus traditionnel d'enregistrement des agents, qui prend généralement beaucoup de temps.
Dans cet article, vous découvrirez comment utiliser l'agent par défaut Vonage Verify RCS pour commencer à envoyer des messages d'authentification RCS sécurisés dès le jour même de votre intégration.
Si votre entreprise souhaite intégrer le RCS à ses processus d'authentification sans avoir à attendre plusieurs semaines l'accord des opérateurs, ou si vous utilisez déjà Vonage Verify pour les SMS ou WhatsApp et que vous cherchez à ajouter un canal de messagerie enrichie avec un minimum d'efforts, cet article est fait pour vous. Il en va de même si vous n’utilisez actuellement que les SMS et souhaitez commencer à tester le RCS en tant que canal supplémentaire.
Si vous avez déjà essayé de vous lancer avec le RCS et que vous avez rencontré des difficultés lors de la procédure d'inscription, ne baissez pas les bras pour autant. Restez avec nous pour en savoir plus sur l'agent par défaut Vonage Verify RCS.
Une intégration avec l’API Verify V2 dans un ou plusieurs des pays pris en charge.
Remarque: pour utiliser l’agent par défaut RCS de Vonage Verify, omettez le paramètre « from » dans vos requêtes Verify API. Vous pouvez commencer immédiatement à envoyer des messages de vérification RCS tandis que l’enregistrement de votre agent personnalisé se poursuit en parallèle.
Si vous êtes déjà intégré à l'API Vonage Verify v2, vous pouvez commencer à envoyer des messages RCS via l'agent par défaut en effectuant une seule modification : omettez le from champ, car Vonage achemine automatiquement le message via l’agent par défaut et 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": "TestVerify",
"code_length": 5,
"channel_timeout": 30,
"workflow": [
{
"channel": "rcs",
"to": "+447700900000"
}
]
}'JWT (JSON Web Token) - Vous pouvez générer un nouveau JWT à l'aide du générateur JWT en ligne ou l' outil CLI de Vonage.
marque - Le nom de votre entreprise tel que vous souhaitez qu'il apparaisse dans le corps du message.
canal - Doit être « rcs » pour que le routage s'effectue via l'agent RCS par défaut.
à - Numéro de téléphone de l'utilisateur final au format E.164.
Ouvrez votre Page des paramètres de l'API pour accéder à votre clé et à votre secret API de Vonage, qui sont tous deux affichés comme indiqué dans la capture d'écran ci-dessous. La clé API se trouve en haut de la page, et pour accéder à votre secret API, veuillez vous référer à la sous-section "Secret du compte".
Remarque : si vous ne vous souvenez plus de votre secret API précédemment créé, cliquez sur "+ Créer un nouveau secret" et sauvegardez-le en toute sécurité.
Une réponse « 202 Accepted » confirme que la demande de vérification a bien été envoyée. Une réponse 200 OK confirme que le code correspond et que l'utilisateur est vérifié. Vérifiez le code en utilisant la request_id exactement comme vous le feriez pour n’importe quel autre canal Verify, vérifiez le code de vérification fourni.
{
"request_id": "c11236f4-00bf-4b89-84ba-88b25df97315"
}Enregistrez le request_id, vous en aurez besoin pour vérifier le code soumis par l'utilisateur final.
Pour plus de détails sur les paramètres, consultez la Référence de l'API Verify V2.
Une fois que l'utilisateur final a reçu le code OTP, vous devez envoyer une requête POST au /v2/verify/{request_id} point de terminaison. Remplacez le {request_id} par l'ID que vous avez reçu lors de l'appel précédent :
curl -X POST "https://api.nexmo.com/v2/verify/$VERIFY_REQUEST_ID" \
-H "Authorization: Bearer $JWT"\
-H 'Content-Type: application/json' \
-d $'{
"code": "'$VERIFY_CODE'"
}'
Pour les déploiements en production, nous recommandons d'ajouter un canal de secours au cas où le RCS ne serait pas disponible sur l'appareil du destinataire. Le workflow ci-dessous tente d'abord d'utiliser le RCS, puis se rabat sur les SMS. Aucune configuration supplémentaire n'est nécessaire, car Vonage gère automatiquement la sélection du canal. Dans la plupart des pays, le message est envoyé par l'agent « Vonage Verify ».
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'"
}
]
}'
RCS ConversationLa fonctionnalité RCS est intégrée à l'application Messages par défaut d'Android et est également disponible sur les dernières versions d'iOS. 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, ce qui permet aux utilisateurs de le vérifier d'un simple clic sans avoir à changer d'application.
Si vous utilisez la mise en page « Rich card », le mot de passe à usage unique (OTP) s’affiche bien en évidence dans une carte stylisée, et vous pouvez même ajouter un bouton « Copier le code » accessible d’un simple clic. Il s’agit d’une bulle de suggestion située sous le message qui permet aux utilisateurs de copier directement le code dans leur presse-papiers, ce qui réduit les obstacles et les erreurs de saisie dans les formulaires de connexion.
Le corps du message personnalisé correspond à la valeur que vous définissez dans l'appel API ; celle-ci s'affiche dans le corps du message, ce qui permet aux utilisateurs finaux de voir le nom de votre entreprise dans son contexte.
Fonctionnalité | RCS (agent par défaut) | SMS |
Identité de l'expéditeur | Agent certifié « Vonage Verify » | Code numérique court/long |
Format du message | Carte multifonctionnelle dotée d'un affichage OTP bien visible | Chaîne de texte brut |
Copie en un clic | Bouton « Copier le code » | Copie manuelle |
Suggestion de saisie automatique | Sur les appareils pris en charge | Sur les appareils pris en charge |
Résistance au hameçonnage | Expéditeur vérifié par l'opérateur | Plus facile à usurper |
Q : Tous les clients de Verify V2 peuvent-ils utiliser cette fonctionnalité ?
R : Oui, tous les clients de la Verify API dans les pays pris en charge peuvent utiliser l’agent par défaut sans aucune configuration supplémentaire.
Q : L'utilisateur final verra-t-il « Vonage Verify » à la place de la marque du client ?
R : Oui, les messages proviendront de l’agent « Vonage Verify ». Il s’agit du comportement prévu pour l’agent par défaut. Si vous souhaitez que le nom de votre marque apparaisse comme expéditeur, enregistrez un agent personnalisé. La validation de votre agent personnalisé peut être effectuée en parallèle tout en utilisant l’agent par défaut. Dans ce cas, vous pouvez utiliser le paramètre « brand » pour faire apparaître le nom de votre marque dans le corps du message RCS.
Q : Y a-t-il une limite de volume ?
R : Il n’y a pas de limites de volume spécifiques liées à l’utilisation de l’agent par défaut. Les limites d’utilisation standard de la Verify API et les politiques d’utilisation équitable s’appliquent. La facturation des messages RCS envoyés via l’agent par défaut est identique à la tarification standard de Vonage Verify RCS. L'utilisation de l'agent par défaut n'entraîne aucun supplément ni surcoût. Toute utilisation est attribuée à la clé API individuelle du client ; il n'y a donc aucun risque de facturation partagée. La facturation est la même, que le client utilise l'agent par défaut ou son propre identifiant d'agent enregistré.
Q : Qu'en est-il des pays qui ne figurent pas sur la liste approuvée ?
R : Pour les pays qui ne sont pas encore pris en charge, les clients doivent procéder eux-mêmes à l'enregistrement de leur agent RCS. L'équipe Verify élargit en permanence la couverture des agents par défaut. Vérifiez si le pays cible est pris en charge.
L' agent par défaut RCS de Vonage Verify vous permet de commencer à utiliser le RCS dès le jour même, et vous pouvez passer à votre propre agent personnalisé à tout moment. Vous n'avez pas besoin de fournir de documentation relative à votre marque ni de détails sur vos cas d'utilisation, ni de passer par des processus d'approbation des opérateurs qui varient d'un pays à l'autre, ni d'éviter les allers-retours avec les agrégateurs avant de pouvoir envoyer un message.
Comment utiliser l'agent par défaut RCS de Vonage Verify
Vous avez une question ou souhaitez partager ce que vous construisez ?
S'abonner à la Bulletin d'information du développeur
Suivez-nous sur X (anciennement Twitter) pour les mises à jour
Regardez les tutoriels sur notre chaîne YouTube
Connectez-vous avec nous sur la page Vonage Developer sur LinkedIn
Aidez-nous à améliorer l'expérience des développeurs en remplissant notre formulaire de commentaires « Voice of the Developer »
Restez connecté et tenez-vous au courant des dernières nouvelles, astuces et événements concernant les développeurs.