메시지 전송

Endpoint

[POST] API URL 정보

개발 및 테스트용 API운영 API

https://patch-kakao-api.happytalk.io/v1/chat/write

https://kakao-api.happytalk.io/v1/chat/write

Description

본 API는 상담 메시지 수신 으로 받은 데이터를 사용하여 동작하는 API입니다.

Request (Json)

Field Name	Type	Required	Description
Content-type	String	Y	application/json
HT-Client-Id	String	Y	고객센터에서 발급 받은 key
HT-Client-Secret	String	Y	고객센터에서 발급 받은 token

Body

Field Name	Type (Length)	Required	Description	Default
user_key	String (20)	Y	수신한 사용자 키
sender_key	String (40)	Y	발신프로필 키
serial_number	String (30)	Y	메시지 고유키
message_type	String (2)	Y	메시지 타입	TX
message	String (1000)	Y / N	메시지 내용 (message_type이 TX 혹은 LI인 경우 필수)
image_url	String (1000)	Y / N	사용자에게 전달될 이미지 url (message_type이 IM인 경우 필수) / 이미지 업로드 API 문서
file_url	String (1000)	Y / N	사용자에게 전달될 파일 url (message_type이 FI인 경우 필수) / 파일 업로드 API 문서
file_name	String (1000)	Y / N	사용자에게 전달될 파일 이름 (message_type이 FI인 경우 필수) / 파일 업로드 API 문서
file_size	Int	Y / N	사용자에게 전달될 파일 용량 (message_type이 FI인 경우 필수) / 파일 업로드 API 문서
auto_answer	String (2)	N	카카오 시스템 자동 응답 메시지 (message_type이 LI 일시에 동작)
links	Json	N	링크타입 (message_type이 LI 일시에 동작)
supplement	Json	N	메시지에 첨부할 바로연결 (링크 버튼 / "target":"out" 속성 추가시 아웃링크) 최대 10개까지 발송가능 (message_type이 LI 일시에 동작)

이미지 또는 파일 발송시 필독

카카오 상담톡 API 사용시 이미지 혹은 파일은 카카오 서버에 저장되어있는 파일만 발송이 가능합니다.
따라서 이미지 업로드 API 혹은 파일 업로드 API 를 사용하여 업로드 후 반환된 URL을 입력해야합니다.

비즈니스폼 발송시 필독

자세한 발송 방법은 Example에 있는 예시를 참고해주세요.

비즈니스폼은 발송전 비즈폼 업로드 API를 통해 업로드 후 반환 받은 키로 메시지를 발송할 수 있습니다.
비즈니스폼은 타입별(links, supplement)로 한개씩만 발송이 가능합니다.
비즈니스폼을 links로 발송시 links 버튼은 맨 앞에 작성해야 합니다.
비즈니스폼 메시지 발송시 아래 3가지 메시지로만 발송 가능 합니다.
- 톡에서 설문하기
- 톡에서 예약하기
- 톡에서 응모하기

Example

REST API Sample

개발 및 테스트용 API운영 API

텍스트 발신파일 발신이미지 발신시스템 메시지 발송링크 타입 이미지 발신링크 타입 & 바로 연결 링크 비즈폼 발송버튼 타입_WL버튼 타입_AL버튼 타입_BK버튼 타입_BT버튼 타입_MD

curl --location --request POST 'https://patch-kakao-api.happytalk.io/v1/chat/write' \
--header 'Content-Type: application/json' \
--header 'HT-Client-Id: 고객센터에서 발급받은 client-id' \
--header 'HT-Client-Secret: 고객센터에서 발급받은 client-secret' \
--data-raw '{
  "user_key" : "수신한 사용자 키",
  "sender_key" : "발신프로필 키",
  "serial_number" : "2795231627445909",
  "message_type" : "TX"
  "message" : "테스트 메시지"
}'

curl --location --request POST 'https://patch-kakao-api.happytalk.io/v1/chat/write' \
--header 'Content-Type: application/json' \
--header 'HT-Client-Id: 고객센터에서 발급받은 client-id' \
--header 'HT-Client-Secret: 고객센터에서 발급받은 client-secret' \
--data-raw '{
  "user_key" : "수신한 사용자 키",
  "sender_key" : "발신프로필 키",
  "serial_number" : "2795231627445909",
  "message_type" : "FI",
  "file_url" : "http://mud-kage.kakao.com/dn/bbGruP/o5hvtiosDD/MlcaKClOizgcnKEAU2Hyn1/f_3ry0vx.pdf",
  "file_name" : "test.pdf",
  "file_size" : 102628
}'

curl --location --request POST 'https://patch-kakao-api.happytalk.io/v1/chat/write' \
--header 'Content-Type: application/json' \
--header 'HT-Client-Id: 고객센터에서 발급받은 client-id' \
--header 'HT-Client-Secret: 고객센터에서 발급받은 client-secret' \
--data-raw '{
  "user_key" : "수신한 사용자 키",
  "sender_key" : "발신프로필 키",
  "serial_number" : "2795231627445909",
  "message_type" : "IM"
  "image_url" : "http://dn-m.talk.kakao.com/talkm/oZad6wXSNr/K7pHowkajkRPm2P49Nmk8k/i_436i1c.jpg"
}'

curl --location --request POST 'https://patch-kakao-api.happytalk.io/v1/chat/write' \
--header 'Content-Type: application/json' \
--header 'HT-Client-Id: 고객센터에서 발급받은 client-id' \
--header 'HT-Client-Secret: 고객센터에서 발급받은 client-secret' \
--data-raw '{
  "user_key" : "수신한 사용자 키",
  "sender_key" : "발신프로필 키",
  "serial_number" : "2795231627445909",
  "message_type" : "LI",
  "message" : "링크 타입 시스템 메시지 발송 테스트",
  "auto_answer" : "S1",
  "links" : [
    {
      "name" : "버튼 텍스트 전송",
      "type" : "BK"
    }
  ]
}'

curl --location --request POST 'https://patch-kakao-api.happytalk.io/v1/chat/write' \
--header 'Content-Type: application/json' \
--header 'HT-Client-Id: 고객센터에서 발급받은 client-id' \
--header 'HT-Client-Secret: 고객센터에서 발급받은 client-secret' \
--data-raw '{
  "user_key" : "수신한 사용자 키",
  "sender_key" : "발신프로필 키",
  "serial_number" : "2795231627445909",
  "message_type" : "LI",
  "message" : "링크 타입 이미지 발신 테스트 메시지",
  "image_url" : "http://mud-kage.kakao.com/dn/z0m0I/btrDZIgBl9i/NyhCpYIblzszwUk0riPhcK/img_l.jpg",
  "links" : [
    {
      "name" : "버튼 텍스트 전송",
      "type" : "BK"
    }
  ]
}'

curl --location --request POST 'https://patch-kakao-api.happytalk.io/v1/chat/write' \
--header 'Content-Type: application/json' \
--header 'HT-Client-Id: 고객센터에서 발급받은 client-id' \
--header 'HT-Client-Secret: 고객센터에서 발급받은 client-secret' \
--data-raw '{
  "user_key" : "수신한 사용자 키",
  "sender_key" : "발신프로필 키",
    "serial_number" : "lclclc_test_15",
    "message_type" : "LI",
    "message" : "비즈폼 테스트 메시지",
    "links" : [
      { 
        "name" : "톡에서 예약하기", 
        "type" : "BF",
        "biz_form_key" : "XyLJ***********bCA=="
      }
   ]
}'
curl --location --request POST 'https://patch-kakao-api.happytalk.io/v1/chat/write' \
--header 'Content-Type: application/json' \
--header 'HT-Client-Id: 고객센터에서 발급받은 client-id' \
--header 'HT-Client-Secret: 고객센터에서 발급받은 client-secret' \
--data-raw '{
  "user_key" : "수신한 사용자 키",
  "sender_key" : "발신프로필 키",
  "serial_number" : "2795231627445909",
  "message_type" : "LI",
  "message" : "bizform test",
  "links" : [
    { 
      "name" : "톡에서 예약하기", 
      "type" : "BF",
      "biz_form_key" : "XyLJ***********bCA=="
    },
    {
      "name" : "버튼명",
      "type" : "WL",
      "url_pc" : "https://happytalk.io",
      "url_mobile" : "https://ars.happytalk.io",
      "target" : "out"
    }
 ],
 "supplement" : {
      "quick_reply" : [
          {
              "name" : "버튼명",
              "type" : "WL",
              "url_pc" : "https://happytalk.io",
              "url_mobile" : "https://ars.happytalk.io",
              "target" : "out"
          },
          { 
              "name" : "톡에서 응모하기", 
              "type" : "BF",
              "biz_form_key" : "XyLJ***********bCA=="
          }
      ]
    }
}'

curl --location --request POST 'https://patch-kakao-api.happytalk.io/v1/chat/write' \
--header 'Content-Type: application/json' \
--header 'HT-Client-Id: 고객센터에서 발급받은 client-id' \
--header 'HT-Client-Secret: 고객센터에서 발급받은 client-secret' \
--data-raw '{
  "user_key" : "수신한 사용자 키",
  "sender_key" : "발신프로필 키",
  "serial_number" : "2795231627445909",
  "message_type" : "LI",
  "message" : "버튼 테스트 메시지",
  "links" : [
    { 
      "name" : "URL 이동 버튼",
      "type" : "WL", 
      "url_mobile" : "https://happytalk.io", 
      "url_pc" : "https://ars.happytalk.io"
    }
  ]
}'

curl --location --request POST 'https://patch-kakao-api.happytalk.io/v1/chat/write' \
--header 'Content-Type: application/json' \
--header 'HT-Client-Id: 고객센터에서 발급받은 client-id' \
--header 'HT-Client-Secret: 고객센터에서 발급받은 client-secret' \
--data-raw '{
  // 네이버 앱 열기 예시 (모바일에 네이버 앱이 설치되어야 합니다.)
  "user_key" : "수신한 사용자 키",
  "sender_key" : "발신프로필 키",
  "serial_number" : "2795231627445909",
  "message_type" : "LI",
  "message" : "버튼 테스트 메시지",
  "links" : [
    { 
      "name" : "스키마 값과 URL 이동 버튼", 
      "type" : "AL",
      "scheme_android" : "naversearchapp://default?version=5",
      "scheme_ios" : "naversearchapp://default?version=1"
    } 
  ]
}'

curl --location --request POST 'https://patch-kakao-api.happytalk.io/v1/chat/write' \
--header 'Content-Type: application/json' \
--header 'HT-Client-Id: 고객센터에서 발급받은 client-id' \
--header 'HT-Client-Secret: 고객센터에서 발급받은 client-secret' \
--data-raw '{
  "user_key" : "수신한 사용자 키",
  "sender_key" : "발신프로필 키",
  "serial_number" : "2795231627445909",
  "message_type" : "LI",
  "message" : "버튼 테스트 메시지",
  "links" : [
    { 
      "name" : "버튼 텍스트 전송",
      "type" : "BK"
    }
  ]
}'

curl --location --request POST 'https://patch-kakao-api.happytalk.io/v1/chat/write' \
--header 'Content-Type: application/json' \
--header 'HT-Client-Id: 고객센터에서 발급받은 client-id' \
--header 'HT-Client-Secret: 고객센터에서 발급받은 client-secret' \
--data-raw '{
  "user_key" : "수신한 사용자 키",
  "sender_key" : "발신프로필 키",
  "serial_number" : "2795231627445909",
  "message_type" : "LI",
  "message" : "버튼 테스트 메시지",
  "links" : [
    {
      "name" : "상담톡에서 봇상담 전환 버튼",
      "type" : "BT"
    } 
  ]
}'

curl --location --request POST 'https://patch-kakao-api.happytalk.io/v1/chat/write' \
--header 'Content-Type: application/json' \
--header 'HT-Client-Id: 고객센터에서 발급받은 client-id' \
--header 'HT-Client-Secret: 고객센터에서 발급받은 client-secret' \
--data-raw '{
  "user_key" : "수신한 사용자 키",
  "sender_key" : "발신프로필 키",
  "serial_number" : "2795231627445909",
  "message_type" : "LI",
  "message" : "버튼 테스트 메시지",
  "links" : [ 
    { 
      "name" : "메시지와 버튼 텍스트 전송",
      "type" : "MD"
    }
  ]
}'

텍스트 발신파일 발신이미지 발신시스템 메시지 발송링크 타입 이미지 발신링크 타입 & 바로 연결 링크 비즈폼 발송버튼 타입_WL버튼 타입_AL버튼 타입_BK버튼 타입_BT버튼 타입_MD

curl --location --request POST 'https://kakao-api.happytalk.io/v1/chat/write' \
--header 'Content-Type: application/json' \
--header 'HT-Client-Id: 고객센터에서 발급받은 client-id' \
--header 'HT-Client-Secret: 고객센터에서 발급받은 client-secret' \
--data-raw '{
  "user_key" : "수신한 사용자 키",
  "sender_key" : "발신프로필 키",
  "serial_number" : "2795231627445909",
  "message_type" : "TX"
  "message" : "테스트 메시지"
}'

curl --location --request POST 'https://kakao-api.happytalk.io/v1/chat/write' \
--header 'Content-Type: application/json' \
--header 'HT-Client-Id: 고객센터에서 발급받은 client-id' \
--header 'HT-Client-Secret: 고객센터에서 발급받은 client-secret' \
--data-raw '{
  "user_key" : "수신한 사용자 키",
  "sender_key" : "발신프로필 키",
  "serial_number" : "2795231627445909",
  "message_type" : "FI",
  "file_url" : "http://mud-kage.kakao.com/dn/bbGruP/o5hvtiosDD/MlcaKClOizgcnKEAU2Hyn1/f_3ry0vx.pdf",
  "file_name" : "test.pdf",
  "file_size" : 102628
}'

curl --location --request POST 'https://kakao-api.happytalk.io/v1/chat/write' \
--header 'Content-Type: application/json' \
--header 'HT-Client-Id: 고객센터에서 발급받은 client-id' \
--header 'HT-Client-Secret: 고객센터에서 발급받은 client-secret' \
--data-raw '{
  "user_key" : "수신한 사용자 키",
  "sender_key" : "발신프로필 키",
  "serial_number" : "2795231627445909",
  "message_type" : "IM"
  "image_url" : "http://dn-m.talk.kakao.com/talkm/oZad6wXSNr/K7pHowkajkRPm2P49Nmk8k/i_436i1c.jpg",
}'

curl --location --request POST 'https://kakao-api.happytalk.io/v1/chat/write' \
--header 'Content-Type: application/json' \
--header 'HT-Client-Id: 고객센터에서 발급받은 client-id' \
--header 'HT-Client-Secret: 고객센터에서 발급받은 client-secret' \
--data-raw '{
  "user_key" : "수신한 사용자 키",
  "sender_key" : "발신프로필 키",
  "serial_number" : "2795231627445909",
  "message_type" : "LI",
  "message" : "링크 타입 시스템 메시지 발송 테스트",
  "auto_answer" : "S1",
  "links" : [
    {
      "name" : "버튼 텍스트 전송",
      "type" : "BK"
    }
  ]
}'

curl --location --request POST 'https://kakao-api.happytalk.io/v1/chat/write' \
--header 'Content-Type: application/json' \
--header 'HT-Client-Id: 고객센터에서 발급받은 client-id' \
--header 'HT-Client-Secret: 고객센터에서 발급받은 client-secret' \
--data-raw '{
  "user_key" : "수신한 사용자 키",
  "sender_key" : "발신프로필 키",
  "serial_number" : "2795231627445909",
  "message_type" : "LI",
  "message" : "링크 타입 이미지 발신 테스트 메시지",
  "image_url" : "http://mud-kage.kakao.com/dn/z0m0I/btrDZIgBl9i/NyhCpYIblzszwUk0riPhcK/img_l.jpg",
  "links" : [
    {
      "name" : "버튼 텍스트 전송",
      "type" : "BK"
    }
  ]
}'

curl --location --request POST 'https://patch-kakao-api.happytalk.io/v1/chat/write' \
--header 'Content-Type: application/json' \
--header 'HT-Client-Id: 고객센터에서 발급받은 client-id' \
--header 'HT-Client-Secret: 고객센터에서 발급받은 client-secret' \
--data-raw '{
  "user_key" : "수신한 사용자 키",
  "sender_key" : "발신프로필 키",
    "serial_number" : "lclclc_test_15",
    "message_type" : "LI",
    "message" : "비즈폼 테스트 메시지",
    "links" : [
      { 
        "name" : "톡에서 예약하기", 
        "type" : "BF",
        "biz_form_key" : "XyLJ***********bCA=="
      }
   ]
}'
curl --location --request POST 'https://patch-kakao-api.happytalk.io/v1/chat/write' \
--header 'Content-Type: application/json' \
--header 'HT-Client-Id: 고객센터에서 발급받은 client-id' \
--header 'HT-Client-Secret: 고객센터에서 발급받은 client-secret' \
--data-raw '{
  "user_key" : "수신한 사용자 키",
  "sender_key" : "발신프로필 키",
  "serial_number" : "2795231627445909",
  "message_type" : "LI",
  "message" : "bizform test",
  "links" : [
    { 
      "name" : "톡에서 예약하기", 
      "type" : "BF",
      "biz_form_key" : "XyLJ***********bCA=="
    },
    {
      "name" : "버튼명",
      "type" : "WL",
      "url_pc" : "https://happytalk.io",
      "url_mobile" : "https://ars.happytalk.io",
      "target" : "out"
    }
 ],
 "supplement" : {
      "quick_reply" : [
          {
              "name" : "버튼명",
              "type" : "WL",
              "url_pc" : "https://happytalk.io",
              "url_mobile" : "https://ars.happytalk.io",
              "target" : "out"
          },
          { 
              "name" : "톡에서 응모하기", 
              "type" : "BF",
              "biz_form_key" : "XyLJ***********bCA=="
          }
      ]
    }
}'

curl --location --request POST 'https://kakao-api.happytalk.io/v1/chat/write' \
--header 'Content-Type: application/json' \
--header 'HT-Client-Id: 고객센터에서 발급받은 client-id' \
--header 'HT-Client-Secret: 고객센터에서 발급받은 client-secret' \
--data-raw '{
  "user_key" : "수신한 사용자 키",
  "sender_key" : "발신프로필 키",
  "serial_number" : "2795231627445909",
  "message_type" : "LI",
  "message" : "버튼 테스트 메시지",
  "links" : [
    { 
      "name" : "URL 이동 버튼",
      "type" : "WL", 
      "url_mobile" : "https://happytalk.io", 
      "url_pc" : "https://ars.happytalk.io"
    }
  ]
}'

curl --location --request POST 'https://kakao-api.happytalk.io/v1/chat/write' \
--header 'Content-Type: application/json' \
--header 'HT-Client-Id: 고객센터에서 발급받은 client-id' \
--header 'HT-Client-Secret: 고객센터에서 발급받은 client-secret' \
--data-raw '{
  // 네이버 앱 열기 예시 (모바일에 네이버 앱이 설치되어야 합니다.)
  "user_key" : "수신한 사용자 키",
  "sender_key" : "발신프로필 키",
  "serial_number" : "2795231627445909",
  "message_type" : "LI",
  "message" : "버튼 테스트 메시지",
  "links" : [
    { 
      "name" : "스키마 값과 URL 이동 버튼", 
      "type" : "AL",
      "scheme_android" : "naversearchapp://default?version=5",
      "scheme_ios" : "naversearchapp://default?version=1"
    } 
  ]
}'

curl --location --request POST 'https://kakao-api.happytalk.io/v1/chat/write' \
--header 'Content-Type: application/json' \
--header 'HT-Client-Id: 고객센터에서 발급받은 client-id' \
--header 'HT-Client-Secret: 고객센터에서 발급받은 client-secret' \
--data-raw '{
  "user_key" : "수신한 사용자 키",
  "sender_key" : "발신프로필 키",
  "serial_number" : "2795231627445909",
  "message_type" : "LI",
  "message" : "버튼 테스트 메시지",
  "links" : [
    { 
      "name" : "버튼 텍스트 전송",
      "type" : "BK"
    }
  ]
}'

curl --location --request POST 'https://kakao-api.happytalk.io/v1/chat/write' \
--header 'Content-Type: application/json' \
--header 'HT-Client-Id: 고객센터에서 발급받은 client-id' \
--header 'HT-Client-Secret: 고객센터에서 발급받은 client-secret' \
--data-raw '{
  "user_key" : "수신한 사용자 키",
  "sender_key" : "발신프로필 키",
  "serial_number" : "2795231627445909",
  "message_type" : "LI",
  "message" : "버튼 테스트 메시지",
  "links" : [
    {
      "name" : "상담톡에서 봇상담 전환 버튼",
      "type" : "BT"
    } 
  ]
}'

curl --location --request POST 'https://kakao-api.happytalk.io/v1/chat/write' \
--header 'Content-Type: application/json' \
--header 'HT-Client-Id: 고객센터에서 발급받은 client-id' \
--header 'HT-Client-Secret: 고객센터에서 발급받은 client-secret' \
--data-raw '{
  "user_key" : "수신한 사용자 키",
  "sender_key" : "발신프로필 키",
  "serial_number" : "2795231627445909",
  "message_type" : "LI",
  "message" : "버튼 테스트 메시지",
  "links" : [ 
    { 
      "name" : "메시지와 버튼 텍스트 전송",
      "type" : "MD"
    }
  ]
}'

Response (Json)

Parameter

Field Name	Type	Description
code	Int	결과 코드
createdAt	String	메시지 발송 일시

Example

Success

{
  "code": 0,
  "createdAt": "2022-06-07T11:56:54.461"
}

Failure

Fail Code 정보

Data Dictionary

Request DictionaryResponse Dictionary

message_typeauto_answerlinkssupplementlinks_button_typequick_reply_type

Type	Description
TX	텍스트
FI	파일
IM	이미지
LI	링크타입버튼

Type	Description
S1	상담불가
S2	상담부재
S3	무응답 상담종료
S4	상담대기

Key	Type	Required	Description
name	text(28)	Y	버튼 명칭
type	text(2)	Y	버튼 타입
scheme_android	text	N	mobile android 환경에서 버튼 클릭 시 실행할 application custom scheme
scheme_ios	text	N	mobile ios 환경에서 버튼 클릭 시 실행할 application custom scheme
url_mobile	text	Y / N	mobile 환경에서 버튼 클릭 시 이동할 url (type이 WL 혹은 BK 일시에 필수)
url_pc	text	Y / N	pc 환경에서 버튼 클릭 시 이동할 url (type이 WL 혹은 BK 일시에 필수)
extra	text(100)	N	BK, MD 버튼 발송 시 전달할 extra 정보
event	text(100)	N	상담톡에서 봇 상담으로 전환시 호출할 봇 이벤트명 (type이 BT 일시에 사용)
biz_form_key	text	N	비즈니스폼 버튼 사용을 위해 필요한 비즈니스폼키 <비즈니스폼 업로드> 를 통해 발급

키		타입	필수 여부	설명
quick_reply		array	-	바로연결 목록
	type	text(2)	Y	바로연결 타입
	scheme_android	text	-	mobile android 환경에서 바로연결 클릭 시 실행할 application custom scheme
	scheme_ios	text	-	mobile ios 환경에서 바로연결 클릭 시 실행할 application custom scheme
	url_mobile	text	-	mobile 환경에서 바로연결 클릭 시 이동할 url
	url_pc	text	-	pc 환경에서 바로연결 클릭 시 이동할 url
	chat_extra	text(50)	-	상담톡/봇 전환 시 전달할 메타정보
	chat_event	text(50)	-	봇 전환 시 연결할 봇 이벤트명

버튼 타입	속성	타입	필수 여부	설명
WL	url_mobile	text	Y	mobile 환경에서 버튼 클릭 시 이동할 url (http 또는 https만 입력 가능)
WL	url_pc	text	N	pc 환경에서 버튼 클릭 시 이동할 url (http 또는 https만 입력 가능)
AL	scheme_android	text	-	scheme_ios, scheme_android, url_mobile 중 2가지 필수 입력 mobile android 환경에서 버튼 클릭 시 실행할 application custom scheme
	scheme_ios	text	-	mobile ios 환경에서 버튼 클릭 시 실행할 application custom scheme
	url_mobile	text	-	mobile 환경에서 버튼 클릭 시 이동할 url (http 또는 https만 입력 가능)
	url_pc	text	N	pc 환경에서 버튼 클릭 시 이동할 url (http 또는 https만 입력 가능)
BK	-	-	-	해당 버튼 텍스트 전송
MD	-	-	-	해당 버튼 텍스트 + 메시지 본문 전송
BT	event	text(100)	N	상담톡에서 봇상담으로 전환 (상담톡 세션 종료) * 상담톡 세션 종료하고, 봇 이벤트 호출
BF	biz_form_key	text	N	비즈니스폼 버튼 사용을 위해 필요한 비즈니스폼키 <비즈니스폼 업로드> 를 통해 발급

바로 연결 타입	속성	타입	필수 여부	설명
WL	url_mobile	text	Y	mobile 환경에서 버튼 클릭 시 이동할 url (http 또는 https만 입력 가능)
WL	url_pc	text	N	pc 환경에서 버튼 클릭 시 이동할 url (http 또는 https만 입력 가능)
AL	scheme_android	text	-	scheme_ios, scheme_android, url_mobile 중 2가지 필수 입력 mobile android 환경에서 버튼 클릭 시 실행할 application custom scheme
	scheme_ios	text	-	mobile ios 환경에서 버튼 클릭 시 실행할 application custom scheme
	url_mobile	text	-	mobile 환경에서 버튼 클릭 시 이동할 url (http 또는 https만 입력 가능)
	url_pc	text	N	pc 환경에서 버튼 클릭 시 이동할 url (http 또는 https만 입력 가능)
BK	-	-	-	해당 버튼 텍스트 전송
BK	chat_extra	text	N	상담톡 전환 시 전달할 메타정보
BT	-	-	-	카카오 I 오픈빌더의 챗봇을 사용하는 카카오톡 채널만 이용가능
	chat_extra	text	N	봇 전환 시 전달할 메타정보
	chat_event	text	N	봇 전환 시 연결할 봇 이벤트명
BF	biz_form_key	text	N	비즈니스폼 버튼 사용을 위해 필요한 비즈니스폼키 <비즈니스폼 업로드> 를 통해 발급

None

메시지 전송

Endpoint

Description

Request (Json)

Header

Body

Example

Response (Json)

Parameter

Example

Data Dictionary