Messages RCS via Twilio

Les messages RCS (Rich Communication Services) arrivent dans l’application de messagerie intégrée du téléphone sous la forme d’une conversation avec votre marque, avec votre logo et une carte, un carrousel, des médias ou des boutons au lieu d’un simple texte. Pushwoosh les envoie via Twilio dans le cadre du canal SMS.

Fonctionnement

Un message RCS passe d’un modèle Twilio au téléphone en trois étapes :

Vous créez le message sous forme de modèle de contenu dans Twilio.
Vous choisissez le modèle dans un préréglage SMS. Chaque langue du préréglage peut avoir son propre modèle.
Lorsque le préréglage est envoyé, Twilio tente de livrer le modèle via RCS. Les téléphones qui ne peuvent pas recevoir de RCS reçoivent un SMS à la place, comme décrit dans SMS de repli.

Si vous choisissez un modèle pour certaines langues du préréglage seulement, les autres langues ne sont pas envoyées via RCS. Elles partent sous forme de SMS classique avec le texte de leur champ Message.

SMS de repli

Le SMS de repli est ce que reçoivent les téléphones sans RCS à la place du message RCS. Si le téléphone ou l’opérateur du destinataire ne prend pas en charge le RCS, Twilio envoie un SMS construit à partir du type Text du modèle.

Le SMS de repli provient du modèle, et non du champ Message du préréglage. Si le modèle n’a pas de type Text, les téléphones sans RCS ne reçoivent pas du tout le message.

Prérequis pour envoyer des RCS

Le RCS fonctionne uniquement via votre propre compte Twilio, avec un Messaging Service et un expéditeur RCS approuvé par les opérateurs.

Twilio comme fournisseur SMS. Connectez-le avec vos propres Account SID et Auth token Twilio. Si Pushwoosh fournit le numéro Twilio et les identifiants de votre projet, le RCS n’est pas disponible et ces envois sont rejetés.
Un Messaging Service Twilio. Son pool d’expéditeurs contient un expéditeur RCS et un numéro SMS. Son SID se saisit dans Messaging Service SID dans les paramètres de la plateforme SMS. Sans lui, l’envoi d’un message avec modèle échoue.
Un numéro d’expéditeur (From). Dans les paramètres de la plateforme SMS, indiquez le numéro SMS du pool du Messaging Service. Sans lui, Pushwoosh n’envoie pas de SMS Twilio, même si un Messaging Service est défini.
Un expéditeur RCS approuvé par les opérateurs dans les pays vers lesquels vous envoyez. Twilio gère l’enregistrement. Selon Twilio, il prend 4 à 6 semaines ou plus par pays.

Configurer le RCS dans Twilio

Ces étapes se déroulent dans la Twilio Console. Les noms de menus suivent le guide d’intégration RCS de Twilio et peuvent légèrement différer dans votre console.

Créer un expéditeur RCS

L’expéditeur RCS est le profil de marque que les destinataires voient dans la conversation : votre nom, votre logo et vos couleurs.

Allez dans Communications → Numbers & senders → Overview → RCS.
Cliquez sur Create RCS Sender.
Saisissez un Sender display name.
Acceptez les conditions et cliquez sur Continue.
Sur Public details, remplissez tous les champs :
- Display name et Description.
- Logo image (224×224 px, jusqu’à 50 Ko) et Banner image (1440×448 px, jusqu’à 200 Ko), sous forme d’URL publiques JPG ou PNG.
- Accent color avec un rapport de contraste d’au moins 4,5:1 par rapport au blanc, par exemple #1A73E8.
- Un numéro de téléphone ou un e-mail de contact, une Privacy policy URL et une Terms of service URL.
Cliquez sur Next.

Ajouter un téléphone de test

Tant que les opérateurs n’ont pas approuvé l’expéditeur, celui-ci ne livre qu’aux téléphones de test.

Sur Try it out, cliquez sur Add device to test this sender.
Saisissez un numéro de téléphone Android au format international et cliquez sur Invite.
Sur le téléphone, ouvrez l’invitation dans Google Messages et appuyez sur Make me a tester.
Dans la console, vérifiez que le propriétaire a accepté l’invitation.
Envoyez un message depuis Your message. Il doit arriver sous forme de conversation avec votre marque et son logo, et non sous forme de SMS.

Enregistrer l’expéditeur auprès des opérateurs

Twilio n’ajoute un expéditeur RCS à un Messaging Service qu’après l’approbation d’au moins un opérateur. Commencez donc l’enregistrement avant de créer le Messaging Service.

Sur l’expéditeur RCS, ouvrez Compliance registration.
Cliquez sur Add countries.
Sélectionnez les pays vers lesquels vous envoyez et cliquez sur Save countries.
Cliquez sur Start.
Remplissez le formulaire et cliquez sur Submit registration. Pour les États-Unis, Twilio propose un formulaire distinct, US registration.

Le statut de l’enregistrement reste Pending Review jusqu’à l’approbation des opérateurs.

Créer un Messaging Service

Le Messaging Service regroupe l’expéditeur RCS et un numéro SMS, afin que Twilio puisse choisir le RCS ou le SMS pour chaque téléphone.

Allez dans Messaging → Services.
Créez un service.
Dans Sender Pool, ajoutez un numéro Twilio compatible SMS. Sans lui, les téléphones sans RCS ne reçoivent rien.
Dès qu’au moins un pays affiche Approved dans Compliance registration, ajoutez l’expéditeur RCS au Sender Pool.
Copiez le SID du service. Il commence par MG.

Créer un modèle de contenu

Le modèle de contenu définit le message RCS et son SMS de repli.

Allez dans Messaging → Content Template Builder.
Cliquez sur Create new.
Choisissez un type compatible RCS : Card, Carousel, Quick reply, Call to action ou Media.
Remplissez le contenu. Pour une valeur qui change selon le destinataire, utilisez une variable numérotée, par exemple {{1}} pour le prénom dans le titre de la carte.
Pour créer des branches dans un Journey selon la réponse, ajoutez des boutons de réponse rapide et attribuez un ID à chacun. N’utilisez pas default ni un ID commençant par output : un tel bouton n’obtient pas de branche dans le Journey.
Ajoutez le type Text au même modèle. Twilio construit le SMS de repli à partir de celui-ci.
Enregistrez le modèle.

Connecter Twilio dans Pushwoosh

Pushwoosh envoie les RCS avec les identifiants Twilio et le Messaging Service que vous saisissez dans les paramètres de la plateforme SMS.

Allez dans Paramètres → Configurer les plateformes.
Ouvrez SMS.
Définissez Twilio comme fournisseur SMS.
Remplissez les champs :
- From number : le numéro SMS du pool du Messaging Service.
- Account SID et Auth token : les identifiants du compte Twilio propriétaire de l’expéditeur RCS et des modèles.
- Messaging Service SID (optional) : le SID MG du Messaging Service. Le champ est facultatif pour les SMS, mais le RCS en a besoin.
Cliquez sur Appliquer.

Pour les autres paramètres SMS, consultez Configuration de la plateforme SMS. Les statuts de livraison des messages RCS ne nécessitent aucune configuration de webhook, car Pushwoosh transmet l’URL de rappel de statut à Twilio avec chaque message.

Recevoir les réponses

Les réponses aux messages RCS n’atteignent Pushwoosh que via un webhook que vous définissez sur l’expéditeur RCS.

Dans la Twilio Console, ouvrez l’expéditeur RCS et allez dans Configuration.
Définissez Webhook URL for incoming messages sur l’URL des SMS entrants indiquée dans Webhooks du fournisseur SMS, avec la méthode POST.
Cliquez sur Save configuration.

Pushwoosh traite une réponse RCS de la même façon qu’une réponse SMS. Il déclenche l’événement PW_SMSReceived pour le numéro de téléphone de l’expéditeur, et une réponse STOP définit le tag de consentement marketing de l’abonné sur false. Consultez Consentement marketing SMS et Viber.

Envoyer un message RCS

Un message RCS part partout où vous envoyez un préréglage SMS qui comporte un modèle.

Ouvrez ou créez un préréglage SMS.
Choisissez un modèle Twilio pour chaque langue dans le bloc RCS, comme décrit dans Envoyer via RCS.
Envoyez le préréglage dans une campagne SMS ou un Customer Journey.

Dans un Journey, un élément SMS avec un modèle de réponse rapide obtient une branche pour chaque bouton et attend un appui jusqu’à 24 heures. Consultez Créer des branches selon les boutons de réponse RCS.

Consulter les statistiques RCS

Pour voir combien de livraisons ont été confirmées via RCS, combien sont arrivées en SMS et quelle part des destinataires RCS a lu le message, ouvrez les statistiques du message de l’envoi.