Esta página foi traduzida pela API Cloud Translation.

Modelo de faturamento dos EUA

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

Para informações sobre o modelo de faturamento padrão (para tráfego fora dos EUA), consulte as Perguntas frequentes sobre faturamento.
Para informações sobre relatórios, consulte o guia Relatórios de faturamento e registros de atividades.

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 classificadas automaticamente em um de três tipos com base no formato:

Mensagem avançada (bidirecional)
Mensagem de rich media (bidirecional)
Clique na ação sugerida (iniciada pelo usuário)

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

Observação sobre a terminologia

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

MT (Mobile Terminated) é A2P (Application-to-Person): uma mensagem enviada pela empresa.
MO (Mobile Originated) é P2A (Person-to-Application): 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 avançadas (A2P)

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

Texto
Respostas sugeridas
Ações sugeridas apenas dos seguintes tipos:
- Ligar para um número
- Abrir URL no navegador padrão, não em uma WebView

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 postback nas respostas ou ações sugeridas não são incluídos na contagem de segmentos.
Exemplo: uma mensagem de texto de 300 bytes tem 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 o texto abaixo.

Mensagens de rich media (A2P)

Uma mensagem é classificada como mensagem de rich media se tiver pelo menos um dos seguintes itens:

Um Rich Card ou um carrossel (mesmo sem mídia)
Um anexo de arquivo de mídia (imagem, vídeo, áudio)
Uma ação sugerida diferente de "Discar um número" ou "Abrir URL com navegador", incluindo:

Lógica de faturamento para mensagens rich media

Uma mensagem de rich media é cobrada como um único evento de taxa fixa.

A cobrança é a mesma, independente do tamanho do texto, do número de cards ou do tamanho do arquivo de mídia.
A segmentação não se aplica.

Exemplos de respostas da API A2P

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

Exemplo de resposta da API para um `RICH_MESSAGE`

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

Exemplo de resposta da API para um `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 o faturamento de mensagens e ações iniciadas por um usuário (ou seja, mensagens P2A ou MO).

Mensagens avançadas (P2A)

Uma mensagem do usuário é classificada como mensagem avançada se contiver apenas texto. Isso inclui tanto o texto em formato livre quanto o texto resultante do toque em uma resposta sugerida. (As respostas sugeridas podem incluir um identificador de dados de postback no payload da mensagem.)

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

Mensagens de rich media (P2A)

Uma mensagem é classificada como rich media se tiver um arquivo enviado (imagem, vídeo, áudio).

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

Cliques em ações sugeridas

Um toque do usuário em qualquer ação sugerida gera um evento faturável chamado "Clique na ação sugerida". (As ações sugeridas podem incluir um identificador de dados de postback no payload da mensagem.)

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

O Compartilhamento de local é exclusivo porque gera dois eventos faturáveis de P2A separados:

O clique na ação sugerida: o toque do usuário na ação sugerida de compartilhamento de local gera um evento de clique na ação sugerida.
A mensagem de localização:depois que o usuário seleciona um local na interface do mapa, uma mensagem com as coordenadas de localização é enviada ao agente. Essa mensagem MO gera um evento de mensagem rich media com uma contagem de segmentos de um.

Exemplos de resposta do webhook P2A

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

Exemplo de webhook para um `RICH_MESSAGE` enviado 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 um `RICH_MEDIA_MESSAGE` enviado 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 `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 local

Esse é o segundo evento faturável no fluxo de compartilhamento de local, enviado depois que o usuário compartilha o local no mapa.

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

Observações técnicas e de implementação

Os segmentos são 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 da mensagem é totalmente automática com base no conteúdo dela e não pode ser substituída manualmente.
Lançamento: o modelo de faturamento dos EUA foi ativado em toda a plataforma do RCS para empresas em 15 de julho de 2025. A partir dessa data, os relatórios e as respostas da API do Google vão refletir as novas classificações.