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. Consulta las Preguntas frecuentes sobre la facturación para obtener respuestas a preguntas comunes sobre el modelo de facturación de RCS para empresas.
| Archivo | Descripción | Quién tiene acceso |
|---|---|---|
| Informe de eventos 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 for Business. |
| Registro de actividad | Registro de datos sin procesar de la actividad de RCS for Business, 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). |
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 eventos 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 eventos 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. Este retraso permite que RCS Business Messaging capture todos los mensajes de una conversación antes de calcular el evento de facturación. 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 for Business para 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 eventos de facturación
Los informes de eventos de facturación son registros de eventos de facturación, 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 eventos de facturación están disponibles para todos los operadores que operan activamente RCS para empresas.
Los informes de eventos de facturación contienen información confidencial, pero no información de identificación personal (PII) del usuario, como el MSISDN, el MSISDN hasheado 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 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á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 (Incluye las categorías de Mensaje básico y Mensaje único). Nota: Ya no hay diferencias entre estas dos categorías. Se facturará un agente de cualquiera de las categorías como un agente 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 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 categoría no conversacional incluye las categorías Mensaje básico y Mensaje único, que son funcionalmente idénticas. Un agente de cualquiera de estas categorías se factura como agente 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 de facturación
En los informes de eventos de facturación, se registran cinco tipos diferentes de eventos de facturación. Estos eventos incluyen mensajes A2P y P2A.
- A2P (de aplicación a persona): Los envía la empresa.
- P2A (de persona a aplicación): Lo envía el usuario.
En la siguiente tabla, se describe cada evento de facturación tal como 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 de facturación individual, independientemente de si el usuario responde. | Se trata como un evento de facturación 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 de facturación individual, independientemente de si el usuario responde. | Se trata como un evento de facturación 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 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 de P2A dentro de las 24 horas posteriores a varios mensajes de A2P, solo se usará el mensaje de A2P que precedió inmediatamente al mensaje de 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 de facturación individual, independientemente de si el agente responde. | Se trata como un evento de facturación individual, a menos que el agente responda en un plazo de 24 horas. |
Eventos de facturación en comparación con las categorías de facturación
Los eventos de facturación basic_message y single_message no se deben confundir con las categorías de facturación de Mensaje básico y Mensaje único.
Cualquier agente (sin importar su categoría de facturación) puede generar eventos de facturación de
basic_messageysingle_message.Las categorías de facturación de Mensaje básico y Mensaje único se usan para clasificar los agentes no conversacionales. Los agentes de estas categorías de facturación no generan eventos de facturación conversacionales (
a2p_conversationsop2a_conversations), sino que generan eventos de facturación individualesbasic_message,single_messageyp2a_message.
Generación de informes de facturación
Solo los agentes con tráfico que no es de prueba generan eventos de facturación. La actividad de los números de teléfono de prueba no aparece en los informes de eventos 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 de facturación.
Formato del informe de facturación
Los informes de eventos de facturación usan el formato de nombre de archivo rbm_billable_events_YYYY-MM-DD.csv. La fecha 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 de facturación. 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 de facturación y dos registros en el informe de eventos de facturación.
Cada registro del informe contiene la siguiente información para cada evento de facturación:
| Campo | Formato | Descripción | Ejemplo |
|---|---|---|---|
billing_event_id
|
string | Es un 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:
|
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 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 y 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
|
Ejemplo de informe de eventos de facturación
Hay un archivo de informe de facturación de muestra disponible para descargar.
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 tamaño del archivo será de aproximadamente 8 MB.
Registros de actividad
Los registros de actividad proporcionan datos sin procesar sobre la actividad en la plataforma de RCS for Business. 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 a 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á el miércoles a las 13:00.