Skip to main content
GET
SMS 단건 조회

Authorizations

Authorization
string
header
required

워크스페이스 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.

Path Parameters

sms_id
string
required

조회할 SMS 메시지 ID입니다.

Response

성공 응답

v3 발신 SMS 리소스 페이로드입니다.

id
string
required

SMS 메시지의 고유 식별자입니다.

Pattern: ^[0-9a-f]{12}$
Example:

"a1b2c3d4e5f6"

from_number
string
required

발신 번호.

to_number
string
required

수신 번호.

message
string
required

수신자에게 발송된 메시지 본문.

message_type
enum<string>
required

확정된 메시지 유형 ('sms'/'lms'/'mms').

Available options:
sms,
lms,
mms
byte_count
integer
required

메시지 생성 시 계산해 저장한 바이트 수. 신규 발송은 EUC-KR 기준이며 기존 이력은 당시 저장값을 반환합니다.

Required range: x >= 0
Example:

33

status
enum<string>
required

발송 파이프라인 상태입니다. queued는 Wideshot 접수 후 내부 최종 결과를 기다리는 상태로 아직 청구하지 않습니다. sent는 내부 정책상 유효한 최종 resultCode=100으로 성공·과금 대상이 확정된 상태입니다. 실제 invoice 처리는 비동기이며 단말 수신이나 열람을 증명하지 않습니다. pending은 처리 중, failed는 명시적 최종 실패 또는 발송 실패, blocked는 콘텐츠 정책에 의한 거부, canceled는 배치에서 발송 시작 전에 취소된 상태, legacy는 발송 상태 추적 도입 이전의 과거 레코드입니다.

Available options:
pending,
queued,
sent,
failed,
blocked,
canceled,
legacy
created_at
integer
required

리소스 생성 시각입니다. unix milliseconds 형식입니다.

title
string | null

메시지 제목. 없으면 null.

image_urls
string[] | null

MMS 첨부의 이미지 URL. 텍스트 전용 발송이면 null.

call_id
string | null

귀속된 통화 UUID. 통화 중 에이전트의 send_sms 툴로 발송되었거나 발송 요청이 call_id를 지정한 경우 채워지며, 통화에 귀속되지 않으면 null.

chat_id
string | null

귀속된 채팅 UUID. SMS 채팅의 에이전트 답변이나 outbound 메시지로 발송된 경우 채워지며, 채팅에 귀속되지 않으면 null.

customer_id
string<uuid> | null

서버가 상대방 전화번호로 귀속한 고객 UUID입니다. 아직 고객 귀속이 완료되지 않았으면 null입니다.

metadata
Metadata · object | null

발신 SMS와 함께 보존된 클라이언트 메타데이터. 없으면 null.