콘텐츠로 이동

사용자 메시지 수신

Endpoint

[POST] API URL 정보

{고객사 수신 도메인}/message

{고객사 수신 도메인}/message

Introduce

Introduce 
수신 도메인에서 사용자 메시지와 관련된 정보를 전달받는 API입니다.

Request

None

Body

None

Example

REST API Sample 
None

None

Response (Json)

Parameter

Field Name Type Description
sender_key Text 메시지를 수신한 발신프로필 키
time Number 메시지 전달 상담톡 서버 시각 (실제 유저 입력 시각 아님)
serial_number Number 메시지 고유 id
type Text 사용자 전송 메시지 종류 (파일 종류, 파일 종류별 용량)
content Text 사용자 전송 메시지 내용
contents array 사용자 전송 데이터 배열 (url, comment)
attachment Text 4000자 초과 메시지의 경우 txt파일로 전달된 URL
extra Text BK/MD 버튼 클릭하여 전송한 메시지
session_id Text 세션 아이디

Example

Success 
{
    "user_key": exmaple-user_key,
    "session_id": 29153,
    "sender_key": example-sender_key,
    "time": 1720081199348,
    "serial_number": 3348262546089559600,
    "type": "text",
    "content": "안녕",
    "contents": [
        "안녕"
    ]
}

{
    "user_key": exmaple-user_key,
    "session_id": 29153,
    "sender_key": example-sender_key,
    "time": 1720081580534,
    "serial_number": 3348265743701100000,
    "type": "text",
    "content": "내용은 4000자까지 전달 생략...",
    "contents": [
        "내용은 4000자까지 전달 생략..."
    ],
    "attachment": {
        "url": "http://sandbox-dn.talk.kakao.com/talkm/bIcnbbqL2j6/kaEUzgFMAMKi4DnMUiDO2k/t_df280312a1b0.txt"
    }
}

{
    "user_key": exmaple-user_key,
    "session_id": 29153,
    "sender_key": example-sender_key,
    "time": 1720081305365,
    "serial_number": 3348263435407836700,
    "type": "photo",
    "content": {
        "url": "https://alpha-k.kakaocdn.net/dna/yeszd/bIcnbl1bFPT/ucR5LMwHNmFOivvyf2ETTZ/i_78e61b249f75.jpg?credential=Ng7s5IScBmZ8GXNU03QieO8KTiRHSUwg&expires=1721895705&signature=F9cNod4BZ8JkH4cLkeXpKrb0hOA%3D"
    },
    "contents": [
        {
            "url": "https://alpha-k.kakaocdn.net/dna/yeszd/bIcnbl1bFPT/ucR5LMwHNmFOivvyf2ETTZ/i_78e61b249f75.jpg?credential=Ng7s5IScBmZ8GXNU03QieO8KTiRHSUwg&expires=1721895705&signature=F9cNod4BZ8JkH4cLkeXpKrb0hOA%3D",
            "comment": ""
        },
        {
            "url": "https://alpha-k.kakaocdn.net/dna/cYRmGW/bIcnbjCjCLi/kmUh8SzRzDGqwX5lPBnlam/i_9a4f0db69cc0.jpg?credential=Ng7s5IScBmZ8GXNU03QieO8KTiRHSUwg&expires=1721895705&signature=H0H3XSQa5Z3Lv3m%2BDtnHfrotxgg%3D",
            "comment": ""
        }
    ]
}
Failure 
None

Data Dictionary

Data Dictionary

None

Value Description
Text 텍스트 메시지
photo 이미지 메시지
video 동영상 메시지
audio 오디오 메시지
file 일반 파일 메시지
Type Extensions
이미지 jpg, jpeg, gif, bmp, png, tiff
동영상 mp4, m4v, avi, asf, wmv, mkv, ts, mpg, mpeg, mov, flv, ogv
오디오 mp3, wav, flac, tta, tak, aac, wma, ogg, m4a
파일 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
Type Size Notes
이미지 Mobile: 15MB / PC: 300MB
동영상 300MB 직접 촬영 시 5분 제한
오디오 Mobile: 5분 / PC: 300MB
파일 300MB Mobile iOS는 미지원

Reference

코드 정의