Messagerie
Envoyer des messages RCS
Le RCS est la messagerie enrichie intégrée aux applications de messages Android : votre nom et votre logo vérifiés, des images, des cartes, des carrousels et des boutons, avec repli automatique en SMS.
Avant de commencer
Les messages RCS partent d’un expéditeur vérifié : nom de marque, logo, couleur et description, validés avant la première utilisation. Demandez-en un depuis le tableau de bord. Son identifiant est le sender de chaque requête.
POST/rcs/2/messages
Texte avec suggestions
Le message RCS le plus simple est un texte suivi de suggestions. Une suggestion touchée revient sur votre webhook entrant avec son postbackData.
Cartes enrichies
Une carte réunit une image ou une vidéo, un titre, une description et jusqu’à quatre boutons. Réglez orientation sur VERTICAL ou HORIZONTAL, et media.height sur SHORT, MEDIUM ou TALL.
Carrousels
Un carrousel est une rangée de cartes que l’on fait défiler, chacune avec ses boutons. cardWidth vaut SMALL ou MEDIUM.
Types de suggestions
Chaque suggestion a un type, un text affiché sur le bouton et un postbackData renvoyé quand on la touche.
| type | Champs en plus | Effet |
|---|---|---|
REPLY | aucun | Renvoie le texte comme réponse de la personne. |
OPEN_URL | url, application (BROWSER ou WEBVIEW) | Ouvre un lien. |
DIAL_PHONE | phoneNumber | Lance un appel vers ce numéro. |
SHOW_LOCATION | latitude, longitude, label | Ouvre une carte à cet endroit. |
REQUEST_LOCATION | aucun | Demande à la personne de partager sa position. |
CREATE_CALENDAR_EVENT | startTime, endTime, title, description | Ajoute un événement à son agenda. |
Repli en SMS
Tous les téléphones ne gèrent pas le RCS. Ajoutez options.smsFailover et le message part en SMS quand le RCS n’est pas disponible ou pas remis dans la validityPeriod. Rédigez un texte de repli autonome : il n’aura ni boutons ni images.
Rapports de remise et de lecture
webhooks.delivery.url reçoit les rapports de remise au même format que les SMS, avec interactionType et conversation en plus. webhooks.seen.url reçoit un événement quand la personne ouvre le message.
Réponses et boutons touchés
Indiquez l’URL du webhook entrant sur votre expéditeur RCS, dans le tableau de bord. Chaque événement indique qui a écrit (sender), et message.type précise ce que c’est : TEXT, FILE, LOCATION, ou SUGGESTION pour un bouton touché.