En esta página, se describen los archivos de datos que crea RCS para empresas para ayudar a los operadores con la facturación y la auditoría.
| Archivo | Descripción | Quién tiene acceso |
|---|---|---|
| Informe de facturación | Es un informe agregado de los eventos facturables entre los agentes lanzados y los usuarios. | Todos los operadores que operan activamente RCS para empresas |
| Registro de actividad | Registro de datos sin procesar de la actividad de RCS para empresas, incluidos los eventos facturables. | Operadores que operan activamente RCS para empresas y el Servicio de RCS de Google según sus propias Condiciones del Servicio (CdS). |
RCS para empresas usa dos modelos de facturación: el modelo de facturación estándar para el tráfico que no es de EE.UU. y el modelo de facturación de EE.UU. para el tráfico de EE.UU. La información exclusiva del modelo estándar o del modelo de EE.UU. (por ejemplo, diferentes clasificaciones de eventos facturables o campos de informes) se indica de forma explícita.
- Para obtener detalles sobre el modelo de facturación estándar y un resumen de las diferencias entre los modelos de facturación, consulta las Preguntas frecuentes sobre la facturación.
- Para obtener detalles sobre las clasificaciones de facturación de EE.UU., consulta la guía del modelo de facturación de EE.UU..
Generación de archivos
Cada archivo de datos representa un día de uso de RCS para Empresas en la hora universal coordinada (UTC). Los archivos se generan a diario. El proceso de generación puede tardar varias horas, y el tiempo de finalización puede variar.
En el caso de los agentes no conversacionales, los archivos contienen datos del período de 24 horas que precedió inmediatamente a la hora de generación del archivo. Por ejemplo, si se genera un informe de facturación a las 11:00 UTC del 5 de mayo, contendrá datos desde las 11:00 UTC del 4 de mayo hasta las 11:00 UTC del 5 de mayo.
En el caso de los agentes conversacionales, los archivos contienen datos del período de 24 horas que se extiende de 1 a 2 días antes de la hora de generación del archivo. Por ejemplo, si se genera un informe de facturación a las 11:00 (UTC) del 5 de mayo, es posible que contenga datos desde las 11:00 (UTC) del 3 de mayo hasta las 11:00 (UTC) del 4 de mayo.
El motivo de la demora es que la actividad de RCS para empresas de los agentes conversacionales está vinculada a las conversaciones, que pueden tardar hasta 48 horas en completarse. Esta demora permite que RCS for Business capture todos los mensajes de una conversación antes de calcular el evento facturable. Para obtener más información sobre los agentes conversacionales, consulta Categorías de facturación de agentes.
Puntos clave:
Sin actividad: Si no hay actividad en la plataforma en un día determinado, no se genera ningún archivo.
Nombres: La fecha que aparece en el nombre del archivo es la fecha de generación del archivo, no la fecha de los datos que contiene.
Retención: Los archivos se almacenan durante un máximo de 63 días antes de que se borren.
Puedes usar estos archivos para actualizar tu almacén de datos con las métricas de uso de la plataforma más recientes.
Almacenamiento y acceso a archivos
Los archivos de datos se encriptan en reposo y durante la transferencia.
Para recuperar archivos de datos a través del protocolo de transferencia de archivos segura (SFTP), proporciona tu clave pública de SFTP. Para generar claves, consulta Cómo generar un par de claves Secure Shell (SSH) para un buzón de SFTP.
El servidor SFTP es partnerupload.google.com, y la conexión se realiza en un número de puerto alto (19321) para mayor seguridad.
Puedes usar el siguiente comando para acceder a tus archivos de datos:
sftp -i <path_to_private_key> -P 19321 <username>@partnerupload.google.com
Google proporciona nombres de usuario de cuentas en los siguientes formatos:
rbmreports-billableevents-<carrier name>rbmreports-activity-<carrier name>
Google especifica <carrier name> y proporciona una cuenta separada para cada tipo de informe.
Se proporcionan cuentas separadas para acceder a los diferentes tipos de informes.
Disponibilidad de archivos
Si aún no se generaron archivos de datos, verás un error de SFTP similar a remote readdir("/"): No such file or directory, lo que es normal.
No se generará un archivo si no hay tráfico de RCS para empresas que se pueda informar. Esto significa que es posible que no se generen archivos algunos días. Si necesitas archivos vacíos para optimizar tu proceso, comunícate con rbm-support@google.com.
Informes de facturación
Los informes de facturación son registros de los eventos facturables, que se calculan según 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 ejecutan 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.
Categorías de facturación de agentes
Cuando se crea un agente, el propietario establece su categoría de facturación según la forma en que el agente interactuará 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án los mensajes al agente. 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 | Son agentes que principalmente envían mensajes unidireccionales. |
|
Se factura por cada mensaje que se entrega al usuario. |
| Conversacional | Agentes diseñados para intercambios con los usuarios. |
|
Se factura por conversación: Si una de las partes (el agente o el usuario) responde un mensaje de la otra parte en un plazo de 24 horas, se inicia una conversación. Durante la ventana de conversación (24 horas después de la primera respuesta), el agente y el usuario pueden intercambiar la cantidad de mensajes que deseen, y al agente se le facturará una tarifa fija por la conversación. Se factura por mensaje: Si el agente entrega un mensaje al que el usuario no responde en un plazo de 24 horas, se le facturará al agente por el mensaje individual, de manera similar a un agente no conversacional. |
En el siguiente diagrama, se muestra un ejemplo de una sesión de facturación de A2P para agentes conversacionales:
Agentes conversacionales y no conversacionales
Existen dos categorías principales de facturación: conversacional y no conversacional.
La diferencia clave en las categorías de facturación se encuentra entre los agentes conversacionales y los no conversacionales:
A los agentes no conversacionales se les factura cada mensaje que entregan al usuario.
- Esta categoría es ideal para los agentes que no esperan respuestas frecuentes.
A los agentes conversacionales se les factura una tarifa plana por conversaciones, que incluyen todos los mensajes intercambiados en un período de 24 horas.
- Esta categoría es la mejor para los agentes que participan en conversaciones de varios turnos con los usuarios.
Eventos facturables
En los informes de facturación, se registran cinco tipos de eventos facturables. Estos eventos incluyen eventos MT y MO, que se conocen como eventos A2P y P2A.
- A2P (de aplicación a persona) es MT (terminado en el dispositivo móvil): Es un mensaje que envía la empresa.
- P2A (de persona a aplicación) es MO (originado en el dispositivo móvil): Es un mensaje o una acción iniciados por el usuario.
En la siguiente tabla, se describe cada evento facturable según se aplica a los agentes conversacionales y no conversacionales.
| Evento | Descripción | Agentes no conversacionales | Agentes conversacionales |
|---|---|---|---|
basic_message
|
Mensaje de A2P que incluye solo texto con hasta 160 caracteres. Si el texto incluye una URL de un sitio web con etiquetas openGraph, es posible que el mensaje muestre una vista previa de la imagen sin cargo adicional para el socio. | Siempre se trata como un evento facturable individual, independientemente de si el usuario responde. | Se trata como un evento facturable individual, a menos que el usuario responda en un plazo de 24 horas. En ese caso, el mensaje pasa a formar parte de un a2p_conversation.
|
single_message
|
Mensaje de A2P que tiene contenido enriquecido o es un mensaje solo de texto de más de 160 caracteres. | Siempre se trata como un evento facturable individual, independientemente de si el usuario responde. | Se trata como un evento facturable individual, a menos que el usuario responda en un plazo de 24 horas. En ese caso, el mensaje pasa a formar parte de un a2p_conversation.
|
a2p_conversation (iniciada por la empresa)
|
Se inicia cuando un usuario responde un mensaje A2P dentro de las 24 horas posteriores a su recepción, fuera de una conversación existente. | N/A. Los agentes no conversacionales nunca generan este tipo de evento. | Si se entrega un mensaje P2A dentro de las 24 horas posteriores a varios mensajes A2P, solo se usará el mensaje A2P que precedió inmediatamente al mensaje P2A para iniciar la conversación. Este mensaje A2P y todos los mensajes que se entreguen en las próximas 24 horas forman parte del a2p_conversation.
|
p2a_conversation (iniciado por el usuario)
|
Se inicia cuando un agente responde un mensaje de P2A en un plazo de 24 horas después de recibirlo, fuera de una conversación existente. | N/A. Los agentes no conversacionales nunca generan este tipo de evento. | Si se entrega un mensaje A2P dentro de las 24 horas posteriores a varios mensajes P2A, solo se usará el mensaje P2A que precedió inmediatamente al mensaje A2P para iniciar la conversación. Este mensaje de P2A y todos los mensajes que se entreguen en las próximas 24 horas forman parte del p2a_conversation.
|
p2a_message
|
Mensaje P2A de cualquier tipo. | Siempre se trata como un evento facturable individual, independientemente de si el agente responde. | Se considera un evento facturable individual, a menos que el agente responda en un plazo de 24 horas. |
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 que se factura tu agente: por mensaje (agentes no conversacionales) o por conversación (agentes conversacionales).
- Los eventos facturables son interacciones entre un agente de RCS for Business y un usuario que se registran para fines de facturación (por ejemplo,
basic_message,single_message,a2p_conversation).
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 se facturan cuando se entregan los mensajes, 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. Los campos dentro de un registro están separados por tabulaciones. Por ejemplo, dos conversaciones de A2P con el mismo agente generarían dos eventos facturables independientes y dos registros en el informe de facturación.
Cada registro del informe contiene la siguiente información para cada evento facturable.
| Campo | Formato | Descripción | Ejemplo |
|---|---|---|---|
billing_event_id
|
string | Es el identificador UUID. Es un número aleatorio que se genera para cada evento nuevo en el momento en que se crea. | 242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff
|
type
|
string | Tipo de evento:
Modelo de facturación estándar Modelo de facturación de EE.UU. |
single_message
|
agent_id
|
string | Es el identificador único del agente que participó en el evento. | rbm-welcome-bot@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. | name@aggregator.com
|
billing_party
|
string | Es la parte que factura los eventos.
|
carrier
|
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.
|
24
|
max_duration_a2p_conversation
|
número | Es la duración máxima de una conversación de A2P, en horas. Se mide desde la primera respuesta del usuario al mensaje inicial del agente. | 24
|
max_duration_p2a_conversation
|
número | Es la duración máxima de una conversación de P2A, en horas. Se mide desde el primer mensaje del usuario en la conversación. | 24
|
start_time
|
YYYY-mm-ddTHH:00:00Z | Fecha y hora en UTC en que comenzó el evento, en formato ISO 8601, redondeadas a la hora más cercana.
Mensajes de A2P
Mensajes P2A
|
2019-07-25T08:00:00Z
|
duration
|
número | Duración del evento, redondeada al minuto más cercano.
Cuando el tipo de evento es |
45
|
mt_messages
|
número | Cantidad de mensajes terminados en dispositivos móviles (A2P) en el evento. | 11
|
mo_messages
|
número | Cantidad de mensajes originados en dispositivos móviles (P2A) en el evento. | 9
|
size_kilobytes
|
número | Tamaño de todos los archivos adjuntos a los mensajes del evento, redondeado al kilobyte más cercano (1 kB = 1,024 bytes). | 912
|
agent_name
|
string |
Nombre del agente que participó en el evento. |
XYZ Mobile USA
|
owner_name
|
string | Nombre del propietario actual de la cuenta de socio en la que se creó el agente. | XYZ Mobile
|
segment_count
|
número | Solo para el modelo de facturación de EE.UU.
Es el recuento de segmentos calculado para los eventos |
5
|
Ejemplo de informe de eventos de facturación
Puedes descargar informes de muestra:
- Informe de facturación para el modelo de facturación estándar
- Informe de facturación para el modelo de facturación de EE.UU.
Tamaño de archivo habitual
El tamaño de un informe diario de un socio activo de RCS Business depende de la cantidad de actividad que haya generado en la red del operador. Por ejemplo, si hay 53,000 registros en el informe, el archivo tendrá un tamaño aproximado de 8 MB.
Registros de actividad
Los registros de actividad proporcionan datos sin procesar sobre la actividad en la plataforma de RCS para empresas. Puedes usar estos registros para auditar eventos de facturación y crear eventos personalizados.
Nota: En los registros de actividad, solo se incluye el tráfico de números de teléfono que no son de verificadores.
Dado que los registros de actividad contienen información de identificación personal (PII), como información detallada de las transacciones y los MSISDN de los suscriptores, solo están disponibles cuando un operador ejecuta RCS según sus propias Condiciones del Servicio. Si tienes tráfico de RCS para empresas en tus redes y habilitas la actividad de RCS con el servicio RCS de Google según las C.S. de Google, no tendrás acceso a los registros de actividad.
Formato del registro de actividad
Los registros de actividad usan el formato de nombre de archivo rbm_activity_YYYY-MM-DD.csv. La fecha en el nombre del archivo es la fecha de generación del archivo.
Los campos de un registro están separados por tabulaciones, y hay un registro por línea.
Cada registro del registro de actividad contiene los siguientes campos para cada actividad:
| Campo | Formato | Descripción | Ejemplo |
|---|---|---|---|
activity_id
|
string | Es el identificador único de la actividad. | b422e1d3-ac99-442a-853d-a875d5e61762
|
billing_event_id
|
string | Es el identificador único del evento de facturación asociado. Puede estar vacío si la actividad no está asociada con un evento de facturación, como un text_message sin el delivery_receipt_event correspondiente.
|
91yeb201-7c3b-412b-98d2-b0a0f7abe536
|
agent_id
|
string | Es el identificador único del agente. | welcome-bot@rbm.goog
|
user_id
|
string | Es el MSISDN del usuario. | 918369110173
|
direction
|
string | Dirección en la que se envía el mensaje:
|
MT
|
time
|
YYYY-mm-ddTHH:MM:SS.SSSZ | Fecha y hora en que se envió el evento a la plataforma de RCS para empresas en formato UTC. Consulta Marcas de tiempo. | 2019-07-25T00:29:07.033Z
|
type
|
string | Tipo de actividad:
|
text_message
|
size_bytes
|
string | Tamaño de los archivos adjuntos a la actividad, en bytes. | 912
|
Marcas de tiempo
Las marcas de tiempo de los registros de actividad registran cuándo se envió un evento a la plataforma de RCS for Business. En el caso de los eventos que entregan contenido a un usuario, el evento no se registrará en el registro de actividad hasta que se entregue el mensaje.
Por ejemplo, si se envía un mensaje de RCS para Empresas a un usuario el miércoles a las 13:00 y el destinatario está sin conexión hasta el domingo a las 9:00, el evento aparecerá en el registro de actividad generado para el domingo, pero la marca de tiempo será la del miércoles a las 13:00.