콘텐츠로 이동

상담 메시지 수신

Endpoint

해당 API는 카카오에서 고객사 수신도메인으로 Direct로 발송되는 API 입니다.

[POST] API URL 정보

None

설정된 수신도메인/message

Description

Description

해당 API는 카카오톡에서 발신된 API이며, 고객사에서 관리되는 커스텀한 메타 정보를 고객사 수신도메인으로 수신되는 API입니다.

Request (Json)

None

Body

None

Example

REST API Sample

None

Response (Json)

Parameter

Field Name Type Description
user_key String 메시지를 발송한 사용자의 고유 키
sender_key String 메시지를 수신한 발신프로필 키
session_id String 세션 아이디
time Int 메시지 전달 상담톡 서버 시각 (실제 유저가 입력한 시각은 아님)
serial_number Int 수신 메시지 고유 키
type String 수신 메시지 타입
content String 수신된 메시지 내용 (2023/07월 중 제거될 예정)
contents Array 수신된 메시지 리스트 (2023/05/08일 이후 적용 예정)
attachment String 1000자 초과시에 4000자까지 자른 메시지를 content 필드로 전달한 뒤 전체 메시지 파일 (1000자 미만이시에 나오지 않음)
extra String 사용자가 전송한 메시지의 extra 정보
- BK/MD 버튼을 클릭하여 전송한 메시지

Example

Success 
{
  "user_key": "MZjEVK4x18_V",
  "session_id": "12345678",
  "sender_key": "07c2c1b0661cfa374ccc8a9fa9fa2adac1fe89ca",
  "time": 1653985613535,
  "serial_number": 1689884130894833200,
  "type": "text",
  "content": "상담문의 드립니다.",
  "contents": [
    "상담문의 드립니다."
  ]
}

{
  "user_key": "MZjEVK4x18_V",
  "session_id": "162821231",
  "sender_key": "4c9591f37822ae1ed5b781582af08b1e2d922cea",
  "time": 1653986545306,
  "serial_number": 1689884130894833200,
  "type": "text",
  "content": "원본 content에서 4000자까지 자른 메시지",
  "contents": [
    "원본 content에서 4000자까지 자른 메시지"
  ],
  "attachment": {
    "url": "http://dn-m.talk.kakao.com/talkm/MZjEVK4x18_V/bB3svuU9oxTb0kJfCvvKr1/t_e70444142ffe.txt"
  }
}

{
  "user_key": "MZjEVK4x18_V",
  "session_id": "12345678",
  "sender_key": "07c2c1b0661cfa374ccc8a9fa9fa2adac1fe89ca",
  "time": 1653985613535,
  "serial_number": 1689884130894833200,
  "type": "photo",
  "content": {
    "url": "https://www.kakaocorp.com/page/favicon.ico"
  }
  "contents": [
    {
      "url": "https://www.kakaocorp.com/page/favicon.ico",
      "comment": "코멘트1"
    },
    {
      "url": "https://www.kakaocorp.com/page/favicon.ico",
      "comment": "코멘트2"
    }
  ]
}

{
  "user_key": "MZjEVK4x18_V",
  "session_id": "12345678",
  "sender_key": "07c2c1b0661cfa374ccc8a9fa9fa2adac1fe89ca",
  "time": 1653985613535,
  "serial_number": 1689884130894833200,
  "type": "file",
  "content": "카카오 서버에 업로드된 파일 URL",
  "contents": [
    "카카오 서버에 업로드된 파일 URL"
  ]
}
Failure

None

Data Dictionary

Data Dictionary

None

Type Filename extension Maximum Volume Description
text 문자
photo jpg, jpeg, gif, bmp, png, tiff, bmp Mobile: 15MB / PC: 300MB 사진
video mp4, m4v, avi, asf, wmv, mkv, ts, mpg, mpeg, mov, flv, ogv 300MB 동영상 (직접 촬영시 5분 제한)
audio mp3, wav, flac, tta, tak, aac, wma, ogg, m4a Mobile: 5분 / PC: 300MB 오디오
file pdf, odp, ppt, pptx, key, show, doc, docx, hwp, txt, rtf, xml, wks, wps, xps, md, odf, odt, pages, ods,
csv, tsv, xls, xlsx, numbers, cell, psd, ai, sketch, tif, tiff, tga, webp, zip, gz, bz2, rar, 7z, lzh, alz		 300MB 파일 (Mobile_iOS는 미지원)