Esta página descreve os arquivos de dados que o RCS for Business cria para auxiliar as operadoras dos EUA com faturamento e auditoria de acordo com a estrutura RBM dos EUA. Para saber mais sobre a estrutura RBM dos EUA, você também pode consultar o site usrbm.org .
O relatório de faturamento é um relatório agregado de eventos faturáveis entre agentes e usuários. Faturável significa simplesmente que um evento é elegível para cobrança. As operadoras determinam se e como os eventos faturáveis serão cobrados. Todas as operadoras dos EUA que operam ativamente o RCS for Business têm acesso aos relatórios de faturamento.
Para obter detalhes sobre o modelo de classificação de faturamento dos EUA, consulte as Perguntas Frequentes sobre Faturamento nos EUA .
Geração de arquivos
Para obter mais informações, consulte Geração de arquivos .
Armazenamento e acesso a arquivos
Para obter mais informações, consulte Armazenamento e acesso a arquivos .
Disponibilidade de arquivos
Para obter mais informações, consulte Disponibilidade de arquivos .
Relatórios de faturamento
Os relatórios de faturamento são registros de eventos faturáveis , 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 utilizam o RCS for Business.
Os relatórios de faturamento contêm informações confidenciais, mas não incluem informações de identificação pessoal (PII) do usuário, como MSISDN, MSISDN criptografado ou qualquer identificador exclusivo do usuário.
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 é cobrado.
- A categoria de faturamento é uma classificação fixa que você escolhe ao criar seu agente. Ela determina o método pelo qual seu agente será cobrado: por mensagem (agentes não conversacionais) ou por sessão (agentes conversacionais).
- Eventos faturáveis são interações entre um agente RCS for Business e um usuário que são rastreadas para fins de faturamento (por exemplo,
rich_message).
Categorias de faturamento para agentes dos EUA
Ao criar um agente, o proprietário define sua categoria de faturamento com base em como o agente 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á cobrado pelas mensagens. As duas principais categorias de faturamento são descritas na tabela a seguir.
| Categoria de faturamento | Tipo de agente | Exemplos de casos de uso | Método de faturamento |
|---|---|---|---|
| Não conversacional | Agentes que enviam principalmente mensagens unidirecionais. |
| Cobrado por cada mensagem entregue ao usuário. |
| Conversacional | Agentes projetados para interações bilaterais com os usuários, independentemente de quem inicie a conversa. |
| Cobrança por sessão : Se os critérios da sessão forem atendidos, todas as mensagens rich media e rich media dentro do período de 24 horas serão cobradas a uma taxa fixa, independentemente da duração ou dos segmentos. Cobrança por mensagem : Se os critérios da sessão não forem atendidos ou se uma mensagem for enviada fora do período de 24 horas, a mensagem será cobrada individualmente, de acordo com a tabela de preços da operadora, para conteúdo rico ou multimídia. |
Agentes conversacionais versus agentes não conversacionais
Existem duas categorias de faturamento para agentes: conversacional e não conversacional.
Os agentes não conversacionais são cobrados por cada mensagem que entregam ao usuário.
- Esta categoria é ideal para agentes que não esperam respostas frequentes.
Os agentes de conversação são cobrados por uma taxa fixa por sessão, desde que a sessão seja iniciada. Essa taxa inclui todas as mensagens trocadas em um período de 24 horas, inclusive as mensagens que iniciaram a sessão. Os agentes de conversação ainda podem ser cobrados por mensagens que não fazem parte de uma sessão de 24 horas.
- Esta categoria é ideal para agentes que participam de conversas com vários usuários, que envolvem diversas interações.
Lógica de faturamento por sessão
No modelo de faturamento dos EUA, uma sessão é iniciada por uma sequência de 4 mensagens ricas ou com conteúdo multimídia (incluindo pelo menos 2 mensagens MO e pelo menos 1 mensagem MT) trocadas dentro de um período de 24 horas a partir da primeira mensagem da sequência. Uma vez atingido esse limite, todas as mensagens dentro desse período de 24 horas são faturadas como uma única sessão . Quaisquer mensagens que não se enquadrem nesse limite ou que não iniciem uma sessão serão faturadas de acordo com a tarifa padrão por mensagem para mensagens ricas ou com conteúdo multimídia, conforme a tabela de preços de cada 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 sua 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 para Empresas. Aqui está um breve resumo de como esses termos se alinham:
- A2P (Application-to-Person) é MT (Mobile Terminated) : uma mensagem enviada pela empresa.
- P2A (Pessoa para Aplicativo) é MO (Originado por Dispositivo Móvel) : Uma mensagem ou ação iniciada pelo usuário.
| Evento | Descrição | Agentes não conversacionais | Agentes conversacionais |
|---|---|---|---|
a2p_rich_message | Uma mensagem enviada por um agente contendo apenas texto, respostas sugeridas ou ações específicas sugeridas (Discar um número, Abrir URL no navegador). | Sempre tratado como um evento faturável individual. Cobrança por mensagem com base em segmentos (1 segmento equivale a 160 bytes UTF-8). | Será tratado como um evento faturável individual, a menos que passe a fazer parte de uma sessão. |
p2a_rich_message | Uma mensagem enviada pelo usuário contendo apenas texto livre ou texto obtido ao tocar em uma resposta sugerida. | Sempre tratado como um evento faturável individual. Cobrança por mensagem com base em segmentos. | Será tratado como um evento faturável individual, a menos que passe a fazer parte de uma sessão. |
a2p_rich_media_message | Uma mensagem enviada por um agente contendo mídia (imagem, vídeo, áudio), rich cards, carrosséis ou ações complexas como "Ver localização". | Sempre tratado como um evento faturável individual. Faturável como um evento único com preço fixo, independentemente do tamanho ou conteúdo. | Será tratado como um evento faturável individual, a menos que passe a fazer parte de uma sessão. |
p2a_rich_media_message | Uma mensagem enviada pelo usuário contendo um arquivo de mídia carregado (imagem, vídeo, áudio). | Sempre tratado como um evento faturável individual. Faturável como um evento único com preço fixo. | Será tratado como um evento faturável individual, a menos que passe a fazer parte de uma sessão. |
p2a_suggested_action | O usuário toca em qualquer ação sugerida (por exemplo, "Ver localização") que não seja uma resposta sugerida. | Sempre tratado como um evento faturável individual. Gera um evento faturável por clique. | Tratada como um evento faturável individual, gera um evento faturável por clique, a menos que se torne parte de uma sessão. |
a2p_session | Uma janela de interação de 24 horas que se inicia quando um gatilho de sessão é acionado e a primeira mensagem é enviada. Para mais informações, consulte O que é uma sessão e como ela funciona . | Não aplicável. As sessões não se aplicam a agentes não conversacionais. | Uma vez acionada, 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 de evento faturável da sessão. |
p2a_session | Uma janela de interação de 24 horas que se inicia quando um gatilho de sessão é acionado e a primeira mensagem é enviada. Para mais informações, consulte O que é uma sessão e como ela funciona . | Não aplicável. As sessões não se aplicam a agentes não conversacionais. | Uma vez acionada, 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 de evento faturável da sessão. |
Geração de relatórios de faturamento
Somente os agentes com tráfego que não seja 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 partem do pressuposto de que os eventos são faturáveis quando as mensagens A2P são entregues, e não quando são enviadas. Uma mensagem não entregue ou cancelada antes da entrega não gera um evento faturável.
Formato do relatório de faturamento
Os relatórios de faturamento utilizam 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 representa um registro de 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 ) exibirá 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 | Formatar | Descrição | Exemplo |
|---|---|---|---|
billing_event_id | corda | ID gerado que distingue o evento faturável. Todas as mensagens que fazem parte de uma sessão terão o mesmo | 63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e |
type | corda | Tipo de evento:a2p_rich_messagea2p_rich_media_messagep2a_rich_messagep2a_rich_media_messagep2a_suggested_action | p2a_rich_message |
agent_id | corda | Identificador único do agente que participou do evento. | acme_342h23_agent@rbm.goog |
agent_owner | corda | Endereço de e-mail do proprietário atual da conta de parceiro onde o agente foi criado. | marketing@xyzaggregator.com |
billing_party | corda | Parte que cobra pelos eventos. | operadora |
max_duration_single_message | número | Tempo máximo (em horas) permitido para um usuário responder a uma mensagem de um agente antes que a janela de início da conversa se feche e a mensagem seja classificada como um evento de single_message . Não aplicável ao modelo dos EUA para mensagens ricas individuais. | 24 |
max_duration_a2p_conversation | número | Para o projeto piloto de sessões, isso reflete a janela de sessão de 24 horas, medida a partir da primeira mensagem na sequência de ativação. A duração é medida em horas. | 24 |
max_duration_p2a_conversation | número | Para o projeto piloto de sessões, isso reflete a janela de sessão de 24 horas medida a partir da primeira mensagem na sequência de ativação. | 24 |
start_time | AAAA-mm-ddTHH:00:00Z | A data e hora UTC em que o evento começou (ISO 8601). Para sessões, este é o registro de data e hora da primeira mensagem na sequência de disparo. A2P a2p_rich_message e a2p_rich_media_message , este é o momento em que a mensagem é entregue ao usuário.a2p_session , este é o momento em que a primeira mensagem da conversa é entregue ao usuário.P2A p2a_rich_message e p2a_rich_media_message , este é o momento em que a mensagem é enviada pelo usuário.p2a_session , este é 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 faz parte de 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 com 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 com 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 1024 bytes). | 912 |
agent_name | corda | Nome do agente que participou do evento. | ACME Brand |
owner_name | corda | Nome do proprietário atual da conta de parceiro onde o agente foi criado. | XYZ Aggregator |
segment_count | número | Contagem de segmentos calculada para a2p_rich_message events e p2a_rich_message (1 segmento equivale a 160 bytes UTF-8). Quando o evento não for um dos mencionados, o valor será 0. | 5 |
session_type | corda | 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 RCS for Business ativo depende da quantidade de atividade que ele gerou na rede da operadora.