Cette page a été traduite par l'API Cloud Translation.

Modèle de facturation aux États-Unis

Ce document décrit le modèle de facturation du trafic RCS for Business sur les opérateurs américains.

Pour en savoir plus sur le modèle de facturation standard (pour le trafic hors États-Unis), consultez les questions fréquentes sur la facturation.
Pour en savoir plus sur les rapports, consultez le guide Rapports sur la facturation et journaux d'activité.

Présentation des classifications de facturation aux États-Unis

Chaque message envoyé à un numéro de téléphone américain ou reçu d'un tel numéro est automatiquement classé dans l'un des trois types suivants en fonction de son format :

Message enrichi (bidirectionnel)
Message rich media (bidirectionnel)
Clic sur l'action suggérée (initié par l'utilisateur)

Pour obtenir des spécifications détaillées, consultez les sections suivantes.

Remarque sur la terminologie

Pour décrire la direction du trafic de messages, les opérateurs américains utilisent généralement la terminologie MT/MO. Ces termes correspondent à la terminologie A2P/P2A utilisée dans la documentation RCS for Business :

MT (Mobile Terminated) est A2P (Application-to-Person) : message envoyé par l'entreprise.
MO (Mobile Originated) est P2A (Person-to-Application) : message ou action initiée par l'utilisateur.

Facturation des événements Agent-to-Person (A2P/MT)

Cette section décrit la logique de facturation des messages envoyés par un agent (c'est-à-dire les messages A2P ou MT).

Messages enrichis (A2P)

Un message est classé comme message enrichi s'il contient uniquement une combinaison des éléments suivants :

Texte
Réponses suggérées
Actions suggérées des types suivants uniquement :
- Composer un numéro
- Ouvrir l'URL dans le navigateur standard, et non dans une WebView

Logique de facturation pour les messages enrichis

Un message enrichi est facturé en fonction des segments.

Taille du segment : 1 segment = 160 octets de texte encodé en UTF-8.
Calcul : la longueur totale en octets UTF-8 du texte du message est divisée par 160 et toujours arrondie à l'entier supérieur.
Exclusions : le texte et les données de postback dans les réponses ou actions suggérées ne sont pas inclus dans le nombre de segments.
Exemple : Un message texte de 300 octets comporte deux segments (300 / 160 = 1,875, arrondi à 2).

Nombre d'octets

Certains caractères Unicode (comme les emoji ou les lettres accentuées) sont multi-octets. Le nombre total d'octets UTF peut donc être différent du nombre de caractères.

Pour vérifier le nombre exact d'octets d'un message, saisissez-le ou collez-le ci-dessous.

Messages rich media (A2P)

Un message est classé comme message rich media s'il contient au moins un des éléments suivants :

Une carte enrichie ou un carrousel (même sans élément multimédia)
Pièce jointe de fichier multimédia (image, vidéo, fichier audio)
Une action suggérée autre que "Composer un numéro" ou "Ouvrir une URL avec le navigateur", y compris :

Logique de facturation des messages rich media

Un message rich media est facturé comme un événement unique à tarif fixe.

La facturation est la même, quelle que soit la longueur du texte, le nombre de cartes ou la taille du fichier multimédia.
La segmentation ne s'applique pas.

Exemples de réponses d'API A2P

Ces exemples montrent le champ richMessageClassification dans une réponse d'appel d'API RBM réussi pour les messages envoyés par l'agent.

Exemple de réponse de l'API pour un `RICH_MESSAGE`

{
  "name": "...",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "contentMessage": {
     ...
  },
  "richMessageClassification": {
    "classificationType": "RICH_MESSAGE",
    "segmentCount": 5
  }
}

Exemple de réponse de l'API pour un `RICH_MEDIA_MESSAGE`

{
  "name": "...",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "contentMessage": {
     ...
  },
  "richMessageClassification": {
    "classificationType": "RICH_MEDIA_MESSAGE"
  }
}

Facturation des événements Personne-à-Agent (P2A/MO)

Cette section traite de la facturation des messages et des actions initiés par un utilisateur (c'est-à-dire les messages P2A ou MO).

Messages enrichis (P2A)

Un message utilisateur est classé comme message enrichi s'il ne contient que du texte. Cela inclut à la fois le texte au format libre et le texte qui résulte de la sélection d'une réponse suggérée. (Les réponses suggérées peuvent inclure un identifiant de données de postback dans la charge utile du message.)

Logique de facturation : facturation basée sur les segments. Pour en savoir plus sur le calcul du nombre de segments, consultez Logique de facturation des messages enrichis.

Messages rich media (P2A)

Un message est classé comme message rich media s'il contient un fichier importé (image, vidéo, audio).

Logique de facturation : facturé comme un événement unique à tarif fixe. La segmentation ne s'applique pas.

Clics sur les actions suggérées

Lorsqu'un utilisateur appuie sur une action suggérée, un événement facturable appelé "Clic sur l'action suggérée" est généré. (Les actions suggérées peuvent inclure un identifiant de données de postback dans la charge utile du message.)

Logique de facturation : génère un événement facturable par clic.

La localisation du partage est unique, car elle génère deux événements facturables P2A distincts :

Clic sur l'action suggérée : lorsque l'utilisateur appuie sur l'action suggérée Partager la position, un événement Clic sur l'action suggérée est généré.
Message de localisation : une fois que l'utilisateur a sélectionné un lieu sur l'interface de la carte, un message contenant les coordonnées du lieu est envoyé à l'agent. Ce message MO génère un événement Rich Message avec un nombre de segments égal à un.

Exemples de réponses de webhook P2A

Ces exemples montrent le champ richMessageClassification dans les webhooks envoyés à l'agent pour les événements déclenchés par l'utilisateur.

Exemple de webhook pour un `RICH_MESSAGE` envoyé par un utilisateur

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "text": "Hello, world!",
  "richMessageClassification": {
    "classificationType": "RICH_MESSAGE",
    "segmentCount": 1
  }
}

Exemple de webhook pour un `RICH_MEDIA_MESSAGE` envoyé par un utilisateur

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "userFile": "...",
  "payload": "...",
  "richMessageClassification": {
    "classificationType": "RICH_MEDIA_MESSAGE"
  }
}

Exemple de webhook pour un `SUGGESTED_ACTION_CLICK`

{
    "agentId": "...",
    "senderPhoneNumber": "...",
    "messageId": "...",
    "sendTime": "...",
    "suggestionResponse": {
        "text": "Click here",
        "postbackData": "...",
        "type": "ACTION"
    },
    "richMessageClassification": {
        "classificationType": "SUGGESTED_ACTION_CLICK"
    }
}

Exemple de webhook pour un message de localisation

Il s'agit du deuxième événement facturable du flux de partage de position, envoyé après que l'utilisateur a partagé sa position depuis la carte.

{
    "agentId": "...",
    "senderPhoneNumber": "...",
    "messageId": "...",
    "sendTime": "...",
    "location": {
      "latitude": 37.422000,
      "longitude": -122.084056
    },
    "richMessageClassification": {
        "classificationType": "RICH_MESSAGE",
        "segmentCount": 1
    }
}

Remarques techniques et d'implémentation

Les segments ne sont utilisés qu'à des fins de facturation : les longs messages sont envoyés en une seule fois sur l'appareil de l'utilisateur. Le nombre de segments est un calcul virtuel à des fins de facturation. Il n'a aucune incidence sur la façon dont les messages sont distribués ou présentés à l'utilisateur.
Classification automatique : la classification des messages est entièrement automatique en fonction de leur contenu et ne peut pas être remplacée manuellement.
Déploiement : le modèle de facturation américain a été activé sur la plate-forme RCS for Business le 15 juillet 2025. À partir de cette date, les rapports et les réponses d'API de Google refléteront les nouvelles classifications.