미국 결제 보고서

이 페이지에서는 미국 이동통신사가 미국 RBM 프레임워크에 따라 청구 및 감사를 수행할 수 있도록 비즈니스용 RCS에서 생성하는 데이터 파일을 설명합니다. 미국 RBM 프레임워크에 대해 자세히 알아보려면 usrbm.org를 참고하세요.

결제 보고서는 실행된 에이전트와 사용자 간의 청구 가능한 이벤트를 집계한 보고서입니다. 청구 가능은 이벤트에 요금이 청구될 수 있음을 의미합니다. 운송업체는 청구 가능한 이벤트가 청구되는지 여부와 방법을 결정합니다. 비즈니스용 RCS를 활발하게 운영하는 모든 미국 이동통신사는 결제 보고서에 액세스할 수 있습니다.

참고: 표준 결제 모델에 대한 자세한 내용과 결제 모델 차이점 요약은 표준 결제 FAQ를 참고하세요.

미국 결제 분류 모델에 대한 자세한 내용은 미국 결제 FAQ를 참고하세요.

파일 생성

자세한 내용은 파일 생성을 참고하세요.

파일 스토리지 및 액세스

자세한 내용은 파일 저장 및 액세스를 참고하세요.

파일 사용 가능 여부

자세한 내용은 파일 사용 가능 여부를 참고하세요.

결제 보고서

결제 보고서는 청구 가능 이벤트의 기록이며, 이는 에이전트의 청구 카테고리와 에이전트가 전송하는 메시지 유형을 기준으로 계산됩니다. 결제 보고서는 비즈니스용 RCS를 활발하게 운영하는 모든 이동통신사에서 사용할 수 있습니다.

결제 보고서에는 기밀 정보가 포함되지만 사용자 개인 식별 정보(PII)(예: MSISDN, 해시된 MSISDN 또는 사용자 고유 식별자)는 포함되지 않습니다.

참고: 파트너는 트래픽을 관리하는 데 도움이 되는 집계된 일일 요약 보고서도 받습니다. 이 보고서는 파트너에게 유용한 분석과 트래픽 데이터에 대한 필요한 가시성을 제공합니다. 자세한 내용은 파트너 결제 보고서를 참고하세요.

결제 카테고리와 청구 대상 이벤트 비교

에이전트 청구 카테고리와 청구 가능한 이벤트의 차이점을 이해하는 것이 에이전트의 청구 가능 여부를 파악하는 데 중요합니다.

• 결제 카테고리는 상담사를 만들 때 선택하는 고정 분류입니다. 에이전트의 요금이 청구되는 방식을 결정합니다. 메시지당 (비대화형 에이전트) 또는 세션당 (대화형 에이전트)
• 청구 가능한 이벤트는 청구 목적으로 추적되는 비즈니스용 RCS 에이전트와 사용자 간의 상호작용입니다 (예: rich_message).

미국 에이전트 결제 카테고리

에이전트를 만들 때 소유자는 에이전트가 사용자와 상호작용하는 방식에 따라 청구 카테고리를 설정합니다. 결제 카테고리는 에이전트가 전송할 수 있는 메시지의 수나 유형을 제한하지 않습니다. 하지만 에이전트가 메시지에 대해 청구되는 방식을 결정합니다. 두 가지 주요 청구 카테고리는 다음 표에 설명되어 있습니다.

결제 카테고리	에이전트 유형	사용 사례	결제 방법
비대화형	주로 일방향 메시지를 보내는 상담사	OTP 알림 프로모션 코드	사용자에게 전송된 각 메시지에 대해 청구됩니다.
대화형	누가 대화를 시작하는지와 관계없이 사용자와의 양방향 교환을 위해 설계된 에이전트	적합한 제품 찾기 티켓 예약 문제 해결	세션당 청구 가능: 세션 기준을 충족하는 경우 24시간 세션 기간 내의 모든 리치 및 리치 미디어 메시지는 길이 또는 세그먼트에 관계없이 고정 요금으로 청구됩니다. 메시지당 청구 가능: 세션 기준을 충족하지 않거나 메시지가 24시간 세션 기간을 벗어나는 경우 메시지는 개별 이동통신사의 요금표에 따라 리치 또는 리치 미디어에 대해 메시지당 요금으로 개별적으로 청구됩니다.

대화형 에이전트와 비대화형 에이전트 비교

상담사 청구 카테고리에는 대화형과 비대화형의 두 가지가 있습니다.

• 비대화형 에이전트는 사용자에게 전송하는 각 메시지에 대해 요금이 청구됩니다.

  • 이 카테고리는 자주 응답을 기대하지 않는 상담사에게 가장 적합합니다.

• 대화형 상담사는 세션이 트리거된 경우 세션에 대해 고정 요금이 청구되며, 세션을 트리거한 메시지를 포함하여 24시간 이내에 교환된 모든 메시지가 포함됩니다. 대화형 에이전트는 24시간 세션에 포함되지 않는 메시지에 대해 요금이 청구될 수 있습니다.

  • 이 카테고리는 사용자와 멀티턴 대화를 하는 상담사에게 가장 적합합니다.

세션 청구 로직

미국 결제 모델에서 세션은 트리거 시퀀스의 첫 번째 메시지로부터 24시간 이내에 교환된 4개의 리치 또는 리치 미디어 메시지 (MO 메시지 2개 이상 및 MT 메시지 1개 이상 포함) 시퀀스에 의해 트리거됩니다. 이 기준이 충족되면 해당 24시간 내의 모든 메시지가 단일 세션으로 청구됩니다. 세션이 시작되지 않는 메시지는 개별 이동통신사의 요금표에 따라 리치 또는 리치 미디어의 표준 메일당 요금으로 청구됩니다.

다음 다이어그램은 대화형 에이전트의 A2P 청구 세션의 예를 보여줍니다.

• MT (Mobile Terminated)는 비즈니스에서 보낸 메시지입니다.
• MO (Mobile Originated)는 사용자가 시작한 메시지 또는 작업입니다.

청구 가능한 이벤트

메시지 흐름은 출처와 방향에 따라 분류됩니다. 메시지 트래픽의 방향을 설명하기 위해 미국 이동통신사는 일반적으로 MT/MO 용어를 사용합니다. 이러한 용어는 비즈니스용 RCS 문서 전체에서 사용되는 A2P/P2A 용어와 상응합니다. 이러한 용어의 관계는 다음과 같습니다.

• A2P (Application-to-Person)는 MT (Mobile Terminated): 비즈니스에서 보낸 메시지입니다.
• P2A (Person-to-Application)는 MO (Mobile Originated)입니다. 사용자가 시작한 메시지 또는 작업입니다.

이벤트	설명	비대화형 에이전트	대화형 에이전트
a2p_rich_message	텍스트, 추천 답장 또는 특정 추천 작업 (번호 다이얼, 브라우저에서 URL 열기)만 포함된 에이전트 전송 메시지입니다.	항상 개별 청구 가능 이벤트로 처리됩니다. 세그먼트를 기준으로 메시지당 청구됩니다 (1세그먼트는 160 UTF-8 바이트와 동일).	세션의 일부가 되지 않는 한 개별 청구 가능 이벤트로 처리됩니다.
p2a_rich_message	자유 형식 텍스트 또는 추천 답장을 탭하여 생성된 텍스트만 포함된 사용자 전송 메시지입니다.	항상 개별 청구 가능 이벤트로 처리됩니다. 세그먼트를 기반으로 메시지당 청구 가능	세션의 일부가 되지 않는 한 개별 청구 가능 이벤트로 처리됩니다.
a2p_rich_media_message	미디어 (이미지, 동영상, 오디오), 리치 카드, 캐러셀 또는 '위치 보기'와 같은 복잡한 작업을 포함하는 상담사가 보낸 메시지	항상 개별 청구 가능 이벤트로 처리됩니다. 크기나 콘텐츠와 관계없이 단일 정액제 이벤트로 청구됩니다.	세션의 일부가 되지 않는 한 개별 청구 가능 이벤트로 처리됩니다.
p2a_rich_media_message	업로드된 미디어 파일 (이미지, 동영상, 오디오)이 포함된 사용자 전송 메시지입니다.	항상 개별 청구 가능 이벤트로 처리됩니다. 단일 고정 요금 이벤트로 청구됩니다.	세션의 일부가 되지 않는 한 개별 청구 가능 이벤트로 처리됩니다.
p2a_suggested_action	사용자가 추천 답장이 아닌 추천 작업 (예: '위치 보기')을 탭합니다.	항상 개별 청구 가능 이벤트로 처리됩니다. 클릭당 청구 가능한 이벤트 하나를 생성합니다.	개별 청구 가능 이벤트로 처리되며 세션의 일부가 되지 않는 한 클릭당 하나의 청구 가능 이벤트를 생성합니다.
a2p_session	세션 트리거가 시작되고 첫 번째 메시지가 MT인 경우 시작되는 24시간 상호작용 기간입니다. 자세한 내용은 세션이란 무엇이며 어떻게 작동하나요?를 참고하세요.	해당 사항 없음. 세션은 비대화형 에이전트에는 적용되지 않습니다.	트리거되면 24시간 기간의 모든 메시지에 단일 세션 요금이 적용됩니다. 24시간 세션의 모든 청구 가능 이벤트는 세션의 청구 가능 이벤트 ID에 할당됩니다.
p2a_session	세션 트리거가 시작되고 첫 번째 메시지가 MO인 경우 시작되는 24시간 상호작용 기간입니다. 자세한 내용은 세션이란 무엇이며 어떻게 작동하나요?를 참고하세요.	해당 사항 없음. 세션은 비대화형 에이전트에는 적용되지 않습니다.	트리거되면 24시간 기간의 모든 메시지에 단일 세션 요금이 적용됩니다. 24시간 세션의 모든 청구 가능 이벤트는 세션의 청구 가능 이벤트 ID에 할당됩니다.

결제 보고서 생성

테스터 트래픽이 아닌 트래픽이 있는 에이전트만 청구 가능한 이벤트를 생성합니다. 테스트 전화번호의 활동은 청구 보고서에 표시되지 않습니다.

이러한 보고서는 메시지가 전송될 때가 아닌 A2P 메시지가 전송될 때 이벤트에 요금이 청구된다고 가정합니다. 전달되지 않은 메일이나 전달 전에 취소된 메일은 청구 가능한 이벤트를 트리거하지 않습니다.

결제 보고서 형식

결제 보고서는 rbm_billable_events_YYYY-MM-DD.csv 파일 이름 형식을 사용합니다. 파일 이름의 날짜는 파일 생성 날짜입니다.

보고서의 각 행은 단일 청구 가능 이벤트를 나타내는 레코드입니다. A2P/P2A 세션은 교환된 각 메시지에 대해 하나씩 여러 행으로 표시됩니다. 세션과 연결된 모든 행 (동일한 billing_event_id 공유)은 mt_messages 및 mo_messages 열에 전체 24시간 세션 기간의 총 MT 및 MO 메시지 수를 보고합니다.

파일은 바이트 순서 표시 없이 UTF-8로 인코딩되며 줄 끝에는 라인 피드를 사용합니다. 각 파일의 첫 번째 줄은 필드 이름이 있는 헤더 행입니다.

보고서의 각 레코드에는 청구 가능한 각 이벤트에 대한 다음 정보가 포함됩니다.

필드	형식	설명	예
billing_event_id	문자열	청구 가능한 이벤트를 구분하는 생성된 ID입니다. 세션에 속하는 모든 메시지의 billing_event_id는 동일합니다.	63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e
type	문자열	이벤트 유형: a2p_rich_message a2p_rich_media_message p2a_rich_message p2a_rich_media_message p2a_suggested_action	p2a_rich_message
agent_id	문자열	이벤트에 참여한 상담사의 고유 식별자입니다.	[e-mail]
agent_owner	문자열	에이전트가 생성된 파트너 계정의 현재 소유자의 이메일 주소입니다.	[e-mail]
billing_party	문자열	이벤트 비용을 청구하는 당사자입니다.	이동통신사
max_duration_single_message	숫자	대화 시작 창이 닫히고 메시지가 single_message 이벤트로 분류되기 전에 사용자가 상담사 메시지에 응답할 수 있는 최대 시간 (시간)입니다. 개별 리치 메시지의 미국 모델에는 적용되지 않습니다.	24
max_duration_a2p_conversation	숫자	세션 파일럿의 경우 트리거 시퀀스의 첫 번째 메시지부터 측정된 24시간 세션 기간이 반영됩니다. 기간은 시간 단위로 측정됩니다.	24
max_duration_p2a_conversation	숫자	세션 파일럿의 경우 트리거 시퀀스의 첫 번째 메시지부터 측정된 24시간 세션 기간이 반영됩니다.	24
start_time	YYYY-mm-ddTHH:00:00Z	이벤트가 시작된 UTC 날짜/시간 (ISO 8601)입니다. 세션의 경우 트리거 시퀀스의 첫 번째 메시지의 타임스탬프입니다. A2P a2p_rich_message, a2p_rich_media_message과 같은 세션 외 이벤트의 경우 메시지가 사용자에게 전송된 시간입니다. a2p_session 이벤트의 경우 대화의 첫 번째 메시지가 사용자에게 전송된 시간입니다. P2A p2a_rich_message, p2a_rich_media_message과 같은 세션이 아닌 이벤트의 경우 사용자가 메시지를 전송한 시간입니다. p2a_session 이벤트의 경우 대화의 첫 번째 메시지가 사용자에 의해 전송된 시간입니다.	2025-05-20T08:00:00Z
duration	숫자	기간은 세션에만 적용되며 분 단위로 측정됩니다. 이벤트가 세션 이벤트가 아닌 경우 값은 0입니다.	45
mt_messages	숫자	이벤트의 모바일 수신 (A2P) 메시지 수입니다. 세션의 경우 동일한 billing_event_id를 공유하는 각 행에는 전체 세션의 MT 메시지 총수가 표시됩니다.	5
mo_messages	숫자	이벤트의 모바일 발신 (P2A) 메시지 수입니다. 세션의 경우 동일한 billing_event_id를 공유하는 각 행에는 전체 세션의 총 MO 메시지 수가 표시됩니다.	3
size_kilobytes	숫자	이벤트의 메일에 첨부된 모든 파일의 크기입니다. 가장 가까운 킬로바이트로 반올림됩니다 (1KB는 1024바이트와 같음).	912
agent_name	문자열	이벤트에 참여한 상담사의 이름입니다.	ACME Brand
owner_name	문자열	상담사가 생성된 파트너 계정의 현재 소유자 이름입니다.	XYZ Aggregator
segment_count	숫자	a2p_rich_message events 및 p2a_rich_message 이벤트의 계산된 세그먼트 수입니다 (1세그먼트는 160 UTF-8 바이트와 동일). 이벤트가 언급된 이벤트 중 하나가 아닌 경우 값은 0입니다.	5
session_type	문자열	세션 유형: a2p_session p2a_session 활동이 세션으로 간주되지 않는 경우 비어 있습니다.	a2p_session

샘플 결제 보고서

샘플 보고서를 다운로드할 수 있습니다.

• 미국 결제 모델의 결제 보고서

일반적인 파일 크기

활성 상태의 비즈니스용 RCS 파트너의 일일 보고서 크기는 이동통신사 네트워크에서 생성한 활동량에 따라 달라집니다.