Relatórios de faturamento dos EUA

Esta página descreve os arquivos de dados que o RCS for Business cria para ajudar as operadoras dos EUA com o faturamento e a auditoria de acordo com a estrutura do RBM dos EUA. Para saber mais sobre a estrutura do RBM dos EUA, consulte também usrbm.org.

O relatório de faturamento é um relatório agregado de eventos faturáveis entre agentes e usuários. Faturável significa que um evento pode ser cobrado. As operadoras determinam se e como os eventos faturáveis são cobrados. Todas as operadoras dos EUA que operam ativamente o RCS for Business têm acesso a relatórios de faturamento.

**Observação** :para mais detalhes sobre o modelo de faturamento padrão e um resumo das diferenças entre os modelos, consulte as perguntas frequentes sobre faturamento padrão.

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 enviadas. Os relatórios de faturamento estão disponíveis para todas as operadoras que operam ativamente o RCS for Business.

Os relatórios de faturamento contêm informações confidenciais, mas não informações de identificação pessoal (PII, na sigla em inglês) do usuário, como MSISDN, MSISDN com hash ou qualquer identificador exclusivo do usuário.

Observação: os Parceiros também recebem relatórios de resumo diário agregados para ajudar a gerenciar o tráfego, fornecendo análises valiosas e a visibilidade necessária das informações de trânsito. Para mais informações, consulte Relatórios de faturamento de parceiros.

Categorias de faturamento versus eventos faturáveis

A distinção entre categorias de faturamento de agentes e eventos faturáveis é fundamental para entender como seu agente é faturável.

• A categoria de faturamento é uma classificação fixa escolhida ao criar o agente. Ela determina o método pelo qual seu agente é faturável: por mensagem (agentes não conversacionais) ou por sessão (agentes conversacionais).
• 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 dos EUA

Ao criar um agente, o proprietário define a categoria de faturamento com base em como o agente 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. No entanto, ela determina como o agente será faturável para 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.	OTPs Alertas Ofertas promocionais	Faturável para cada mensagem entregue ao usuário.
Conversacional	Agentes projetados para trocas de mensagens com usuários, independentemente de quem iniciar a conversa.	Encontrar o produto certo Reservar um ingresso Resolver um problema	Faturável por sessão: se os critérios da sessão forem atendidos, todas as mensagens de mídia avançada e avançada na janela de sessão de 24 horas serão faturáveis a uma taxa fixa, independentemente da duração ou dos segmentos. Faturável por mensagem: se os critérios da sessão não forem atendidos ou se uma mensagem estiver fora da janela de sessão de 24 horas, a mensagem será faturável individualmente a uma taxa por mensagem para mídia avançada ou avançada, de acordo com a tabela de preços da operadora.

Agentes conversacionais versus não conversacionais

Há duas categorias de faturamento de agentes: conversacional e não conversacional.

• Os agentes não conversacionais são faturáveis para cada mensagem entregue ao usuário.

  • Essa categoria é mais adequada para agentes que não esperam respostas frequentes.

• Os agentesconversacionais são faturáveis a uma taxa fixa para sessões, desde que uma sessão seja acionada. Ela vai incluir todas as mensagens trocadas em um período de 24 horas, incluindo as mensagens que acionaram a sessão. Os agentes conversacionais ainda podem ter cobranças por mensagens que não fazem parte de uma sessão de 24 horas.

  • Essa categoria é mais adequada para agentes que se envolvem em conversas multiturno com os usuários.

Lógica de faturamento de sessões

No modelo de faturamento dos EUA, uma sessão é acionada por uma sequência de quatro mensagens de mídia avançada ou avançada (incluindo pelo menos duas mensagens MO e pelo menos uma mensagem MT) trocadas em uma janela de 24 horas a partir da primeira mensagem na sequência de acionamento. Quando esse limite é atingido, todas as mensagens nessa janela de 24 horas são faturáveis como uma única sessão. Todas as mensagens que estiverem fora ou não acionarem uma sessão serão faturáveis 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 conversacionais.

• 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 de como esses termos se alinham:

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

Evento	Descrição	Agentes não conversacionais	Agentes conversacionais
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 o 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. Faturável 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), cards avançados, carrosséis ou ações complexas, como "Ver local".	Sempre tratado como um evento faturável individual. Faturável como um evento único de taxa fixa, independentemente 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 evento único 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 acionador 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 não conversacionais.	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 acionador 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 não conversacionais.	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 não testador geram eventos faturáveis. A atividade de números de telefone de teste não aparece nos relatórios de faturamento.

Esses relatórios pressupõem 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 do arquivo é a data de geração do 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.

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 terão o mesmo billing_event_id.	63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e
type	string	Tipo de evento: a2p_rich_message a2p_rich_media_message p2a_rich_message p2a_rich_media_message p2a_suggested_action	p2a_rich_message
agent_id	string	Identificador exclusivo do agente que participou do evento.	[e-mail]
agent_owner	string	Endereço de e-mail do proprietário atual da conta de parceiro em que o agente foi criado.	[e-mail]
billing_party	string	Parte que fatura eventos.	operadora
max_duration_single_message	número	Tempo máximo (em horas) permitido para que um usuário responda 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 aplicável ao modelo dos EUA para mensagens avançadas individuais.	24
max_duration_a2p_conversation	número	Para o 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	Para o 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 Para eventos não relacionados à sessão, como a2p_rich_message e a2p_rich_media_message, esse é o momento em que a mensagem é entregue ao usuário. Para o evento a2p_session, esse é o momento em que a primeira mensagem na conversa é entregue ao usuário. P2A Para eventos não relacionados à sessão, como p2a_rich_message e p2a_rich_media_message, esse é o momento em que a mensagem é enviada pelo usuário. Para o evento p2a_session, esse é o momento em que a primeira mensagem na conversa é enviada pelo usuário.	2025-05-20T08:00:00Z
duration	número	A duração se refere apenas a sessões e é medida em minutos. Quando o evento não é uma sessão, o valor é 0.	45
mt_messages	número	Número de mensagens terminadas 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 a mensagens no evento, arredondado para o quilobyte 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_session p2a_session Ficará vazio se a atividade não se qualificar como uma sessão.	a2p_session

Exemplo de relatório de faturamento

O exemplo de relatório está disponível para download:

• Relatório de faturamento para o modelo de faturamento dos EUA

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.