RCS Business Messaging est maintenant disponible dans l'API Messages de Vonage

Rich Communication Services (RCS) ouvre de nouvelles opportunités pour la messagerie professionnelle, et je suis heureux d'annoncer que RCS Messaging est désormais disponible dans l'API Messages de Vonage. Vonage Messages API!

Avec le passage à l'AG, la messagerie RCS est désormais disponible plus largement.

Couverture géographique élargie

Alors que le lancement de la version bêta de RCS ne concernait que les réseaux allemands, le lancement de l'AG a permis de prendre en charge le Royaume-Uni et plus de 10 autres pays, avec une extension de la couverture à l'avenir.

Pris en charge par nos SDK pour serveurs

Le fait que RCS soit GA signifie également que la messagerie RCS est maintenant implémentée dans nos SDK Serveur. Ainsi, en tant que développeur, vous pouvez envoyer des messages RCS en utilisant votre langage de programmation préféré !

Dans la suite de cet article, nous allons voir quelques exemples de mise en œuvre programmatique du RCS. Allons-y !

Vous vous demandez Vous vous demandez ce qu'est exactement la messagerie RCS ? Ou comment la messagerie RCS se compare aux SMS ou MMS ? Consultez l'article que j'ai écrit en début d'année lorsque la messagerie RCS a été ajoutée à l'API Messages en version bêta. Cet article couvre certains avantages de la messagerie RCS. Ces avantages permettent d'enrichir l'expérience client, de stimuler l'engagement des utilisateurs et d'améliorer les taux de conversion.

Comment RCS diffère de la messagerie SMS/MMS

Messagerie SMS/MMS ou RCS, quelle est la différence ? Les trois canaux prennent en charge la messagerie texte, et les MMS et RCS permettent d'envoyer des messages avec des pièces jointes telles que des fichiers image et vidéo. Le RCS se distingue vraiment par les autres types de messages qu'il prend en charge :

• Réponses suggérées

• Actions suggérées

• Cartes riches

Dans le canal RCS de l'API Messages, ces types de messages sont tous envoyés en utilisant le type de message custom type de message. Vous pouvez en savoir plus sur les Messages personnalisés RCS et comment les utiliser.

Voyons quelques exemples d'envoi de certains de ces types de messages à l'aide des SDK du serveur.

Conditions préalables

• Un compte de développeur Vonage

Vonage API Account

To complete this tutorial, you will need a Vonage API account. If you don’t have one already, you can sign up today and start building with free credit. Once you have an account, you can find your API Key and API Secret at the top of the Vonage API Dashboard.

Ready to start building?

Experience seamless connectivity, real-time messaging, and crystal-clear voice and video calls—all at your fingertips.

Mise en place

Avant de commencer à envoyer des messages RCS avec le SDK Vonage que vous avez choisi, il y a quelques étapes préliminaires à franchir.

1. Vous devrez configurer un agent RBM (RCS Business Messaging). Une fois l'agent créé, vous recevrez un ID d'agent que vous pourrez utiliser comme ID d'expéditeur lors de l'envoi de messages RCS. Dans le contexte de l'API Messages de Vonage, il s'agit de la valeur du champ from dans le corps de la demande.

• Si vous utilisez un agent de test (c'est-à-dire un agent RBM enregistré en mode développeur), vous devez établir une liste d'autorisation pour le numéro auquel vous souhaitez envoyer des messages pour cet agent. Vous pouvez contacter votre Account manager ou votre support pour mettre cela en place.

1. Créer une application Vonage activée pour l'API Messages. Les Applications Vonage sont utilisées pour stocker les paramètres liés à la ou aux API Vonage que vous utilisez, ainsi que pour générer des informations d'identification pour créer des JWT (jetons Web JSON). Il existe plusieurs façons de créer une application Vonage :

• Via la page Applications du tableau de bord du développeur de tableau de bord du développeur Vonage

• Par l'intermédiaire de la CLI de Vonage

• Par l'intermédiaire de l API de l'application Vonage

L'installation de l'application Vonage vous fournira un identifiant d'application et un fichier private.key fichier. Vous en aurez besoin pour générer des JWT qui seront utilisés pour l'authentification avec l'API Messages de Vonage. Les SDK génèrent automatiquement les JWT pour chaque demande, mais vous devez leur fournir l'ID de l'application et la clé privée.

Une fois que l'Agent RBM et l'Application Vonage sont tous deux configurés, la dernière chose à faire est de relier les deux. Vous pouvez le faire via le tableau de bord du développeur Vonage, soit sur la page de l'application Vonage elle-même (sous l'onglet External Accounts), soit sur la page External Accounts. Page des comptes externes.

Screenshot of the Vonage Developer Dashboard with an option to link an RCS agent to an Application

Maintenant que tout est prêt, voyons quelques exemples de code !

Comment utiliser la messagerie RCS

Comment instancier le client Vonage

Tous les SDK de serveur varient en termes d'implémentation spécifique, mais ils partagent tous certains concepts généraux tels que l'instanciation d'un objet Client qui peut ensuite être utilisé pour interagir avec les API de Vonage en appelant des méthodes sur lui. C'est ici que vous aurez besoin de l'identifiant d'application et de la clé privée générés plus tôt. Vous trouverez ci-dessous un exemple de cette opération avec le SDK Ruby, bien que tous les SDK Serveur suivent un modèle similaire :

vonage_client = Vonage::Client.new(
   application_id: ENV['VONAGE_APPLICATION_ID'],
   private_key: File.read(ENV['VONAGE_APPLICATION_PRIVATE_KEY_PATH'])
)

Notez que dans l'exemple ci-dessus, VONAGE_APPLICATION_ID et VONAGE_APPLICATION_PRIVATE_KEY_PATH sont des variables d'environnement.

Comment envoyer un message de réponse suggérée RCS

Les messages de réponse suggérée sont un type de message dans lequel vous pouvez envoyer un texte accompagné d'un certain nombre d'options suggérées que le destinataire peut utiliser dans sa réponse. Ces options apparaissent sous forme de "puces" ou de boutons dans l'interface utilisateur de l'appareil, sur lesquels le destinataire peut appuyer pour les sélectionner.

Les messages de réponse suggérée sont très utiles dans de nombreux cas. Un exemple est la réalisation d'enquêtes auprès des clients. En limitant les réponses à des valeurs spécifiques et suggérées, il est plus facile de traiter ces données dans votre application. Par exemple, vous pouvez envoyer un message RCS demandant à un client d'évaluer votre service de un à cinq, avec des valeurs de un à cinq comme réponses suggérées. text de un à cinq comme options de réponse suggérées.

En plus des suggestions de réponse, chaque option de réponse suggérée comprend également une option de réponse. textsuggéré, chaque option de réponse suggérée comprend également une valeur postbackData valeur. Cela vous permet, par exemple, d'utiliser un langage convivial pour la valeur text mais quelque chose de différent pour la valeur postbackData à utiliser pour le traitement interne. Une autre utilisation de postbackData pourrait être d'envoyer l'enquête dans différentes régions avec la valeur text dans différentes langues en fonction de la région, mais avec la même valeur. postbackData valeur.

Prenons un exemple.

Voici comment envoyer ces messages avec les SDK Node et Ruby.

Envoyer un message de réponse suggérée RCS avec le SDK Node

Ici, nous envoyons le message d'enquête en anglais.

vonageClient.messages.send(
  new RCSCustom({
    custom: {
      contentMessage: {
        text: "Vonage APIs are easy to use.",
        suggestions: [
          {
            reply: {
              text: "Strongly agree",
              postbackData: "5",
            },
          },
          {
            reply: {
              text: "Agree",
              postbackData: "4",
            },
          },
          {
            reply: {
              text: "Neither agree or disagree",
              postbackData: "3",
            },
          },
          {
            reply: {
              text: "Disagree",
              postbackData: "2",
            },
          },
          {
            reply: {
              text: "Strongly disagree",
              postbackData: "1",
            },
          },
        ],
      },
    },
    to: '447900000000',
    from: 'VonageRCSAgent',
  }),
);

Lorsqu'il est reçu, le message s'affiche avec une liste déroulante de suggestions parmi lesquelles le destinataire peut choisir.

Screenshot of an RCS suggested reply message in English

Screenshot of an RCS suggested reply message in English

Envoyer un message de réponse suggérée RCS avec le SDK Ruby

Ici, nous envoyons le message d'enquête en français.

message = vonage_client.messaging.rcs(
  type: 'custom',
  message: {
    contentMessage: {
      text: "Les APIs de Vonage sont simple a utilizer",
      suggestions: [
        {
          reply: {
            text: "Fortement en accord",
            postbackData: "5"
          }
        },
        {
          reply: {
            text: "En accord",
            postbackData: "4"
          }
        },
        {
          reply: {
            text: "Neutre",
            postbackData: "3"
          }
        },
        {
          reply: {
            text: "En désaccord",
            postbackData: "2"
          }
        },
        {
          reply: {
            text: "Fortement en  désaccord",
            postbackData: "1"
          }
        }
      ]
    }
  }
)

vonage_client.messaging.send(
  from: 'VonageRCSAgent',
  to: '447900000000',
  **message
)

qui s'afficherait de la même manière, mais avec les valeurs modifiées suivantes text modifiées :

Screenshot of an RCS suggested reply message in FrenchScreenshot of an RCS suggested reply message in French

Notez que pour les deux versions linguistiques, les valeurs postbackData sont les mêmes.

Lorsque le destinataire répond avec l'une des options, il est reçu par votre webhook de messages entrants sous la forme d'un rcs avec une valeur de message_type de reply. La charge utile JSON du message reply comprendra un objet reply avec deux propriétés : title, qui contient la valeur de l'option de réponse sélectionnée text de l'option de réponse sélectionnée ; et idqui contient la valeur de l'option postbackData de l'option de réponse sélectionnée.

Comment envoyer un message d'action suggérée RCS

Les messages d'action suggérée vous permettent de proposer au destinataire une action qui interagira avec une app native ou installée sur l'appareil avec lequel il reçoit le message. Par exemple, ouvrir une URL dans un navigateur, afficher un lieu dans une carte ou une application de localisation, etc. Comme pour les réponses suggérées, il existe de nombreux cas d'utilisation pour les différents types de messages d'action suggérée. De la même manière que pour les réponses suggérées, les actions suggérées apparaissent sous forme de "puces" ou de boutons dans l'interface utilisateur de l'appareil, sur lesquels le destinataire peut appuyer pour déclencher l'action.

Les actions disponibles sont les suivantes :

• openUrlAction

• dialAction

• viewLocationAction

• shareLocationAction

• createCalendarEventAction

Avec tous les types d'action suggérés, vous pouvez en inclure certains qui apparaîtront dans le message principal, ainsi que d'autres qui ne figureront pas dans le message. text qui apparaîtront dans le message principal et d'autres text dans l'action elle-même qui apparaîtra sur la "puce"/le bouton.

Toutes les actions contiennent une propriété postbackData dont la valeur sera reçue comme la valeur de la propriété payload dans un message entrant de type rcs de type button.

Prenons quelques exemples.

Comment envoyer un message Créer un événement de calendrier avec le SDK Python ?

Commençons par l'action Créer un événement dans le calendrier. Cette action permet à votre message d'interagir avec l'application de calendrier du téléphone du destinataire afin de créer un événement dans ce calendrier. Un cas d'utilisation possible de cette action serait la confirmation d'un rendez-vous, par exemple un rendez-vous chez le médecin ou le dentiste.

Le message s'afficherait dans l'application de messagerie avec une option permettant de créer un événement de calendrier.

Screenshot of an RCS suggested action message to create a calendar eventSi cette option est sélectionnée, l'application de calendrier par défaut de l'appareil s'ouvre et permet à l'utilisateur d'enregistrer l'événement dans son calendrier.

Screenshot of a calendar appliction with a option to save an event

Dans cette action, vous définissez un title et description de l'événement du calendrier ainsi que le startTime et endTime (qui représentent l'heure et la date de début et de fin de l'événement). Notez le décalage par rapport à l'UTC.

vonage_client.messages.send_message(
    {
        "channel": "rcs",
        "message_type": "custom",
        "to": '447900000000',
        "from": 'VonageRCSAgent',
        "custom": {
            "contentMessage": {
                "text": "Dear Mr Smith, we're happy to confirm your appointment at 14:30h on Tuesday the 1st of October at Healthy Smile Dental Co.",
                "suggestions": [
                    {
                        "action": {
                            "text": "Save to calendar",
                            "postbackData": "postback_data_1234",
                            "fallbackUrl": "https://www.google.com/calendar",
                            "createCalendarEventAction": {
                                "startTime": "2024-10-01T14:30:00+01:00",
                                "endTime": "2024-10-01T15:00:00+01:00",
                                "title": "Dental Appointment",
                                "description": "Dental Appointment at Healthy Smile Dental Co.",
                            },
                        }
                    }
                ],
            }
        },
    }
)

Comment envoyer un message de partage d'emplacement avec le SDK Java ?

L'action Partager un lieu, lorsqu'elle est sélectionnée, invite le destinataire du message à partager un lieu géographique en ouvrant la carte par défaut de l'appareil ou l'application de localisation. Une fois que le destinataire a sélectionné un lieu, il peut l'envoyer en réponse au message qu'il a reçu. La réponse du destinataire sera reçue via votre webhook de messages entrants sous la forme d'un rcs avec une valeur de message_type de location. La charge utile JSON de ce message contiendra un objet location avec lat et long spécifiant l'emplacement partagé.

Ce type de message peut notamment être utilisé par un service de taxi qui demande à un client de spécifier un point de ramassage.

Le message reçu comporterait une option permettant de partager un lieu.

Screenshot of an RCS suggested action message to share a locationSi cette option est sélectionnée, l'application cartographique par défaut de l'appareil s'ouvrira, ce qui permettra au destinataire de placer une épingle et de partager sa position.

Screenshot of a map application with a pin and option to send location

var response = vonageClient.getMessagesClient().sendMessage(
	RcsCustomRequest.builder()
		.from('VonageRCSAgent').to('447900000000')
		.custom(Map.of("contentMessage", Map.of(
				"text", "Your driver will come and meet you at your specified location.",
				"suggestions", List.of(
					Map.of(
						"action", Map.of(
							"text", "Share your pickup location",
							"postbackData", "postback_data_1234",
							"shareLocationAction", Map.of()
						)
					)
				)
			))
		).build()
);

Synthèse et prochaines étapes

Dans cet article, nous avons étudié quelques exemples d'envoi de différents types de messages RCS à l'aide des SDK de Vonage. En réalité, nous n'avons fait qu'effleurer la surface, et il existe d'innombrables cas d'utilisation potentiels de la messagerie RCS. Nous aborderons d'autres exemples de messagerie RCS dans de futurs articles de blog, alors n'hésitez pas à revenir bientôt !

Si vous avez envie de créer quelque chose de génial avec le canal RCS de l'API Messages de Vonage, n'oubliez pas de jeter un coup d'œil à la documentation de l'API Messages et les extraits de code.

Merci de votre lecture ! Vous pouvez nous suivre sur X pour plus d'informations sur Vonage Dev, ou rejoignez-nous sur notre espace de travail espace de travail Slack de la communauté Vonage.