En esta página, se describen los archivos de datos que crea RCS para empresas para ayudar a los operadores de EE.UU. con la facturación y la auditoría en virtud del Marco de RBM de EE.UU. Para obtener más información sobre el marco de trabajo de RBM de EE.UU., también puedes consultar usrbm.org.
El informe de facturación es un informe agregado de los eventos facturables entre los agentes lanzados y los usuarios. Facturable simplemente significa que un evento es apto para un cargo. Los operadores determinan si se cobran los eventos facturables y cómo se cobran. Todos los operadores de EE.UU. que operan activamente RCS para empresas tienen acceso a los informes de facturación.
Para obtener detalles sobre el modelo de clasificación de facturación de EE.UU., consulta las Preguntas frecuentes sobre la facturación de EE.UU..
Generación de archivos
Para obtener más información, consulta Generación de archivos.
Almacenamiento y acceso a archivos
Para obtener más información, consulta Almacenamiento y acceso a archivos.
Disponibilidad de archivos
Para obtener más información, consulta Disponibilidad de archivos.
Informes de facturación
Los informes de facturación son registros de los eventos facturables, que se calculan en función de la categoría de facturación del agente y el tipo de mensajes que envía. Los informes de facturación están disponibles para todos los operadores que utilizan activamente RCS para empresas.
Los informes de facturación contienen información confidencial, pero no información de identificación personal (PII) del usuario, como el MSISDN, el MSISDN con hash o cualquier identificador único del usuario.
Comparación entre las categorías de facturación y los eventos facturables
La distinción entre las categorías de facturación y los eventos facturables del agente es clave para comprender cómo se factura tu agente.
- La categoría de facturación es una clasificación fija que eliges cuando creas tu agente. Determina el método por el cual se factura tu agente: por mensaje (agentes no conversacionales) o por sesión (agentes conversacionales).
- Los eventos facturables son interacciones entre un agente de RCS para empresas y un usuario que se registran para fines de facturación (por ejemplo,
rich_message).
Categorías de facturación de agentes en EE.UU.
Cuando se crea un agente, el propietario establece su categoría de facturación según cómo interactuará el agente con los usuarios. La categoría de facturación no restringe la cantidad ni el tipo de mensajes que puede enviar un agente. Sin embargo, sí determina cómo se facturará el agente por los mensajes. En la siguiente tabla, se describen las dos categorías principales de facturación.
| Categoría de facturación | Tipo de agente | Ejemplos de casos de uso | Método de facturación |
|---|---|---|---|
| No conversacional | Agentes que principalmente envían mensajes unidireccionales |
|
Se factura por cada mensaje que se entrega al usuario. |
| Conversacional | Agentes diseñados para intercambios de ida y vuelta con los usuarios, independientemente de quién inicie la conversación. |
|
Facturación por sesión: Si se cumplen los criterios de la sesión, todos los mensajes enriquecidos y rich media dentro de la ventana de sesión de 24 horas se facturan a una tarifa plana, independientemente de la duración o los segmentos. Facturación por mensaje: Si no se cumplen los criterios de la sesión o un mensaje queda fuera de la ventana de sesión de 24 horas, el mensaje se factura de forma individual a una tarifa por mensaje para el contenido enriquecido o rich media según la hoja de tarifas de cada operador. |
Agentes conversacionales frente a no conversacionales
Existen dos categorías de facturación de agentes: conversacional y no conversacional.
Los agentes no conversacionales se facturan por cada mensaje que entregan al usuario.
- Esta categoría es ideal para los agentes que no esperan respuestas frecuentes.
Los agentes conversacionales se facturan a una tarifa plana por sesión o sesiones, siempre que se active una sesión. Luego, se incluirán todos los mensajes intercambiados en un período de 24 horas, incluidos los mensajes que activaron la sesión. Los agentes conversacionales aún pueden generar cargos por los mensajes que no forman parte de una sesión de 24 horas.
- Esta categoría es ideal para los agentes que participan en conversaciones de varios turnos con los usuarios.
Lógica de facturación de la sesión
Según el modelo de facturación de EE.UU., una sesión se activa con una secuencia de 4 mensajes enriquecidos o de medios enriquecidos (incluidos al menos 2 mensajes MO y al menos 1 mensaje MT) que se intercambian en un período de 24 horas a partir del primer mensaje de la secuencia de activación. Una vez que se alcanza este umbral, todos los mensajes dentro de ese período de 24 horas se facturan como una sola sesión. Los mensajes que no se incluyen en una sesión o que no la activan se facturan a la tarifa por mensaje estándar para rich media o rich media según la hoja de tarifas de cada operador.
En el siguiente diagrama, se muestra un ejemplo de una sesión de facturación de A2P para agentes conversacionales.
- MT (Mobile Terminated) es un mensaje que envía la empresa.
- MO (Mobile Originated) es un mensaje o una acción que inicia el usuario.
Eventos facturables
Los flujos de mensajería se categorizan según su origen y dirección. Para describir la dirección del tráfico de mensajes, las operadoras de EE.UU. suelen usar la terminología MT/MO. Estos términos corresponden a la terminología A2P/P2A que se usa en toda la documentación de RCS para empresas. A continuación, se incluye un breve desglose de cómo se alinean estos términos:
- A2P (de aplicación a persona) es MT (terminado en el móvil): Es un mensaje enviado por la empresa.
- P2A (de persona a aplicación) es MO (originado en el dispositivo móvil): Es un mensaje o una acción que inicia el usuario.
| Evento | Descripción | Agentes no conversacionales | Agentes conversacionales |
|---|---|---|---|
a2p_rich_message |
Es un mensaje enviado por el agente que solo contiene texto, respuestas sugeridas o acciones sugeridas específicas (marcar un número, abrir una URL en el navegador). | Siempre se trata como un evento facturable individual. Se factura por mensaje según los segmentos (1 segmento equivale a 160 bytes UTF-8). |
Se trata como un evento facturable individual, a menos que forme parte de una sesión. |
p2a_rich_message |
Es un mensaje que envía el usuario y que solo contiene texto de formato libre o texto que se obtiene al presionar una respuesta sugerida. | Siempre se trata como un evento facturable individual. Se factura por mensaje según los segmentos. |
Se trata como un evento facturable individual, a menos que forme parte de una sesión. |
a2p_rich_media_message |
Es un mensaje enviado por un agente que contiene contenido multimedia (imagen, video, audio), tarjetas enriquecidas, carruseles o acciones complejas, como "Ver ubicación". | Siempre se trata como un evento facturable individual. Se factura como un solo evento de tarifa plana, independientemente del tamaño o el contenido. |
Se trata como un evento facturable individual, a menos que forme parte de una sesión. |
p2a_rich_media_message |
Mensaje enviado por el usuario que contiene un archivo multimedia subido (imagen, video o audio). | Siempre se trata como un evento facturable individual. Se factura como un evento único de tarifa plana. |
Se trata como un evento facturable individual, a menos que forme parte de una sesión. |
p2a_suggested_action |
Un usuario presiona cualquier acción sugerida (p.ej., "Ver ubicación") que no sea una respuesta sugerida. | Siempre se trata como un evento facturable individual. Se genera un evento facturable por clic. |
Se considera un evento facturable individual y genera un evento facturable por clic, a menos que forme parte de una sesión. |
a2p_session |
Ventana de interacción de 24 horas que comienza cuando se inicia un activador de sesión y el primer mensaje es de MT. Para obtener más información, consulta Qué es una sesión y cómo funciona. | N/A. Las sesiones no se aplican a los agentes no conversacionales. | Una vez que se activa, todos los mensajes dentro del período de 24 horas están cubiertos por una sola tarifa de sesión. A cualquier evento facturable de la sesión de 24 horas se le asignará el ID de evento facturable de la sesión. |
p2a_session |
Es un período de interacción de 24 horas que comienza cuando se inicia un activador de sesión y el primer mensaje es MO. Para obtener más información, consulta ¿Qué es una sesión y cómo funciona? | N/A. Las sesiones no se aplican a los agentes no conversacionales. | Una vez que se activa, todos los mensajes dentro del período de 24 horas están cubiertos por una sola tarifa de sesión. A cualquier evento facturable de la sesión de 24 horas se le asignará el ID de evento facturable de la sesión. |
Generación de informes de facturación
Solo los agentes con tráfico que no es de prueba generan eventos facturables. La actividad de los números de teléfono de prueba no aparece en los informes de facturación.
Estos informes suponen que los eventos son facturables cuando se entregan los mensajes A2P, no cuando se envían. Un mensaje no entregado o un mensaje cancelado antes de la entrega no activan un evento facturable.
Formato del informe de facturación
Los informes de facturación usan el formato de nombre de archivo rbm_billable_events_YYYY-MM-DD.csv.
La fecha que aparece en el nombre del archivo es la fecha de generación del archivo.
Cada línea del informe es un registro que representa un solo evento facturable.
Las sesiones de A2P/P2A se representan con varias filas, una para cada mensaje intercambiado. Cada fila asociada a una sesión (que comparte el mismo billing_event_id) informará la cantidad total de mensajes MT y MO para el período de 24 horas de la sesión en las columnas mt_messages y mo_messages.
Los archivos están codificados en UTF-8 sin una marca de orden de bytes y usan avances de línea para los finales de línea. La primera línea de cada archivo es una fila de encabezado con los nombres de los campos.
Cada registro del informe contiene la siguiente información para cada evento facturable.
| Campo | Formato | Descripción | Ejemplo |
|---|---|---|---|
billing_event_id |
string | Es el ID generado que distingue el evento facturable. Todos los mensajes que forman parte de una sesión tendrán el mismo |
63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e |
type |
string | Tipo de evento:a2p_rich_messagea2p_rich_media_messagep2a_rich_messagep2a_rich_media_messagep2a_suggested_action |
p2a_rich_message |
agent_id |
string | Es el identificador único del agente que participó en el evento. | acme_342h23_agent@rbm.goog |
agent_owner |
string | Dirección de correo electrónico del propietario actual de la cuenta de socio en la que se creó el agente. | marketing@xyzaggregator.com |
billing_party |
string | Es la parte que factura los eventos. | proveedor |
max_duration_single_message |
número | Es el tiempo máximo (en horas) que se le permite a un usuario responder a un mensaje del agente antes de que se cierre la ventana de inicio de la conversación y el mensaje se clasifique como un evento single_message. No corresponde al modelo de EE.UU. para mensajes enriquecidos individuales. |
24 |
max_duration_a2p_conversation |
número | En el piloto de sesiones, esto refleja el período de sesión de 24 horas medido a partir del primer mensaje de la secuencia de activadores. La duración se mide en horas. | 24 |
max_duration_p2a_conversation |
número | En el piloto de sesiones, esto refleja el período de sesión de 24 horas medido a partir del primer mensaje de la secuencia de activadores. | 24 |
start_time |
YYYY-mm-ddTHH:00:00Z | Fecha y hora en UTC en que comenzó el evento (ISO 8601). En el caso de las sesiones, es la marca de tiempo del primer mensaje de la secuencia de activación. A2P a2p_rich_message y a2p_rich_media_message, esta es la fecha y hora en que se entrega el mensaje al usuario.a2p_session, es el momento en que se entrega el primer mensaje de la conversación al usuario.P2A p2a_rich_message y p2a_rich_media_message, esta es la fecha y hora en que el usuario envía el mensaje.p2a_session, es el momento en que el usuario envía el primer mensaje de la conversación. |
2025-05-20T08:00:00Z |
duration |
número | La duración solo se aplica a las sesiones y se mide en minutos. Cuando el evento no es de sesión, el valor es 0. | 45 |
mt_messages |
número | Cantidad de mensajes terminados en dispositivos móviles (A2P) en el evento. En el caso de las sesiones, cada fila que comparte el mismo billing_event_id muestra la cantidad total de mensajes de MT en toda la sesión. |
5 |
mo_messages |
número | Cantidad de mensajes originados en dispositivos móviles (P2A) en el evento. En el caso de las sesiones, cada fila que comparte el mismo billing_event_id muestra la cantidad total de mensajes MO en toda la sesión. |
3 |
size_kilobytes |
número | Tamaño de todos los archivos adjuntos a los mensajes del evento, redondeado al kilobyte más cercano (1 KB equivale a 1,024 bytes). | 912 |
agent_name |
string | Es el nombre del agente que participó en el evento. | ACME Brand |
owner_name |
string | Nombre del propietario actual de la cuenta de socio en la que se creó el agente. | XYZ Aggregator |
segment_count |
número | Es el recuento de segmentos calculado para los eventos a2p_rich_message events y p2a_rich_message (1 segmento equivale a 160 bytes UTF-8). Cuando el evento no es uno de los mencionados, el valor es 0. |
5 |
session_type |
string | Tipo de sesión:a2p_sessionp2a_session |
a2p_session |
Ejemplo de informe de facturación
El informe de muestra está disponible para descargar:
Tamaño de archivo habitual
El tamaño de un informe diario de un socio activo de RCS para Empresas depende de la cantidad de actividad que haya generado en la red del operador.