미국 결제 모델

이 문서에서는 미국 이동통신사의 비즈니스용 RCS 트래픽 결제 모델을 간략히 설명합니다.

미국 결제 분류 개요

미국 전화번호로 주고받는 모든 메시지는 형식에 따라 다음 세 가지 유형 중 하나로 자동 분류됩니다.

  • 리치 메시지 (양방향)
  • 리치 미디어 메시지 (양방향)
  • 추천 작업 클릭 (사용자 시작)

자세한 사양은 다음 섹션을 참고하세요.

용어 관련 참고사항

메시지 트래픽의 방향을 설명하기 위해 미국 이동통신사는 일반적으로 MT/MO 용어를 사용합니다. 이러한 용어는 비즈니스용 RCS 문서 전반에 사용되는 A2P/P2A 용어에 해당합니다.

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

에이전트-개인 (A2P/MT) 이벤트 결제

이 섹션에서는 에이전트가 보낸 메시지 (즉, A2P 또는 MT 메시지)의 결제 로직을 다룹니다.

리치 메시지 (A2P)

메시지에 다음 요소의 조합만 포함된 경우 리치 메시지로 분류됩니다.

리치 메시지의 결제 로직

리치 메시지는 세그먼트를 기준으로 요금이 청구됩니다.

  • 세그먼트 크기: 1세그먼트 = UTF-8로 인코딩된 텍스트 160바이트
  • 계산: 메시지 텍스트의 총 UTF-8 바이트 길이를 160으로 나누고 항상 가장 가까운 정수로 반올림합니다.
  • 제외: 추천 답장 또는 작업 내의 텍스트와 포스트백 데이터는 세그먼트 수에 포함되지 않습니다.
  • : 300바이트 SMS에는 세그먼트가 2개 있습니다 (300 / 160 = 1.875, 반올림하여 2).

바이트 수

일부 유니코드 문자 (예: 그림 이모티콘 또는 악센트가 있는 문자)는 멀티바이트이므로 총 UTF 바이트 수가 문자 수와 다를 수 있습니다.

메시지의 정확한 바이트 수를 확인하려면 아래에 입력하거나 붙여넣으세요.

리치 미디어 메시지 (A2P)

메일에 다음 중 하나 이상이 포함되어 있으면 리치 미디어 메시지로 분류됩니다.

리치 미디어 메시지의 청구 로직

리치 미디어 메시지는 단일 정액제 이벤트로 청구됩니다.

  • 텍스트 길이, 카드 수, 미디어 파일 크기에 관계없이 청구 금액은 동일합니다.
  • 세분화가 적용되지 않습니다.

A2P API 응답 예시

다음 예는 에이전트가 보낸 메시지에 대한 성공적인 RBM API 호출 응답의 richMessageClassification 필드를 보여줍니다.

RICH_MESSAGE의 API 응답 예시

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

RICH_MEDIA_MESSAGE의 API 응답 예시

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

Person-to-Agent (P2A/MO) 이벤트 결제

이 섹션에서는 사용자가 시작한 메시지 및 작업 (즉, P2A 또는 MO 메시지)의 청구에 대해 설명합니다.

리치 메시지 (P2A)

사용자 메시지에 텍스트만 포함된 경우 리치 메시지로 분류됩니다. 여기에는 자유 형식 텍스트와 추천 답장을 탭하여 생성된 텍스트가 모두 포함됩니다. (제안된 답장에는 메시지 페이로드에 포스트백 데이터 식별자가 포함될 수 있습니다.)

청구 로직: 세그먼트를 기준으로 청구됩니다. 세그먼트 수 계산에 대한 자세한 내용은 리치 메시지 청구 로직을 참고하세요.

리치 미디어 메시지 (P2A)

업로드된 파일 (이미지, 동영상, 오디오)이 포함된 메시지는 리치 미디어 메시지로 분류됩니다.

청구 로직: 단일 정액제 이벤트로 청구됩니다. 세분화가 적용되지 않습니다.

추천 작업 클릭수

사용자가 추천 작업을 탭하면 추천 작업 클릭이라는 청구 가능한 이벤트가 하나 생성됩니다. (추천 조치에는 메시지 페이로드의 포스트백 데이터 식별자가 포함될 수 있습니다.)

청구 로직: 클릭당 청구 가능한 이벤트 하나를 생성합니다.

특수한 경우: 위치 공유

위치 공유는 두 개의 별도 P2A 청구 가능 이벤트를 생성한다는 점에서 고유합니다.

  • 추천 작업 클릭: 사용자가 위치 공유 추천 작업을 탭하면 추천 작업 클릭 이벤트가 하나 생성됩니다.

  • 위치 메시지: 사용자가 지도 인터페이스에서 위치를 선택하면 위치 좌표가 포함된 메시지가 상담사에게 전송됩니다. 이 MO 메시지는 세그먼트 수가 1인 리치 메시지 이벤트를 생성합니다.

P2A 웹훅 응답 예시

이 예시에서는 사용자 시작 이벤트에 대해 에이전트로 전송된 웹훅의 richMessageClassification 필드를 보여줍니다.

사용자가 보낸 RICH_MESSAGE의 웹훅 예시

{
  "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
  }
}

사용자가 보낸 RICH_MEDIA_MESSAGE의 웹훅 예시

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "userFile": "...",
  "payload": "...",
  "richMessageClassification": {
    "classificationType": "RICH_MEDIA_MESSAGE"
  }
}

SUGGESTED_ACTION_CLICK의 웹훅 예시

{
    "agentId": "...",
    "senderPhoneNumber": "...",
    "messageId": "...",
    "sendTime": "...",
    "suggestionResponse": {
        "text": "Click here",
        "postbackData": "...",
        "type": "ACTION"
    },
    "richMessageClassification": {
        "classificationType": "SUGGESTED_ACTION_CLICK"
    }
}

위치 메시지의 웹훅 예

위치 공유 흐름의 두 번째 청구 가능 이벤트로, 사용자가 지도에서 위치를 공유한 후 전송됩니다.

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

기술 및 구현 참고사항

  • 세그먼트는 청구 목적으로만 사용됨: 긴 메시지는 사용자의 기기에 단일 단위로 전송됩니다. 세그먼트 수는 청구 목적으로 가상으로 계산되며, 메시지가 사용자에게 전송되거나 표시되는 방식에는 영향을 미치지 않습니다.
  • 자동 분류: 메시지 분류가 메시지 콘텐츠를 기반으로 완전히 자동으로 이루어지며 수동으로 재정의할 수 없습니다.
  • 출시: 2025년 7월 15일에 비즈니스용 RCS 플랫폼 전반에 미국 결제 모델이 사용 설정되었습니다. 이 날짜부터 Google의 보고 및 API 응답에 새 분류가 반영됩니다.