Cette page décrit les fichiers de données créés par RCS for Business pour aider les opérateurs américains à facturer et à auditer dans le cadre du référentiel RBM américain. Pour en savoir plus sur ce référentiel, consultez le site usrbm.org .
Le rapport de facturation est un récapitulatif des événements facturables entre les agents et les utilisateurs. Facturable signifie simplement qu'un événement est éligible à une facturation. Les opérateurs déterminent si et comment les événements sont facturés. Tous les opérateurs américains qui utilisent activement RCS for Business ont accès aux rapports de facturation.
Pour plus de détails sur le modèle de classification de facturation américain, consultez la FAQ sur la facturation américaine .
génération de fichiers
Pour plus d'informations, consultez la section Génération de fichiers .
Stockage et accès aux fichiers
Pour plus d'informations, consultez la section Stockage et accès aux fichiers .
Disponibilité des fichiers
Pour plus d'informations, consultez la section Disponibilité des fichiers .
Rapports de facturation
Les rapports de facturation répertorient les événements facturables , calculés en fonction de la catégorie de facturation de l'agent et du type de messages envoyés. Ces rapports sont accessibles à tous les opérateurs utilisant activement RCS for Business.
Les rapports de facturation contiennent des informations confidentielles, mais aucune information personnelle identifiable (IPI) de l'utilisateur, telle que le MSISDN, le MSISDN haché ou tout autre identifiant unique de l'utilisateur.
Catégories de facturation versus é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 facturé.
- La catégorie de facturation est une classification fixe que vous choisissez lors de la création de votre agent. Elle détermine le mode 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 américains
Lors de la création d'un agent, le propriétaire définit sa catégorie de facturation en fonction de la manière dont l'agent interagira avec les utilisateurs. Cette catégorie ne limite ni le nombre ni le type de messages que l'agent peut envoyer, mais détermine le mode de facturation de ces messages. Les deux principales catégories de facturation sont décrites dans le tableau ci-dessous.
| Catégorie de facturation | Type d'agent | Exemples de cas d'utilisation | Méthode de facturation |
|---|---|---|---|
| Non conversationnel | Agents qui envoient principalement des messages à sens unique. |
| Facturation pour chaque message transmis à l'utilisateur. |
| De la conversation | Des agents conçus pour des échanges bilatéraux avec les utilisateurs, quel que soit l'initiateur de la conversation. |
| Facturation par session : Si les critères de session sont remplis, tous les messages enrichis et multimédias enrichis diffusés dans la fenêtre de session de 24 heures sont facturés à un tarif forfaitaire, quelle que soit leur durée ou leur segmentation. Facturation par message : Si les critères de session ne sont pas remplis ou si un message tombe en dehors de la fenêtre de session de 24 heures, le message est facturé individuellement à un tarif par message pour les contenus enrichis ou les contenus multimédias enrichis, conformément à la grille tarifaire de l'opérateur concerné. |
Agents conversationnels versus agents non conversationnels
Il existe deux catégories de facturation pour les agents : conversationnelles et non conversationnelles.
Les agents non conversationnels sont facturés pour chaque message qu'ils transmettent à 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 facturés à un tarif forfaitaire par session, dès lors qu'une session est déclenchée. Ce tarif inclut tous les messages échangés dans un délai de 24 heures, y compris ceux ayant déclenché la session. Les agents conversationnels peuvent toutefois facturer les messages hors session.
- Cette catégorie est idéale pour les agents qui mènent des conversations à plusieurs tours avec les utilisateurs.
Logique de facturation de session
Selon le modèle de facturation américain, une session est déclenchée par une séquence de 4 messages enrichis ou multimédias (dont au moins 2 messages MO et au moins 1 message MT) échangés dans un délai de 24 heures à compter du premier message de la séquence déclenchante. Une fois ce seuil atteint, tous les messages échangés pendant ces 24 heures sont facturés comme une seule et même session . Tout message n'entrant pas dans cette séquence ou ne déclenchant pas de session est facturé au tarif standard par message enrichi ou multimédia, conformément à la grille tarifaire de l'opérateur concerné.
Le diagramme suivant illustre 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 catégorisés selon leur origine et leur 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 employée dans la documentation RCS for Business. Voici un bref aperçu de la correspondance entre ces termes :
- A2P (Application-to-Person) est MT (Mobile Terminated) : Un message envoyé par l'entreprise.
- P2A (Personne-à-Application) est MO (Mobile Originated) : Un message ou une 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 spécifiques suggérées (Composer un numéro, Ouvrir une URL dans un navigateur). | Toujours considéré comme un événement facturable individuel. Facturation par message basée sur les segments (1 segment équivaut à 160 octets UTF-8). | Considéré comme un événement facturable individuel, sauf s'il est intégré à une séance. |
p2a_rich_message | Un message envoyé par un utilisateur contenant uniquement du texte libre ou du texte provenant d'une réponse suggérée. | Toujours considéré comme un événement facturable individuel. Facturation par message selon les segments. | Considéré comme un événement facturable individuel, sauf s'il est intégré à une séance. |
a2p_rich_media_message | Un message envoyé par un agent contenant des médias (image, vidéo, audio), des cartes enrichies, des carrousels ou des actions complexes comme « Voir la position ». | Toujours considéré comme un événement facturable individuel. Facturable comme un événement unique à tarif fixe, indépendamment de sa taille ou de son contenu. | Considéré comme un événement facturable individuel, sauf s'il est intégré à une séance. |
p2a_rich_media_message | Un message envoyé par un utilisateur contenant un fichier multimédia téléchargé (image, vidéo, audio). | Toujours considéré comme un événement facturable individuel. Facturable comme un événement unique à tarif forfaitaire. | Considéré comme un événement facturable individuel, sauf s'il est intégré à une séance. |
p2a_suggested_action | L'utilisateur appuie sur toute action suggérée (par exemple, « Afficher la position ») qui n'est pas une réponse suggérée. | Toujours considéré comme un événement facturable individuel. Génère un événement facturable par clic. | Considéré comme un événement facturable individuel, il génère un événement facturable par clic, sauf s'il fait partie d'une session. |
a2p_session | Une fenêtre d'interaction de 24 heures qui débute lorsqu'un déclencheur de session est activé et que le premier message est MT. Pour plus d'informations, consultez la section Qu'est-ce qu'une session et comment ça fonctionne ? | Sans objet. Les sessions ne s'appliquent pas aux agents non conversationnels. | Une fois déclenchée, la session de 24 heures couvre tous les messages reçus. Chaque événement facturable sera associé à l'identifiant d'événement facturable de la session. |
p2a_session | Une fenêtre d'interaction de 24 heures qui débute lorsqu'un déclencheur de session est activé et que le premier message est MO. Pour plus d'informations, consultez la section « Qu'est-ce qu'une session et comment ça fonctionne ? » . | Sans objet. Les sessions ne s'appliquent pas aux agents non conversationnels. | Une fois déclenchée, la session de 24 heures couvre tous les messages reçus. Chaque événement facturable sera associé à l'identifiant d'événement facturable de la session. |
Génération de rapports de facturation
Seuls les agents dont le trafic n'est pas celui des testeurs génèrent des événements facturables. L'activité provenant des numéros de téléphone de test n'apparaît pas dans les rapports de facturation.
Ces rapports partent du principe que les événements sont facturables lors de la livraison des messages A2P, et non lors de leur envoi. Un message non livré ou annulé avant sa livraison ne donne pas lieu à une facturation.
Format du rapport de facturation
Les rapports de 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 correspond à un enregistrement représentant un é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 la 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 | Identifiant généré permettant de distinguer l'événement facturable. Tous les messages faisant 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 ayant participé à l'événement. | acme_342h23_agent@rbm.goog |
agent_owner | chaîne | Adresse e-mail du propriétaire actuel du compte partenaire sur lequel l'agent a été créé. | marketing@xyzaggregator.com |
billing_party | chaîne | Partie qui facture les événements. | transporteur |
max_duration_single_message | nombre | Durée maximale (en heures) accordée à un utilisateur pour répondre à un message d'agent avant la fermeture de la fenêtre de conversation et la classification du message comme un événement single_message . Non applicable au modèle américain pour les messages enrichis individuels. | 24 |
max_duration_a2p_conversation | nombre | Pour le projet pilote de 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 projet pilote de 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 | AAAA-mm-jjTHH:00:00Z | Date et 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 du moment où le message est remis à l'utilisateur.a2p_session , il s'agit du moment où le premier message de la conversation est remis à l'utilisateur.P2A p2a_rich_message et p2a_rich_media_message , il s'agit du moment où le message est envoyé par l'utilisateur.p2a_session , il s'agit du moment où le premier message de la conversation est envoyé par l'utilisateur. | 2025-05-20T08:00:00Z |
duration | nombre | La durée concerne uniquement les sessions et est mesurée en minutes. Lorsqu'il ne s'agit pas d'un événement lié à une session, la valeur est de 0. | 45 |
mt_messages | nombre | Nombre de messages A2P (messages envoyés depuis un mobile) dans l'événement. Pour les sessions, chaque ligne partageant le même billing_event_id affiche le nombre total de messages A2P dans la session entière. | 5 |
mo_messages | nombre | Nombre de messages d'origine mobile (P2A) dans l'événement. Pour les sessions, chaque ligne partageant le même billing_event_id affiche le nombre total de messages MO dans la session entière. | 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 à 1024 octets). | 912 |
agent_name | chaîne | Nom de l'agent ayant participé à l'événement. | ACME Brand |
owner_name | chaîne | Nom du propriétaire actuel du compte partenaire sur lequel l'agent a été créé. | XYZ Aggregator |
segment_count | nombre | Le nombre de segments calculé pour a2p_rich_message events et p2a_rich_message (1 segment équivaut à 160 octets UTF-8). Si l'événement n'appartient à aucune de ces catégories, la valeur est 0. | 5 |
session_type | chaîne | Type de session :a2p_sessionp2a_session | a2p_session |
Exemple de rapport de facturation
Un exemple de rapport est disponible en téléchargement :
Taille typique des fichiers
La taille d'un rapport quotidien provenant d'un partenaire RCS for Business actif dépend de l'activité qu'il a générée sur le réseau de l'opérateur.