Modelo de faturamento dos EUA

Este documento descreve o modelo de faturamento para tráfego RCS for Business em operadoras dos EUA.

Visão geral das classificações de faturamento nos EUA

Todas as mensagens enviadas ou recebidas de um número de telefone dos EUA são automaticamente classificadas em um dos seguintes tipos, com base em seu formato:

  • Mensagem Rica (bidirecional)
  • Mensagem multimídia (bidirecional)

Vários tipos de mensagens podem ser combinados em uma sessão . Para obter mais informações sobre sessões, consulte Cobrança por sessão (Piloto) .

Consulte as seções a seguir para obter especificações detalhadas.

Uma nota sobre terminologia

Para descrever a direção do tráfego de mensagens, as operadoras dos EUA geralmente usam a terminologia MT/MO. Esses termos correspondem à terminologia A2P/P2A usada em toda a documentação do RCS para Empresas:

  • MT (Mobile Terminated) é A2P (Application-to-Person) : uma mensagem enviada pela empresa.
  • MO (Mobile Originated) é P2A (Pessoa para Aplicativo) : Uma mensagem ou ação iniciada pelo usuário.

Faturamento de eventos de agente para pessoa (A2P/MT)

Esta seção aborda a lógica de faturamento para mensagens enviadas por um agente (ou seja, mensagens A2P ou MT).

Mensagens Aprimoradas (A2P)

Uma mensagem é classificada como Mensagem Rica se contiver apenas uma combinação dos seguintes elementos:

Lógica de faturamento para mensagens avançadas

Uma mensagem avançada é cobrada com base em segmentos.

  • Tamanho do segmento : 1 segmento = 160 bytes de texto codificado em UTF-8.
  • Cálculo : O comprimento total em bytes UTF-8 do texto da mensagem é dividido por 160 e sempre arredondado para o número inteiro mais próximo.
  • Exclusões : O texto e os dados de resposta contidos nas sugestões de respostas ou ações não estão incluídos na contagem de segmentos.
  • Exemplo : Uma mensagem de texto de 300 bytes possui 2 segmentos (300 / 160 = 1,875, arredondado para 2).

Contagem de bytes

Alguns caracteres Unicode (como emojis ou letras acentuadas) são multibyte, portanto, a contagem total de bytes UTF pode ser diferente da contagem de caracteres.

Para verificar a contagem exata de bytes de uma mensagem, digite ou cole-a abaixo.

Mensagens de Mídia Rica (A2P)

Uma mensagem é classificada como uma Mensagem de Mídia Rica se contiver pelo menos um dos seguintes elementos:

Lógica de faturamento para mensagens de mídia avançada

Uma mensagem Rich Media é cobrada como um evento único com preço fixo.

  • A cobrança é a mesma, independentemente do tamanho do texto, do número de cartões ou do tamanho do arquivo de mídia.
  • A segmentação não se aplica.

Exemplos de resposta da API A2P

Estes exemplos mostram o campo richMessageClassification em uma resposta de chamada de API RBM bem-sucedida para mensagens enviadas pelo agente.

Exemplo de resposta da API para uma RICH_MESSAGE 

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

Exemplo de resposta da API para uma RICH_MEDIA_MESSAGE 

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

Faturamento de eventos de pessoa para agente (P2A/MO)

Esta seção aborda a cobrança de mensagens e ações iniciadas por um usuário (ou seja, mensagens P2A ou MO).

Mensagens Ricas (P2A)

Uma mensagem de usuário é classificada como Mensagem Rica se contiver apenas texto. Isso inclui tanto texto livre quanto o texto resultante de um clique em uma resposta sugerida . (As respostas sugeridas podem incluir um identificador de dados de postback no conteúdo da mensagem.)

Lógica de faturamento : Faturamento baseado em segmentos. Para detalhes sobre os cálculos de contagem de segmentos, consulte Lógica de faturamento para mensagens avançadas .

Mensagens de Mídia Rica (P2A)

Uma mensagem é classificada como Mensagem de Mídia Rica se contiver um arquivo carregado (imagem, vídeo, áudio).

Lógica de faturamento : Cobrado como um único evento com taxa fixa. A segmentação não se aplica.

Cliques de ação sugeridos

Quando um usuário toca em qualquer ação sugerida, isso gera um evento faturável chamado Clique em Ação Sugerida. (As ações sugeridas podem incluir um identificador de dados de postback no conteúdo da mensagem.)

Lógica de faturamento : Gera um evento faturável por clique.

Caso especial: Compartilhar localização

A localização de compartilhamento é única, pois gera dois eventos faturáveis ​​P2A separados:

Exemplos de resposta de webhook P2A

Estes exemplos mostram o campo richMessageClassification em webhooks enviados ao agente para eventos iniciados pelo usuário.

Exemplo de webhook para uma RICH_MESSAGE enviada pelo usuário. 

{
  "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
  }
}

Exemplo de webhook para uma RICH_MEDIA_MESSAGE enviada pelo usuário. 

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

Exemplo de webhook para um clique em uma SUGGESTED_ACTION_CLICK 

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

Exemplo de webhook para uma mensagem de localização

Este é o segundo evento faturável no fluxo de compartilhamento de localização , enviado depois que o usuário compartilha sua localização no mapa.

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

Cobrança por sessão (Piloto)

Embora o modelo de faturamento atual nos EUA cobre por mensagens individuais, o projeto piloto de faturamento por sessão introduz uma maneira de agrupar conversas inteiras de usuário para marca e/ou de marca para usuário em um único evento faturável: p2a_session ou a2p_session .

Um evento faturável de sessão é registrado e cobrado quando limites específicos de interação são atingidos dentro de um período contínuo de 24 horas. Para mais informações, consulte O que é uma sessão e como ela funciona .

Notas técnicas e de implementação

  • Os segmentos servem apenas para fins de faturamento : mensagens longas são entregues como uma única unidade ao dispositivo do usuário. A contagem de segmentos é um cálculo virtual para fins de faturamento; ela não afeta a forma como as mensagens são entregues ou apresentadas ao usuário.
  • Classificação automática : A classificação das mensagens é totalmente automática, baseada no conteúdo da mensagem, e não pode ser alterada manualmente.
  • Implementação : O modelo de faturamento dos EUA foi ativado em toda a plataforma RCS for Business em 15 de julho de 2025. A partir dessa data, os relatórios e as respostas da API do Google refletem as novas classificações.