Modelo de facturación de EE.UU.

En este documento, se describe el modelo de facturación para el tráfico de RCS para empresas en operadores de EE.UU.

Descripción general de las clasificaciones de facturación de EE.UU.

Todos los mensajes que se envían a un número de teléfono de EE.UU. o que se reciben de él se clasifican automáticamente en uno de los tres tipos siguientes según su formato:

  • Mensaje enriquecido (bidireccional)
  • Mensaje de Rich Media (bidireccional)
  • Clic en la acción sugerida (iniciada por el usuario)

Consulta las siguientes secciones para obtener especificaciones detalladas.

Nota sobre la terminología

Para describir la dirección del tráfico de mensajería, las operadoras de EE.UU. suelen usar la terminología MT/MO. Estos términos corresponden a la terminología de A2P/P2A que se usa en toda la documentación de RCS para empresas:

  • MT (Mobile Terminated) es A2P (Application-to-Person): Es un mensaje que envía la empresa.
  • MO (Mobile Originated) es P2A (Person-to-Application): Es un mensaje o una acción que inicia el usuario.

Facturación de eventos de agente a persona (A2P/MT)

En esta sección, se explica la lógica de facturación de los mensajes enviados por un agente (es decir, mensajes de A2P o MT).

Mensajes enriquecidos (A2P)

Un mensaje se clasifica como Mensaje enriquecido si solo contiene una combinación de los siguientes elementos:

Lógica de facturación para los mensajes enriquecidos

Los Mensajes enriquecidos se facturan según los segmentos.

  • Tamaño del segmento: 1 segmento = 160 bytes de texto codificado en UTF-8.
  • Cálculo: La longitud total en bytes UTF-8 del texto del mensaje se divide entre 160 y siempre se redondea al número entero más cercano.
  • Exclusiones: El texto y los datos de devolución de llamada de las respuestas o acciones sugeridas no se incluyen en el recuento de segmentos.
  • Ejemplo: Un mensaje de texto de 300 bytes tiene 2 segmentos (300 / 160 = 1.875, redondeado a 2).

Recuento de bytes

Algunos caracteres Unicode (como los emojis o las letras con acento) son multibyte, por lo que el recuento total de bytes UTF puede diferir del recuento de caracteres.

Para verificar el recuento exacto de bytes de un mensaje, escríbelo o pégalo a continuación.

Mensajes de rich media (A2P)

Un mensaje se clasifica como mensaje de medios enriquecidos si contiene al menos uno de los siguientes elementos:

Lógica de facturación para los mensajes enriquecidos

Un mensaje de rich media se factura como un evento único de tarifa plana.

  • La facturación es la misma independientemente de la longitud del texto, la cantidad de tarjetas o el tamaño del archivo multimedia.
  • No se aplica la segmentación.

Ejemplos de respuestas de la API de A2P

En estos ejemplos, se muestra el campo richMessageClassification en una respuesta exitosa de la llamada a la API de RBM para los mensajes enviados por el agente.

Ejemplo de respuesta de la API para un RICH_MESSAGE

{
  "name": "...",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "contentMessage": {
     ...
  },
  "richMessageClassification": {
    "classificationType": "RICH_MESSAGE",
    "segmentCount": 5
  }
}

Ejemplo de respuesta de la API para un RICH_MEDIA_MESSAGE

{
  "name": "...",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "contentMessage": {
     ...
  },
  "richMessageClassification": {
    "classificationType": "RICH_MEDIA_MESSAGE"
  }
}

Facturación de eventos de persona a agente (P2A/MO)

En esta sección, se explica la facturación de los mensajes y las acciones iniciadas por un usuario (es decir, mensajes P2A o MO).

Mensajes enriquecidos (P2A)

Un mensaje del usuario se clasifica como mensaje enriquecido si solo contiene texto. Esto incluye tanto el texto de formato libre como el texto que resulta de presionar una respuesta sugerida. (Las respuestas sugeridas pueden incluir un identificador de datos de devolución de llamada en la carga útil del mensaje).

Lógica de facturación: Se factura según los segmentos. Para obtener detalles sobre los cálculos del recuento de segmentos, consulta Lógica de facturación para mensajes enriquecidos.

Mensajes de Rich Media (P2A)

Un mensaje se clasifica como mensaje de medios enriquecidos si contiene un archivo subido (imagen, video o audio).

Lógica de facturación: Se factura como un solo evento de tarifa plana. No se aplica la segmentación.

Clics en acciones sugeridas

Cuando un usuario presiona cualquier acción sugerida, se genera un evento facturable llamado Clic en la acción sugerida. (Las acciones sugeridas pueden incluir un identificador de datos de devolución de llamada en la carga útil del mensaje).

Lógica de facturación: Genera un evento facturable por clic.

Caso especial: Compartir ubicación

La función de compartir ubicación es única, ya que genera dos eventos facturables de P2A separados:

Ejemplos de respuestas de webhook de P2A

En estos ejemplos, se muestra el campo richMessageClassification en los webhooks que se envían al agente para los eventos iniciados por el usuario.

Ejemplo de webhook para un RICH_MESSAGE enviado por el usuario

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "text": "Hello, world!",
  "richMessageClassification": {
    "classificationType": "RICH_MESSAGE",
    "segmentCount": 1
  }
}

Ejemplo de webhook para un RICH_MEDIA_MESSAGE enviado por el usuario

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "userFile": "...",
  "payload": "...",
  "richMessageClassification": {
    "classificationType": "RICH_MEDIA_MESSAGE"
  }
}

Ejemplo de webhook para un SUGGESTED_ACTION_CLICK

{
    "agentId": "...",
    "senderPhoneNumber": "...",
    "messageId": "...",
    "sendTime": "...",
    "suggestionResponse": {
        "text": "Click here",
        "postbackData": "...",
        "type": "ACTION"
    },
    "richMessageClassification": {
        "classificationType": "SUGGESTED_ACTION_CLICK"
    }
}

Ejemplo de webhook para un mensaje de ubicación

Este es el segundo evento facturable en el flujo de uso compartido de la ubicación, que se envía después de que el usuario comparte su ubicación desde el mapa.

{
    "agentId": "...",
    "senderPhoneNumber": "...",
    "messageId": "...",
    "sendTime": "...",
    "location": {
      "latitude": 37.422000,
      "longitude": -122.084056
    },
    "richMessageClassification": {
        "classificationType": "RICH_MESSAGE",
        "segmentCount": 1
    }
}

Notas técnicas y de implementación

  • Los segmentos solo se utilizan para la facturación: Los mensajes largos se envían como una sola unidad al dispositivo del usuario. El recuento de segmentos es un cálculo virtual para fines de facturación; no afecta la forma en que se entregan o presentan los mensajes al usuario.
  • Clasificación automática: La clasificación de mensajes es completamente automática según el contenido del mensaje y no se puede anular manualmente.
  • Lanzamiento: El modelo de facturación de EE.UU. se habilitó en toda la plataforma de RCS para Empresas el 15 de julio de 2025. A partir de esta fecha, los informes y las respuestas de la API de Google reflejarán las nuevas clasificaciones.