Flux de conversation RCS

Ce guide vous accompagne dans la conception et la mise en œuvre de flux de conversation RCS à l'aide de l'API Messages, avec des exemples pratiques et des bonnes pratiques pour construire des parcours conversationnels.

Qu'est-ce qu'un flux de conversation RCS ?

Un flux de conversation RCS est une séquence structurée de messages et d'interactions avec l'utilisateur. Il guide les utilisateurs tout au long d'un processus, comme effectuer un achat, obtenir une assistance ou recevoir des mises à jour, en utilisant des médias enrichis, des réponses suggérées et une logique automatisée.

A sequence flow of a message from an agent and a response from a user.

Conception de votre flux RCS

  1. Définir le cas d'utilisation : Identifier l'objectif (par exemple, assistance, ventes, notifications).
  2. Tracer le chemin : Décrire chaque étape, le choix de l'utilisateur et le résultat attendu.
  3. Préparer le contenu : Rédiger des messages, des supports et des options de réponse.
  4. Automatiser la logique : Utilisez les webhooks et la logique de backend pour gérer les entrées des utilisateurs et déclencher des réponses.

Suivez ces étapes pour mettre en œuvre un flux de conversation précis de type RBM en utilisant les terminaux et les charges utiles de Vonage.

L'agent envoie une demande de vérification de capacité

Avant d'envoyer un RCS, vérifiez que l'appareil de l'utilisateur est compatible avec le RBM.

L'agent envoie :

POST /v1/channel-manager/rcs/agents/welcome-bot/devices/capabilities 
HTTP/1.1
Host: api-us.vonage.com
Authorization: Bearer {JWT}
Content-Type: application/json

L'agent reçoit la réponse du contrôle de capacité

La plate-forme indique que le dispositif peut recevoir des messages RBM.

L'agent reçoit :

{
   "rcs_supported": true,
   "features": [
      "RICHCARD_STANDALONE",
      "ACTION_CREATE_CALENDAR_EVENT",
      "ACTION_DIAL",
      "ACTION_OPEN_URL",
      "ACTION_SHARE_LOCATION",
      "ACTION_VIEW_LOCATION",
      "RICHCARD_CAROUSEL"
   ]
}

L'agent envoie "Hello, World !"

Envoyer un message texte RCS via l'API Messages.

L'agent envoie :

POST /v1/messages 
HTTP /1.1
Host: api-us.vonage.com
Authorization: Bearer {JWT}
Content-Type: application/json
{
   "message_type": "text",
   "text": "Hello, World!",
   "to": "12223334444",
   "from": "welcome-bot",
   "channel": "rcs"
}

La plate-forme envoie l'événement DELIVERED

Le message est remis à l'utilisateur et un événement de remise est envoyé à votre webhook d'état.

L'agent reçoit :

{
  "messageuuid": "3ca4b881-3e11-46bd-b491-76740a62639a",
  "to": "12223334444",
  "from": "welcome-bot",
  "timestamp": "2026-02-02T12:00:04Z",
  "status": "delivered",
  "channel": "rcs"
}

La plate-forme envoie un événement READ

L'utilisateur ouvre le message. Un événement de lecture est envoyé à votre webhook d'état.

L'agent reçoit :

{
  "messageuuid": "3ca4b881-3e11-46bd-b491-76740a62639a",
  "to": "12223334444",
  "from": "welcome-bot",
  "timestamp": "2026-02-02T12:01:10Z",
  "status": "read",
  "channel": "rcs"
}

L'utilisateur envoie une réponse

L'utilisateur envoie un message. Vonage le transmet à votre crochet Web entrant.

L'agent reçoit :

{
  "to": "welcome-bot",
  "from": "12223334444",
  "channel": "rcs",
  "message_uuid": "aaaaaaaa-bbbb-cccc-dddd-0123456789ab",
  "timestamp": "2026-02-02T12:02:23Z",
  "message_type": "text",
  "text": "Hello to you!"
}

La plate-forme accuse réception de la livraison entrante

Les messages entrants sont transmis à votre webhook (avec accusé de réception implicite via le webhook receipt). Utilisez la charge utile du webhook pour acheminer la conversation et enregistrer l'événement.

L'agent envoie un accusé de réception READ

Accuser réception du message de l'utilisateur en le marquant comme lu.

L'agent envoie :

PATCH /v1/messages/aaaaaaaa-bbbb-cccc-dddd-0123456789ab 
HTTP/1.1
Host: api-us.vonage.com
Authorization: Bearer {JWT}
Content-Type: application/json
{
  "status": "read"
}

Plus d'informations