Cette page décrit les fichiers de données créés par RCS for Business pour aider les opérateurs américains à effectuer la facturation et l'audit dans le cadre de l'US RBM Framework. Pour en savoir plus sur l'US RBM Framework, consultez également usrbm.org.
Le rapport sur la facturation est un rapport agrégé des événements facturables entre les agents lancés et les utilisateurs. Un événement est facturable s'il peut être facturé. Les opérateurs déterminent si et comment les événements facturables sont facturés. Tous les opérateurs américains qui utilisent activement RCS for Business ont accès aux rapports de facturation.
Pour en savoir plus sur le modèle de classification de la facturation aux États-Unis, consultez les questions fréquentes sur la facturation aux États-Unis.
Génération de fichiers
Pour en savoir plus, consultez la section Génération de fichiers.
Stockage et accès aux fichiers
Pour en savoir plus, consultez la section Stockage et accès aux fichiers.
Disponibilité des fichiers
Pour en savoir plus, consultez la section Disponibilité des fichiers.
Rapports sur la facturation
Les rapports sur la facturation sont des enregistrements d'événements facturables, qui sont calculés en fonction de la catégorie de facturation de l'agent et du type de messages qu'il envoie. Les rapports sur la facturation sont disponibles pour tous les opérateurs qui utilisent activement RCS for Business.
Les rapports sur la facturation contiennent des informations confidentielles, mais aucune information permettant d'identifier personnellement l'utilisateur, comme le MSISDN, le MSISDN haché ou tout identifiant unique de l'utilisateur.
Catégories de facturation et événements facturables
La distinction entre les catégories de facturation des agents et les événements facturables est essentielle pour comprendre comment votre agent est facturable.
- La catégorie de facturation est une classification fixe que vous choisissez lorsque vous créez votre agent. Elle détermine la méthode de facturation de votre agent : par message (agents non conversationnels) ou par session (agents conversationnels).
- Les événements facturables sont des interactions entre un agent RCS for Business et un utilisateur qui sont suivies à des fins de facturation (par exemple,
rich_message).
Catégories de facturation des agents aux États-Unis
Lors de la création d'un agent, le propriétaire définit sa catégorie de facturation en fonction de la façon dont l'agent interagira avec les utilisateurs. La catégorie de facturation ne limite pas le nombre ni le type de messages qu'un agent peut envoyer. Toutefois, elle détermine comment l'agent sera facturable pour les messages. Les deux principales catégories de facturation sont décrites dans le tableau suivant.
| Catégorie de facturation | Type d'agent | Exemples de cas d'utilisation | Mode de facturation |
|---|---|---|---|
| Non conversationnel | Agents qui envoient principalement des messages unidirectionnels. |
|
Facturable pour chaque message distribué à l'utilisateur. |
| Conversationnel | Agents conçus pour les échanges bidirectionnels avec les utilisateurs, quel que soit l'initiateur de la conversation. |
|
Facturable par session : si les critères de la session sont remplis, tous les messages enrichis et multimédias enrichis de la fenêtre de session de 24 heures sont facturables à un tarif forfaitaire, quelle que soit leur longueur ou le nombre de segments. Facturable par message : si les critères de la session ne sont pas remplis ou si un message ne fait pas partie de la fenêtre de session de 24 heures, il est facturable individuellement au tarif par message pour les messages enrichis ou multimédias enrichis, conformément à la grille tarifaire de l'opérateur. |
Agents conversationnels et non conversationnels
Il existe deux catégories de facturation des agents : conversationnels et non conversationnels.
Les agents non conversationnels sont facturables pour chaque message qu'ils distribuent à l'utilisateur.
- Cette catégorie est idéale pour les agents qui ne s'attendent pas à des réponses fréquentes.
Les agents conversationnels sont facturables à un tarif forfaitaire pour la ou les sessions , à condition qu'une session soit déclenchée. Elle inclut ensuite tous les messages échangés sur une période de 24 heures, y compris les messages qui ont déclenché la session. Les agents conversationnels peuvent toujours être facturés pour les messages qui ne font pas partie d'une session de 24 heures.
- Cette catégorie est idéale pour les agents qui participent à des conversations en plusieurs étapes avec les utilisateurs.
Logique de facturation des sessions
Dans le modèle de facturation américain, une session est déclenchée par une séquence de quatre messages enrichis ou multimédias enrichis (dont au moins deux messages MO et au moins un message MT) échangés dans une fenêtre de 24 heures à compter du premier message de la séquence de déclenchement. Une fois ce seuil atteint, tous les messages de cette fenêtre de 24 heures sont facturables en tant que session unique. Tous les messages qui ne font pas partie d'une session ou qui ne la déclenchent pas sont facturables au tarif par message standard pour les messages enrichis ou multimédias enrichis, conformément à la grille tarifaire de l'opérateur.
Le schéma suivant montre un exemple de session de facturation A2P pour les agents conversationnels.
- MT (Mobile Terminated) est un message envoyé par l'entreprise.
- MO (Mobile Originated) est un message ou une action initiée par l'utilisateur.
Événements facturables
Les flux de messagerie sont classés par origine et par direction. Pour décrire la direction du trafic de messagerie, les opérateurs américains utilisent généralement la terminologie MT/MO. Ces termes correspondent à la terminologie A2P/P2A utilisée dans toute la documentation RCS for Business. Voici un bref aperçu de la façon dont ces termes s'alignent :
- A2P (Application-to-Person) est MT (Mobile Terminated) : message envoyé par l'entreprise.
- P2A (Person-to-Application) est MO (Mobile Originated) : message ou action initiée par l'utilisateur.
| Événement | Description | Agents non conversationnels | Agents conversationnels |
|---|---|---|---|
a2p_rich_message |
Message envoyé par un agent contenant uniquement du texte, des réponses suggérées ou des actions suggérées spécifiques (composer un numéro, ouvrir une URL dans le navigateur). | Toujours traité comme un événement facturable individuel. Facturable par message en fonction des segments (1 segment équivaut à 160 octets UTF-8). |
Traité comme un événement facturable individuel, sauf s'il fait partie d'une session. |
p2a_rich_message |
Message envoyé par un utilisateur contenant uniquement du texte libre ou du texte provenant d'une réponse suggérée. | Toujours traité comme un événement facturable individuel. Facturable par message en fonction des segments. |
Traité comme un événement facturable individuel, sauf s'il fait partie d'une session. |
a2p_rich_media_message |
Message envoyé par un agent contenant des éléments multimédias (image, vidéo, audio), des fiches enrichies, des carrousels ou des actions complexes telles que "Afficher le lieu". | Toujours traité comme un événement facturable individuel. Facturable en tant qu'événement unique à tarif forfaitaire, quelle que soit sa taille ou son contenu. |
Traité comme un événement facturable individuel, sauf s'il fait partie d'une session. |
p2a_rich_media_message |
Message envoyé par un utilisateur contenant un fichier multimédia importé (image, vidéo, audio). | Toujours traité comme un événement facturable individuel. Facturable en tant qu'événement unique à tarif forfaitaire. |
Traité comme un événement facturable individuel, sauf s'il fait partie d'une session. |
p2a_suggested_action |
Un utilisateur appuie sur une action suggérée (par exemple, "Afficher le lieu") qui n'est pas une réponse suggérée. | Toujours traité comme un événement facturable individuel. Génère un événement facturable par clic. |
Traité comme un événement facturable individuel et génère un événement facturable par clic, sauf s'il fait partie d'une session. |
a2p_session |
Fenêtre d'interaction de 24 heures qui commence lorsqu'un déclencheur de session est initié et que le premier message est MT. Pour en savoir plus, consultez Qu'est-ce qu'une session et comment fonctionne-t-elle ? | N/A. Les sessions ne s'appliquent pas aux agents non conversationnels. | Une fois déclenchés, tous les messages de la fenêtre de 24 heures sont couverts par des frais de session uniques. Tout événement facturable de la session de 24 heures sera attribué à l'ID d'événement facturable de la session. |
p2a_session |
Fenêtre d'interaction de 24 heures qui commence lorsqu'un déclencheur de session est initié et que le premier message est MO. Pour en savoir plus, consultez Qu'est-ce qu'une session et comment fonctionne-t-elle ? | N/A. Les sessions ne s'appliquent pas aux agents non conversationnels. | Une fois déclenchés, tous les messages de la fenêtre de 24 heures sont couverts par des frais de session uniques. Tout événement facturable de la session de 24 heures sera attribué à l'ID d'événement facturable de la session. |
Génération de rapports sur la facturation
Seuls les agents dont le trafic n'est pas celui de testeurs génèrent des événements facturables. L'activité des numéros de téléphone de test n'apparaît pas dans les rapports sur la facturation.
Ces rapports supposent que les événements sont facturables lorsque les messages A2P sont distribués, et non lorsqu'ils sont envoyés. Un message non distribué ou un message annulé avant la distribution ne déclenche pas d'événement facturable.
Format des rapports sur la facturation
Les rapports sur la facturation utilisent le format de nom de fichier rbm_billable_events_YYYY-MM-DD.csv.
La date figurant dans le nom du fichier correspond à la date de génération du fichier.
Chaque ligne du rapport est un enregistrement représentant un seul événement facturable.
Les sessions A2P/P2A sont représentées par plusieurs lignes, une pour chaque message échangé. Chaque ligne associée à une session (partageant le même billing_event_id) indique le nombre total de messages MT et MO pour l'ensemble de la fenêtre de session de 24 heures dans les colonnes mt_messages et mo_messages.
Chaque enregistrement du rapport contient les informations suivantes pour chaque événement facturable.
| Champ | Format | Description | Exemple |
|---|---|---|---|
billing_event_id |
chaîne | ID généré qui distingue l'événement facturable. Tous les messages qui font partie d'une session auront le même |
63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e |
type |
chaîne | Type d'événement :a2p_rich_messagea2p_rich_media_messagep2a_rich_messagep2a_rich_media_messagep2a_suggested_action |
p2a_rich_message |
agent_id |
chaîne | Identifiant unique de l'agent qui a participé à l'événement. | acme_342h23_agent@rbm.goog |
agent_owner |
chaîne | Adresse e-mail du propriétaire actuel du compte partenaire dans lequel l'agent a été créé. | marketing@xyzaggregator.com |
billing_party |
chaîne | Partie qui facture les événements. | opérateur |
max_duration_single_message |
nombre | Durée maximale (en heures) autorisée pour qu'un utilisateur réponde à un message d'agent avant la fermeture de la fenêtre d'initiation de la conversation et la classification du message en tant qu'événement single_message. Ne s'applique pas au modèle américain pour les messages enrichis individuels. |
24 |
max_duration_a2p_conversation |
nombre | Pour le pilote des sessions, cela correspond à la fenêtre de session de 24 heures mesurée à partir du premier message de la séquence de déclenchement. La durée est mesurée en heures. | 24 |
max_duration_p2a_conversation |
nombre | Pour le pilote des sessions, cela correspond à la fenêtre de session de 24 heures mesurée à partir du premier message de la séquence de déclenchement. | 24 |
start_time |
YYYY-mm-ddTHH:00:00Z | Date/heure UTC de début de l'événement (ISO 8601). Pour les sessions, il s'agit de l'horodatage du premier message de la séquence de déclenchement. A2P a2p_rich_message et a2p_rich_media_message, il s'agit de l'heure à laquelle le message est distribué à l'utilisateur.a2p_session, il s'agit de l'heure à laquelle le premier message de la conversation est distribué à l'utilisateur.P2A p2a_rich_message et p2a_rich_media_message, il s'agit de l'heure à laquelle le message est envoyé par l'utilisateur.p2a_session, il s'agit de l'heure à laquelle le premier message de la conversation est envoyé par l'utilisateur. |
2025-05-20T08:00:00Z |
duration |
nombre | La durée ne concerne que les sessions et est mesurée en minutes. Lorsque l'événement n'est pas un événement de session, la valeur est 0. | 45 |
mt_messages |
nombre | Nombre de messages MT (A2P) dans l'événement. Pour les sessions, chaque ligne partageant le même billing_event_id indique le nombre total de messages MT dans l'ensemble de la session. |
5 |
mo_messages |
nombre | Nombre de messages MO (P2A) dans l'événement. Pour les sessions, chaque ligne partageant le même billing_event_id indique le nombre total de messages MO dans l'ensemble de la session. |
3 |
size_kilobytes |
nombre | Taille de tous les fichiers joints aux messages de l'événement, arrondie au kilooctet le plus proche (1 ko équivaut à 1 024 octets). | 912 |
agent_name |
chaîne | Nom de l'agent qui a participé à l'événement. | ACME Brand |
owner_name |
chaîne | Nom du propriétaire actuel du compte partenaire dans lequel l'agent a été créé. | XYZ Aggregator |
segment_count |
nombre | Nombre de segments calculé pour les événements a2p_rich_message events et p2a_rich_message (1 segment équivaut à 160 octets UTF-8). Lorsque l'événement n'est pas l'un de ceux mentionnés, la valeur est 0. |
5 |
session_type |
chaîne | Type de session :a2p_sessionp2a_session |
a2p_session |
Exemple de rapport sur la facturation
Un exemple de rapport est disponible en téléchargement :
Taille de fichier standard
La taille d'un rapport quotidien d'un partenaire RCS for Business actif dépend de la quantité d'activité qu'il a générée sur le réseau de l'opérateur.