Esta página descreve os arquivos de dados que o RCS for Business cria para ajudar as operadoras dos EUA com faturamento e auditoria de acordo com a estrutura de RBM dos EUA. Para saber mais sobre a estrutura do RBM nos EUA, consulte usrbm.org.
O relatório de faturamento é um relatório agregado de eventos faturáveis entre agentes e usuários lançados. Faturável significa apenas que um evento está qualificado para uma cobrança. As operadoras determinam se e como os eventos faturáveis são cobrados. Todas as operadoras dos EUA que usam o RCS for Business têm acesso aos relatórios de faturamento.
Para mais detalhes sobre o modelo de classificações de faturamento dos EUA, consulte as perguntas frequentes sobre faturamento dos EUA.
Geração de arquivos
Para mais informações, consulte Geração de arquivos.
Armazenamento e acesso a arquivos
Para mais informações, consulte Armazenamento e acesso a arquivos.
Disponibilidade de arquivos
Para mais informações, consulte Disponibilidade de arquivos.
Relatórios de faturamento
Os relatórios de faturamento são registros de eventos faturáveis, que são calculados com base na categoria de faturamento do agente e no tipo de mensagens que ele envia. Os relatórios de faturamento estão disponíveis para todas as operadoras que usam ativamente o RCS para empresas.
Os relatórios de faturamento contêm informações confidenciais, mas não informações de identificação pessoal (PII) do usuário, como MSISDN, MSISDN hash ou qualquer identificador exclusivo do usuário.
Categorias de faturamento x eventos faturáveis
A distinção entre categorias de faturamento e eventos faturáveis do agente é fundamental para entender como ele é faturado.
- A categoria de faturamento é uma classificação fixa que você escolhe ao criar seu agente. Ele determina o método pelo qual seu agente é faturável: por mensagem (agentes não conversacionais) ou por sessão (agentes de conversa).
- Eventos faturáveis são interações entre um agente do RCS for Business e um
usuário que são rastreadas para fins de faturamento (por exemplo,
rich_message).
Categorias de faturamento de agentes nos EUA
Ao criar um agente, o proprietário define a categoria de faturamento com base em como ele vai interagir com os usuários. A categoria de faturamento não restringe o número ou o tipo de mensagens que um agente pode enviar. Mas ele determina como o agente será cobrado pelas mensagens. As duas principais categorias de faturamento são descritas na tabela a seguir.
| Categoria do faturamento | Tipo de representante | Exemplos de casos de uso | Método de faturamento |
|---|---|---|---|
| Não conversacional | Agentes que enviam principalmente mensagens unidirecionais. |
|
Faturável por cada mensagem entregue ao usuário. |
| Conversacional | Agentes projetados para trocas de mensagens com os usuários, independentemente de quem inicia a conversa. |
|
Faturamento por sessão: se os critérios de sessão forem atendidos, todas as mensagens rich media dentro da janela de sessão de 24 horas serão faturadas a uma taxa fixa, independente da duração ou dos segmentos. Faturamento por mensagem: se os critérios de sessão não forem atendidos ou se uma mensagem estiver fora da janela de sessão de 24 horas, ela será faturada individualmente a uma taxa por mensagem para rich media, de acordo com a tabela de preços da operadora. |
Agentes de conversação e não conversacionais
Há duas categorias de faturamento de agentes: conversacional e não conversacional.
Os agentes não conversacionais são cobrados por cada mensagem entregue ao usuário.
- Essa categoria é ideal para agentes que não esperam respostas frequentes.
Os agentes conversacionais são cobrados a uma taxa fixa por sessão, desde que uma sessão seja acionada. Ela inclui todas as mensagens trocadas em um período de 24 horas, incluindo as mensagens que acionaram a sessão. Os agentes de conversa ainda podem ter cobranças por mensagens que não fazem parte de uma sessão de 24 horas.
- Essa categoria é ideal para agentes que participam de conversas com vários turnos com os usuários.
Lógica de faturamento da sessão
No modelo de faturamento dos EUA, uma sessão é acionada por uma sequência de quatro mensagens avançadas ou de mídia avançada (incluindo pelo menos duas mensagens MO e uma MT) trocadas em um período de 24 horas a partir da primeira mensagem na sequência de acionamento. Depois que esse limite é atingido, todas as mensagens dentro desse período de 24 horas são faturáveis como uma única sessão. As mensagens que não se enquadram ou não acionam uma sessão são faturadas na taxa padrão por mensagem para rich media ou rich media, de acordo com a tabela de preços da operadora.
O diagrama a seguir mostra um exemplo de uma sessão de faturamento A2P para agentes de conversa.
- MT (Mobile Terminated) é uma mensagem enviada pela empresa.
- MO (Mobile Originated) é uma mensagem ou ação iniciada pelo usuário.
Eventos faturáveis
Os fluxos de mensagens são categorizados por origem e direção. 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 for Business. Confira um resumo rápido de como esses termos se alinham:
- A2P (aplicativo para pessoa) é MT (encerrado no dispositivo móvel): uma mensagem enviada pela empresa.
- P2A (pessoa para aplicativo) é MO (originada em dispositivo móvel): uma mensagem ou ação iniciada pelo usuário.
| Evento | Descrição | Agentes não conversacionais | Agentes de conversação |
|---|---|---|---|
a2p_rich_message |
Uma mensagem enviada pelo agente que contém apenas texto, respostas sugeridas ou ações sugeridas específicas (discar um número, abrir URL no navegador). | Sempre tratado como um evento faturável individual. Faturável por mensagem com base em segmentos (um segmento é igual a 160 bytes UTF-8). |
Tratado como um evento faturável individual, a menos que faça parte de uma sessão. |
p2a_rich_message |
Uma mensagem enviada pelo usuário que contém apenas texto livre ou texto de uma resposta sugerida. | Sempre tratado como um evento faturável individual. Cobrança por mensagem com base em segmentos. |
Tratado como um evento faturável individual, a menos que faça parte de uma sessão. |
a2p_rich_media_message |
Uma mensagem enviada pelo agente que contém mídia (imagem, vídeo, áudio), rich cards, carrosséis ou ações complexas, como "Ver local". | Sempre tratado como um evento faturável individual. Faturável como um único evento de taxa fixa, independente do tamanho ou do conteúdo. |
Tratado como um evento faturável individual, a menos que faça parte de uma sessão. |
p2a_rich_media_message |
Uma mensagem enviada pelo usuário que contém um arquivo de mídia enviado (imagem, vídeo, áudio). | Sempre tratado como um evento faturável individual. Faturável como um único evento de taxa fixa. |
Tratado como um evento faturável individual, a menos que faça parte de uma sessão. |
p2a_suggested_action |
Um usuário toca em qualquer ação sugerida (por exemplo, "Ver local") que não seja uma resposta sugerida. | Sempre tratado como um evento faturável individual. Gera um evento faturável por clique. |
É tratado como um evento faturável individual e gera um evento faturável por clique, a menos que faça parte de uma sessão. |
a2p_session |
Uma janela de interação de 24 horas que começa quando um gatilho de sessão é iniciado e a primeira mensagem é MT. Para mais informações, consulte O que é uma sessão e como ela funciona. | N/A. As sessões não se aplicam a agentes de conversação. | Depois de acionadas, todas as mensagens na janela de 24 horas são cobertas por uma única taxa de sessão. Qualquer evento faturável na sessão de 24 horas será atribuído ao ID do evento faturável da sessão. |
p2a_session |
Uma janela de interação de 24 horas que começa quando um gatilho de sessão é iniciado e a primeira mensagem é MO. Para mais informações, consulte O que é uma sessão e como ela funciona. | N/A. As sessões não se aplicam a agentes de conversação. | Depois de acionadas, todas as mensagens na janela de 24 horas são cobertas por uma única taxa de sessão. Qualquer evento faturável na sessão de 24 horas será atribuído ao ID do evento faturável da sessão. |
Geração de relatórios de faturamento
Somente agentes com tráfego que não é de teste geram eventos faturáveis. A atividade de números de telefone de teste não aparece nos relatórios de faturamento.
Esses relatórios presumem que os eventos são faturáveis quando as mensagens A2P são entregues, não quando são enviadas. Uma mensagem não entregue ou cancelada antes da entrega não aciona um evento faturável.
Formato do relatório de faturamento
Os relatórios de faturamento usam o formato de nome de arquivo rbm_billable_events_YYYY-MM-DD.csv.
A data no nome de arquivo é a data de geração de arquivo.
Cada linha no relatório é um registro que representa um único evento faturável.
As sessões A2P/P2A são representadas por várias linhas, uma para cada mensagem
trocada. Cada linha associada a uma sessão (compartilhando o mesmo
billing_event_id) vai informar o número total de mensagens MT e MO para toda a janela de sessão de 24 horas nas colunas mt_messages e mo_messages.
Os arquivos são codificados em UTF-8 sem uma marca de ordem de byte e usam feeds de linha para finais de linha. A primeira linha de cada arquivo é uma linha de cabeçalho com os nomes dos campos.
Cada registro no relatório contém as seguintes informações para cada evento faturável.
| Campo | Formato | Descrição | Exemplo |
|---|---|---|---|
billing_event_id |
string | ID gerado que distingue o evento faturável. Todas as mensagens que fazem parte de uma sessão têm o mesmo |
63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e |
type |
string | Tipo de evento:a2p_rich_messagea2p_rich_media_messagep2a_rich_messagep2a_rich_media_messagep2a_suggested_action |
p2a_rich_message |
agent_id |
string | Identificador exclusivo do agente que participou do evento. | acme_342h23_agent@rbm.goog |
agent_owner |
string | Endereço de e-mail do proprietário atual da conta de parceiro em que o representante foi criado. | marketing@xyzaggregator.com |
billing_party |
string | Parte que fatura eventos. | operadora |
max_duration_single_message |
número | Tempo máximo (em horas) permitido para um usuário responder a uma mensagem do agente antes que a janela de início da conversa seja fechada e a mensagem seja classificada como um evento single_message. Não relevante para o modelo dos EUA para mensagens avançadas individuais. |
24 |
max_duration_a2p_conversation |
número | No piloto de sessões, isso reflete a janela de sessão de 24 horas medida a partir da primeira mensagem na sequência de acionamento. A duração é medida em horas. | 24 |
max_duration_p2a_conversation |
número | No piloto de sessões, isso reflete a janela de sessão de 24 horas medida a partir da primeira mensagem na sequência de acionamento. | 24 |
start_time |
YYYY-mm-ddTHH:00:00Z | A data/hora UTC em que o evento começou (ISO 8601). Para sessões, esse é o carimbo de data/hora da primeira mensagem na sequência de acionamento. A2P a2p_rich_message e a2p_rich_media_message, esse é o momento em que a mensagem é entregue ao usuário.a2p_session, esse é o momento em que a primeira mensagem da conversa é entregue ao usuário.P2A p2a_rich_message e p2a_rich_media_message, esse é o momento em que a mensagem é enviada pelo usuário.p2a_session, esse é o momento em que a primeira mensagem da conversa é enviada pelo usuário. |
2025-05-20T08:00:00Z |
duration |
número | A duração se refere apenas às sessões e é medida em minutos. Quando o evento não é de sessão, o valor é 0. | 45 |
mt_messages |
número | Número de mensagens encerradas em dispositivos móveis (A2P) no evento. Para sessões, cada linha que compartilha o mesmo billing_event_id mostra o número total de mensagens MT em toda a sessão. |
5 |
mo_messages |
número | Número de mensagens originadas em dispositivos móveis (P2A) no evento. Para sessões, cada linha que compartilha o mesmo billing_event_id mostra o número total de mensagens MO em toda a sessão. |
3 |
size_kilobytes |
número | Tamanho de todos os arquivos anexados às mensagens no evento, arredondado para o kilobyte mais próximo (1 kB é igual a 1.024 bytes). | 912 |
agent_name |
string | Nome do agente que participou do evento. | ACME Brand |
owner_name |
string | Nome do proprietário atual da conta de parceiro em que o agente foi criado. | XYZ Aggregator |
segment_count |
número | A contagem de segmentos calculada para eventos a2p_rich_message events e p2a_rich_message (um segmento é igual a 160 bytes UTF-8). Quando o evento não é um dos mencionados, o valor é 0. |
5 |
session_type |
string | Tipo de sessão:a2p_sessionp2a_session |
a2p_session |
Exemplo de relatório de faturamento
Um exemplo de relatório está disponível para download:
Tamanho típico do arquivo
O tamanho de um relatório diário de um parceiro ativo do RCS for Business depende da quantidade de atividade gerada na rede da operadora.