Rich 메시지 발송

Endpoint

[POST] API URL 정보

개발 및 테스트용 API운영 API

https://patch-kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich

https://kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich

Introduce

사용자에게 캐러셀, 리스트 등 다양한 요소로 구성된 말풍선 메시지를 발송하는 API입니다.

Request (Json)

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

Body

Field Name	Type (Length)	Required	Description
user_key	Text(20)	Y	사용자 고유 키
sender_key	Text(40)	Y	발신 프로필 키
serial_number	Text(30)	Y	메시지 일련번호 (고유값)
chat_bubble_type	Text(20)	Y	말풍선 타입
message	Text(1000)	-	전달할 메시지 (TEXT, IMAGE, WIDE_IMAGE, ITEM_LIST)
description	Text	N	부가 메시지 (ITEM_LIST)
header	Text	N	헤더 (WIDE_ITEM_LIST, ITEM_LIST 타입 만 사용 가능)
attachment	Attachment	-	첨부 내용 (이미지, 버튼, 쿠폰 등)
carousel	Carousel	-	CAROUSEL_FEED 타입에서 필요
auto_answer	Text(2)	N	시스템 자동 응답 메시지 (TEXT 타입만)
lock	Boolean	N	보안 메시지 여부

Example

REST API Sample

개발 및 테스트용 API운영 API

TEXT 타입IMAGE 타입WIDE 타입ITEM_LIST 타입WIDE_ITEM_LIST 타입CAROUSEL_FEED 타입

WL, AL, BK, MD, BT 버튼 예시WL, AL, BF, PA 버튼 + 쿠폰 적용 예시바로 연결 버튼 예시 (WL, AL, BK, BT, BF)시스템 자동 응답 메시지 예시보안메시지 + 버튼 + 바로연결 + 쿠폰 예시

curl -L -X POST 'https://patch-kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich' \
  -H 'HT-Client-Id: example-id' \
  -H 'HT-Client-Secret: example-secret' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_key": "example-user_key",
    "sender_key": "example-sender_key",
    "serial_number": "abc111test",
    "chat_bubble_type": "TEXT",
    "message": "WL, AL, BK, MD, BT 버튼 예시",
    "attachment": {
      "buttons": [
        {
          "name": "WL 버튼 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "AL 버튼 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "BK 버튼 예시",
          "type": "BK",
          "extra": "BK 버튼을 통해 전달할 메시지"
        },
        {
          "name": "MD 버튼 예시",
          "type": "MD",
          "extra": "MD 버튼을 통해 발송 된 메시지"
        }
      ]
    }
  }'

curl -L -X POST 'https://patch-kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich' \
  -H 'HT-Client-Id: example-id' \
  -H 'HT-Client-Secret: example-secret' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_key": "example-user_key",
    "sender_key": "sender_key",
    "serial_number": "abc111test",
    "chat_bubble_type": "TEXT",
    "message": "WL, AL, BF, PA 버튼 + 쿠폰 적용 예시",
    "attachment": {
      "buttons": [
        {
          "name": "톡에서 설문하기",
          "type": "BF",
          "biz_form_key": "HqJeauP...ugR2h+8ug=="
        },
        {
          "name": "WL 버튼 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "AL 버튼 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "PA 버튼 예시",
          "type": "PA"
        }
      ],
      "coupon": {
        "title": "1000원 할인 쿠폰",
        "description": "소박한 할인쿠폰",
        "url_mobile": "https://www.happytalk.io",
        "url_pc": "https://www.happytalk.io"
      }
    }
  }'

curl -L -X POST 'https://patch-kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich' \
  -H 'HT-Client-Id: example-id' \
  -H 'HT-Client-Secret: example-secret' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_key": "example-user_key",
    "sender_key": "example-sender_key",
    "serial_number": "abc111test",
    "chat_bubble_type": "TEXT",
    "message": "바로 연결 버튼 예시 (WL, AL, BK, BT, BF)",
    "attachment": {
      "quick_replies": [
        {
          "name": "톡에서 예약하기",
          "type": "BF",
          "biz_form_key": "HqJeauP...ugR2h+8ug=="
        },
        {
          "name": "WL 바로 연결 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "AL 바로 연결 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "BK 바로 연결 예시",
          "type": "BK",
          "extra": "BK 바로 연결을 통해 전달할 메시지"
        },
        {
          "name": "BT 바로 연결 예시",
          "type": "BT",
          "chat_event": "시작하기"
        }
      ]
    }
  }'

curl -L -X POST 'https://patch-kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich' \
  -H 'HT-Client-Id: example-id' \
  -H 'HT-Client-Secret: example-secret' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_key": "example-user_key",
    "sender_key": "example-sender_key",
    "serial_number": "abc111test",
    "chat_bubble_type": "TEXT",
    "message": "시스템 자동 응답 메시지 예시",
    "auto_answer": "S1"
  }'

curl -L -X POST 'https://patch-kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich' \
  -H 'HT-Client-Id: example-id' \
  -H 'HT-Client-Secret: example-secret' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_key": "example-user_key",
    "sender_key": "example-sender_key",
    "serial_number": "abc111test",
    "chat_bubble_type": "TEXT",
    "message": "보안메시지 + 버튼 + 바로연결 + 쿠폰 예시",
    "attachment": {
      "buttons": [
        {
          "name": "WL 버튼 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        }
      ],
      "quick_replies": [
        {
          "name": "AL 바로 연결 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        }
      ],
      "coupon": {
        "title": "1000원 할인 쿠폰",
        "description": "소박한 할인쿠폰",
        "url_mobile": "https://www.happytalk.io",
        "url_pc": "https://www.happytalk.io"
      }
    },
    "lock": true
  }'

WL, AL 버튼 + 쿠폰바로 연결 버튼 예시 (WL, AL, BK)보안메시지 + 버튼 + 바로연결 + 쿠폰 예시

curl -L -X POST 'https://patch-kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich' \
  -H 'HT-Client-Id: example-id' \
  -H 'HT-Client-Secret: example-secret' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_key": "example-user_key",
    "sender_key": "example-sender_key",
    "serial_number": "abc111test",
    "chat_bubble_type": "IMAGE",
    "message": "WL, AL 버튼 + 쿠폰 적용 예시",
    "attachment": {
      "image": {
        "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
        "img_link": "https://www.happytalk.io"
      },
      "buttons": [
        {
          "name": "WL 버튼 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "AL 버튼 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        }
      ],
      "coupon": {
        "title": "1000원 할인 쿠폰",
        "description": "소박한 할인쿠폰",
        "url_mobile": "https://www.happytalk.io",
        "url_pc": "https://www.happytalk.io"
      }
    }
  }'

curl -L -X POST 'https://patch-kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich' \
  -H 'HT-Client-Id: example-id' \
  -H 'HT-Client-Secret: example-secret' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_key": "example-user_key",
    "sender_key": "example-sender_key",
    "serial_number": "abc111test",
    "chat_bubble_type": "IMAGE",
    "message": "바로 연결 버튼 예시 (WL, AL, BK)",
    "attachment": {
      "image": {
        "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
        "img_link": "https://www.happytalk.io"
      },
      "quick_replies": [
        {
          "name": "WL 바로 연결 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "AL 바로 연결 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "BK 바로 연결 예시",
          "type": "BK",
          "extra": "BK 바로 연결을 통해 전달할 메시지"
        }
      ]
    }
  }'

curl -L -X POST 'https://patch-kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich' \
  -H 'HT-Client-Id: example-id' \
  -H 'HT-Client-Secret: example-secret' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_key": "example-user_key",
    "sender_key": "example-sender_key",
    "serial_number": "abc111test",
    "chat_bubble_type": "IMAGE",
    "message": "보안메시지 + 버튼 + 바로연결 + 쿠폰 예시",
    "attachment": {
      "image": {
        "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
        "img_link": "https://www.happytalk.io"
      },
      "buttons": [
        {
          "name": "WL 버튼 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        }
      ],
      "quick_replies": [
        {
          "name": "AL 바로 연결 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        }
      ],
      "coupon": {
        "title": "1000원 할인 쿠폰",
        "description": "소박한 할인쿠폰",
        "url_mobile": "https://www.happytalk.io",
        "url_pc": "https://www.happytalk.io"
      }
    },
    "lock": true
  }'

WL, AL 버튼 + 쿠폰바로 연결 버튼 예시 (WL, AL, BK)보안메시지 + 버튼 + 바로연결 + 쿠폰 예시

curl -L -X POST 'https://patch-kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich' \
  -H 'HT-Client-Id: example-id' \
  -H 'HT-Client-Secret: example-secret' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_key": "example-user_key",
    "sender_key": "example-sender_key",
    "serial_number": "abc111test",
    "chat_bubble_type": "WIDE",
    "message": "WL, AL 버튼 + 쿠폰 적용 예시",
    "attachment": {
      "image": {
        "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
        "img_link": "https://www.happytalk.io"
      },
      "buttons": [
        {
          "name": "WL 버튼 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "AL 버튼 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        }
      ],
      "coupon": {
        "title": "1000원 할인 쿠폰",
        "description": "소박한 할인쿠폰",
        "url_mobile": "https://www.happytalk.io",
        "url_pc": "https://www.happytalk.io"
      }
    }
  }'

curl -L -X POST 'https://patch-kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich' \
  -H 'HT-Client-Id: example-id' \
  -H 'HT-Client-Secret: example-secret' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_key": "example-user_key",
    "sender_key": "example-sender_key",
    "serial_number": "abc111test",
    "chat_bubble_type": "WIDE",
    "message": "바로 연결 버튼 예시 (WL, AL, BK)",
    "attachment": {
      "image": {
        "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
        "img_link": "https://www.happytalk.io"
      },
      "quick_replies": [
        {
          "name": "WL 바로 연결 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "AL 바로 연결 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "BK 바로 연결 예시",
          "type": "BK",
          "extra": "BK 바로 연결을 통해 전달할 메시지"
        }
      ]
    }
  }'

curl -L -X POST 'https://patch-kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich' \
  -H 'HT-Client-Id: example-id' \
  -H 'HT-Client-Secret: example-secret' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_key": "example-user_key",
    "sender_key": "example-sender_key",
    "serial_number": "abc111test",
    "chat_bubble_type": "WIDE",
    "message": "보안메시지 + 버튼 + 바로연결 + 쿠폰 예시",
    "attachment": {
      "image": {
        "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
        "img_link": "https://www.happytalk.io"
      },
      "buttons": [
        {
          "name": "WL 버튼 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        }
      ],
      "quick_replies": [
        {
          "name": "AL 바로 연결 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        }
      ],
      "coupon": {
        "title": "1000원 할인 쿠폰",
        "description": "소박한 할인쿠폰",
        "url_mobile": "https://daum.net",
        "url_pc": "https://kakao.com"
      }
    },
    "lock": true
  }'

하이라이트 + 써머리 + 이미지 + 버튼 + 쿠폰

curl -L -X POST 'https://patch-kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich' \
  -H 'HT-Client-Id: example-id' \
  -H 'HT-Client-Secret: example-secret' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_key": "example-user_key",
    "sender_key": "example-sender_key",
    "serial_number": "abc111test",
    "chat_bubble_type": "ITEM_LIST",
    "message": "하이라이트 + 써머리 + 이미지 + 버튼 + 쿠폰",
    "description": "추가 설명",
    "header": "헤더 예시",
    "attachment": {
      "image": {
        "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
        "img_link": "https://www.happytalk.io"
      },
      "item": {
        "highlight": {
          "title": "하이라이트 내용",
          "description": "하이라이트 추가설명",
          "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg"
        },
        "list": [
          {
            "title": "제목 1",
            "description": "아이템 추가 설명 1",
            "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
            "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
            "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
            "url_pc": "https://www.happytalk.io",
            "url_mobile": "https://www.happytalk.io"
          },
          {
            "title": "제목 2",
            "description": "아이템 추가 설명 2",
            "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
            "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
            "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
            "url_pc": "https://www.happytalk.io",
            "url_mobile": "https://www.happytalk.io"
          },
          {
            "title": "제목 3",
            "description": "아이템 추가 설명 3",
            "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
            "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
            "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
            "url_pc": "https://www.happytalk.io",
            "url_mobile": "https://www.happytalk.io"
          }
        ],
        "summary": {
          "title": "요약 제목",
          "description": "아이템 요약 추가 설명"
        }
      },
      "buttons": [
        {
          "name": "WL 버튼 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "AL 버튼 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        }
      ],
      "coupon": {
        "title": "1000원 할인 쿠폰",
        "description": "소박한 할인쿠폰",
        "url_mobile": "https://www.happytalk.io",
        "url_pc": "https://www.happytalk.io"
      },
      "quick_replies": [
        {
          "name": "WL 바로 연결 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "AL 바로 연결 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "BK 바로 연결 예시",
          "type": "BK",
          "extra": "BK 바로 연결을 통해 전달할 메시지"
        }
      ]
    }
  }'

아이템 + 버튼 + 쿠폰

curl -L -X POST 'https://patch-kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich' \
  -H 'HT-Client-Id: example-id' \
  -H 'HT-Client-Secret: example-secret' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_key": "example-user_key",
    "sender_key": "example-sender_key",
    "serial_number": "abc111test",
    "chat_bubble_type": "WIDE_ITEM_LIST",
    "message": "아이템 + 버튼 + 쿠폰",
    "header": "헤더 예시",
    "attachment": {
      "item": {
        "list": [
          {
            "title": "아이템 제목 1",
            "description": "아이템 추가 설명 1",
            "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
            "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
            "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
            "url_pc": "https://www.happytalk.io",
            "url_mobile": "https://www.happytalk.io"
          },
          {
            "title": "아이템 제목 2",
            "description": "아이템 추가 설명 2",
            "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
            "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
            "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
            "url_pc": "https://www.happytalk.io",
            "url_mobile": "https://www.happytalk.io"
          },
          {
            "title": "아이템 제목 3",
            "description": "아이템 추가 설명 3",
            "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
            "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
            "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
            "url_pc": "https://www.happytalk.io",
            "url_mobile": "https://www.happytalk.io"
          }
        ]
      },
      "buttons": [
        {
          "name": "WL 버튼 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "AL 버튼 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        }
      ],
      "coupon": {
        "title": "1000원 할인 쿠폰",
        "description": "소박한 할인쿠폰",
        "url_mobile": "https://www.happytalk.io",
        "url_pc": "https://www.happytalk.io"
      },
      "quick_replies": [
        {
          "name": "WL 바로 연결 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "AL 바로 연결 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "BK 바로 연결 예시",
          "type": "BK",
          "extra": "BK 바로 연결을 통해 전달할 메시지"
        }
      ]
    }
  }'

케러셀 + 버튼 + 바로 연결 + 쿠폰

curl -L -X POST 'https://patch-kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich' \
  -H 'HT-Client-Id: example-id' \
  -H 'HT-Client-Secret: example-secret' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_key": "example-user_key",
    "sender_key": "example-sender_key",
    "serial_number": "abc111test",
    "chat_bubble_type": "CAROUSEL_FEED",
    "message": "케러셀",
    "header": "헤더 예시",
    "carousel": {
      "list": [
        {
          "header": "케러셀 1",
          "message": "케러셀 메시지 1",
          "attachment": {
            "image": {
              "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
              "img_link": "https://www.happytalk.io"
            },
            "buttons": [
              {
                "name": "WL 버튼 예시",
                "type": "WL",
                "url_pc": "https://www.happytalk.io",
                "url_mobile": "https://www.happytalk.io"
              },
              {
                "name": "AL 버튼 예시",
                "type": "AL",
                "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
                "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
                "url_pc": "https://www.happytalk.io",
                "url_mobile": "https://www.happytalk.io"
              }
            ],
            "coupon": {
              "title": "1000원 할인 쿠폰",
              "description": "소박한 할인쿠폰",
              "url_mobile": "https://www.happytalk.io",
              "url_pc": "https://www.happytalk.io"
            },
            "quick_replies": [
              {
                "name": "WL 바로 연결 예시",
                "type": "WL",
                "url_pc": "https://www.happytalk.io",
                "url_mobile": "https://www.happytalk.io"
              },
              {
                "name": "AL 바로 연결 예시",
                "type": "AL",
                "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
                "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
                "url_pc": "https://www.happytalk.io",
                "url_mobile": "https://www.happytalk.io"
              },
              {
                "name": "BK 바로 연결 예시",
                "type": "BK",
                "extra": "BK 바로 연결을 통해 전달할 메시지"
              }
            ]
          }
        },
        {
          "header": "케러셀 2",
          "message": "케러셀 메시지 2",
          "attachment": {
            "image": {
              "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
              "img_link": "https://www.happytalk.io"
            },
            "buttons": [
              {
                "name": "WL 버튼 예시",
                "type": "WL",
                "url_pc": "https://www.happytalk.io",
                "url_mobile": "https://www.happytalk.io"
              },
              {
                "name": "AL 버튼 예시",
                "type": "AL",
                "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
                "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
                "url_pc": "https://www.happytalk.io",
                "url_mobile": "https://www.happytalk.io"
              }
            ],
            "coupon": {
              "title": "1000원 할인 쿠폰",
              "description": "소박한 할인쿠폰",
              "url_mobile": "https://www.happytalk.io",
              "url_pc": "https://www.happytalk.io"
            },
            "quick_replies": [
              {
                "name": "WL 바로 연결 예시",
                "type": "WL",
                "url_pc": "https://www.happytalk.io",
                "url_mobile": "https://www.happytalk.io"
              },
              {
                "name": "AL 바로 연결 예시",
                "type": "AL",
                "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
                "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
                "url_pc": "https://www.happytalk.io",
                "url_mobile": "https://www.happytalk.io"
              },
              {
                "name": "BK 바로 연결 예시",
                "type": "BK",
                "extra": "BK 바로 연결을 통해 전달할 메시지"
              }
            ]
          }
        }
      ],
      "tail": {
        "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
        "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
        "url_pc": "https://www.happytalk.io",
        "url_mobile": "https://www.happytalk.io"
      }
    },
    "attachment": {
      "quick_replies": [
        {
          "name": "WL 바로 연결 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "AL 바로 연결 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "BK 바로 연결 예시",
          "type": "BK",
          "extra": "BK 바로 연결을 통해 전달할 메시지"
        }
      ]
    }
  }'

TEXT 타입IMAGE 타입WIDE 타입ITEM_LIST 타입WIDE_ITEM_LIST 타입CAROUSEL_FEED 타입

WL, AL, BK, MD, BT 버튼 예시WL, AL, BF, PA 버튼 + 쿠폰 적용 예시바로 연결 버튼 예시 (WL, AL, BK, BT, BF)시스템 자동 응답 메시지 예시보안메시지 + 버튼 + 바로연결 + 쿠폰 예시

curl -L -X POST 'https://kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich' \
  -H 'HT-Client-Id: example-id' \
  -H 'HT-Client-Secret: example-secret' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_key": "example-user_key",
    "sender_key": "example-sender_key",
    "serial_number": "abc111test",
    "chat_bubble_type": "TEXT",
    "message": "WL, AL, BK, MD, BT 버튼 예시",
    "attachment": {
      "buttons": [
        {
          "name": "WL 버튼 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "AL 버튼 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "BK 버튼 예시",
          "type": "BK",
          "extra": "BK 버튼을 통해 전달할 메시지"
        },
        {
          "name": "MD 버튼 예시",
          "type": "MD",
          "extra": "MD 버튼을 통해 발송 된 메시지"
        }
      ]
    }
  }'

curl -L -X POST 'https://kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich' \
  -H 'HT-Client-Id: example-id' \
  -H 'HT-Client-Secret: example-secret' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_key": "example-user_key",
    "sender_key": "sender_key",
    "serial_number": "abc111test",
    "chat_bubble_type": "TEXT",
    "message": "WL, AL, BF, PA 버튼 + 쿠폰 적용 예시",
    "attachment": {
      "buttons": [
        {
          "name": "톡에서 설문하기",
          "type": "BF",
          "biz_form_key": "HqJeauP...ugR2h+8ug=="
        },
        {
          "name": "WL 버튼 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "AL 버튼 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "PA 버튼 예시",
          "type": "PA"
        }
      ],
      "coupon": {
        "title": "1000원 할인 쿠폰",
        "description": "소박한 할인쿠폰",
        "url_mobile": "https://www.happytalk.io",
        "url_pc": "https://www.happytalk.io"
      }
    }
  }'

curl -L -X POST 'https://kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich' \
  -H 'HT-Client-Id: example-id' \
  -H 'HT-Client-Secret: example-secret' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_key": "example-user_key",
    "sender_key": "example-sender_key",
    "serial_number": "abc111test",
    "chat_bubble_type": "TEXT",
    "message": "바로 연결 버튼 예시 (WL, AL, BK, BT, BF)",
    "attachment": {
      "quick_replies": [
        {
          "name": "톡에서 예약하기",
          "type": "BF",
          "biz_form_key": "HqJeauP...ugR2h+8ug=="
        },
        {
          "name": "WL 바로 연결 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "AL 바로 연결 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "BK 바로 연결 예시",
          "type": "BK",
          "extra": "BK 바로 연결을 통해 전달할 메시지"
        },
        {
          "name": "BT 바로 연결 예시",
          "type": "BT",
          "chat_event": "시작하기"
        }
      ]
    }
  }'

curl -L -X POST 'https://kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich' \
  -H 'HT-Client-Id: example-id' \
  -H 'HT-Client-Secret: example-secret' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_key": "example-user_key",
    "sender_key": "example-sender_key",
    "serial_number": "abc111test",
    "chat_bubble_type": "TEXT",
    "message": "시스템 자동 응답 메시지 예시",
    "auto_answer": "S1"
  }'

curl -L -X POST 'https://kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich' \
  -H 'HT-Client-Id: example-id' \
  -H 'HT-Client-Secret: example-secret' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_key": "example-user_key",
    "sender_key": "example-sender_key",
    "serial_number": "abc111test",
    "chat_bubble_type": "TEXT",
    "message": "보안메시지 + 버튼 + 바로연결 + 쿠폰 예시",
    "attachment": {
      "buttons": [
        {
          "name": "WL 버튼 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        }
      ],
      "quick_replies": [
        {
          "name": "AL 바로 연결 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        }
      ],
      "coupon": {
        "title": "1000원 할인 쿠폰",
        "description": "소박한 할인쿠폰",
        "url_mobile": "https://www.happytalk.io",
        "url_pc": "https://www.happytalk.io"
      }
    },
    "lock": true
  }'

WL, AL 버튼 + 쿠폰바로 연결 버튼 예시 (WL, AL, BK)보안메시지 + 버튼 + 바로연결 + 쿠폰 예시

curl -L -X POST 'https://kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich' \
  -H 'HT-Client-Id: example-id' \
  -H 'HT-Client-Secret: example-secret' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_key": "example-user_key",
    "sender_key": "example-sender_key",
    "serial_number": "abc111test",
    "chat_bubble_type": "IMAGE",
    "message": "WL, AL 버튼 + 쿠폰 적용 예시",
    "attachment": {
      "image": {
        "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
        "img_link": "https://www.happytalk.io"
      },
      "buttons": [
        {
          "name": "WL 버튼 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "AL 버튼 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        }
      ],
      "coupon": {
        "title": "1000원 할인 쿠폰",
        "description": "소박한 할인쿠폰",
        "url_mobile": "https://www.happytalk.io",
        "url_pc": "https://www.happytalk.io"
      }
    }
  }'

curl -L -X POST 'https://kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich' \
  -H 'HT-Client-Id: example-id' \
  -H 'HT-Client-Secret: example-secret' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_key": "example-user_key",
    "sender_key": "example-sender_key",
    "serial_number": "abc111test",
    "chat_bubble_type": "IMAGE",
    "message": "바로 연결 버튼 예시 (WL, AL, BK)",
    "attachment": {
      "image": {
        "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
        "img_link": "https://www.happytalk.io"
      },
      "quick_replies": [
        {
          "name": "WL 바로 연결 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "AL 바로 연결 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "BK 바로 연결 예시",
          "type": "BK",
          "extra": "BK 바로 연결을 통해 전달할 메시지"
        }
      ]
    }
  }'

curl -L -X POST 'https://kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich' \
  -H 'HT-Client-Id: example-id' \
  -H 'HT-Client-Secret: example-secret' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_key": "example-user_key",
    "sender_key": "example-sender_key",
    "serial_number": "abc111test",
    "chat_bubble_type": "IMAGE",
    "message": "보안메시지 + 버튼 + 바로연결 + 쿠폰 예시",
    "attachment": {
      "image": {
        "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
        "img_link": "https://www.happytalk.io"
      },
      "buttons": [
        {
          "name": "WL 버튼 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        }
      ],
      "quick_replies": [
        {
          "name": "AL 바로 연결 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        }
      ],
      "coupon": {
        "title": "1000원 할인 쿠폰",
        "description": "소박한 할인쿠폰",
        "url_mobile": "https://www.happytalk.io",
        "url_pc": "https://www.happytalk.io"
      }
    },
    "lock": true
  }'

WL, AL 버튼 + 쿠폰바로 연결 버튼 예시 (WL, AL, BK)보안메시지 + 버튼 + 바로연결 + 쿠폰 예시

curl -L -X POST 'https://kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich' \
  -H 'HT-Client-Id: example-id' \
  -H 'HT-Client-Secret: example-secret' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_key": "example-user_key",
    "sender_key": "example-sender_key",
    "serial_number": "abc111test",
    "chat_bubble_type": "WIDE",
    "message": "WL, AL 버튼 + 쿠폰 적용 예시",
    "attachment": {
      "image": {
        "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
        "img_link": "https://www.happytalk.io"
      },
      "buttons": [
        {
          "name": "WL 버튼 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "AL 버튼 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        }
      ],
      "coupon": {
        "title": "1000원 할인 쿠폰",
        "description": "소박한 할인쿠폰",
        "url_mobile": "https://www.happytalk.io",
        "url_pc": "https://www.happytalk.io"
      }
    }
  }'

curl -L -X POST 'https://kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich' \
  -H 'HT-Client-Id: example-id' \
  -H 'HT-Client-Secret: example-secret' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_key": "example-user_key",
    "sender_key": "example-sender_key",
    "serial_number": "abc111test",
    "chat_bubble_type": "WIDE",
    "message": "바로 연결 버튼 예시 (WL, AL, BK)",
    "attachment": {
      "image": {
        "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
        "img_link": "https://www.happytalk.io"
      },
      "quick_replies": [
        {
          "name": "WL 바로 연결 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "AL 바로 연결 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "BK 바로 연결 예시",
          "type": "BK",
          "extra": "BK 바로 연결을 통해 전달할 메시지"
        }
      ]
    }
  }'

curl -L -X POST 'https://kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich' \
  -H 'HT-Client-Id: example-id' \
  -H 'HT-Client-Secret: example-secret' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_key": "example-user_key",
    "sender_key": "example-sender_key",
    "serial_number": "abc111test",
    "chat_bubble_type": "WIDE",
    "message": "보안메시지 + 버튼 + 바로연결 + 쿠폰 예시",
    "attachment": {
      "image": {
        "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
        "img_link": "https://www.happytalk.io"
      },
      "buttons": [
        {
          "name": "WL 버튼 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        }
      ],
      "quick_replies": [
        {
          "name": "AL 바로 연결 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        }
      ],
      "coupon": {
        "title": "1000원 할인 쿠폰",
        "description": "소박한 할인쿠폰",
        "url_mobile": "https://daum.net",
        "url_pc": "https://kakao.com"
      }
    },
    "lock": true
  }'

하이라이트 + 써머리 + 이미지 + 버튼 + 쿠폰

curl -L -X POST 'https://kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich' \
  -H 'HT-Client-Id: example-id' \
  -H 'HT-Client-Secret: example-secret' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_key": "example-user_key",
    "sender_key": "example-sender_key",
    "serial_number": "abc111test",
    "chat_bubble_type": "ITEM_LIST",
    "message": "하이라이트 + 써머리 + 이미지 + 버튼 + 쿠폰",
    "description": "추가 설명",
    "header": "헤더 예시",
    "attachment": {
      "image": {
        "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
        "img_link": "https://www.happytalk.io"
      },
      "item": {
        "highlight": {
          "title": "하이라이트 내용",
          "description": "하이라이트 추가설명",
          "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg"
        },
        "list": [
          {
            "title": "제목 1",
            "description": "아이템 추가 설명 1",
            "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
            "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
            "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
            "url_pc": "https://www.happytalk.io",
            "url_mobile": "https://www.happytalk.io"
          },
          {
            "title": "제목 2",
            "description": "아이템 추가 설명 2",
            "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
            "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
            "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
            "url_pc": "https://www.happytalk.io",
            "url_mobile": "https://www.happytalk.io"
          },
          {
            "title": "제목 3",
            "description": "아이템 추가 설명 3",
            "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
            "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
            "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
            "url_pc": "https://www.happytalk.io",
            "url_mobile": "https://www.happytalk.io"
          }
        ],
        "summary": {
          "title": "요약 제목",
          "description": "아이템 요약 추가 설명"
        }
      },
      "buttons": [
        {
          "name": "WL 버튼 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "AL 버튼 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        }
      ],
      "coupon": {
        "title": "1000원 할인 쿠폰",
        "description": "소박한 할인쿠폰",
        "url_mobile": "https://www.happytalk.io",
        "url_pc": "https://www.happytalk.io"
      },
      "quick_replies": [
        {
          "name": "WL 바로 연결 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "AL 바로 연결 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "BK 바로 연결 예시",
          "type": "BK",
          "extra": "BK 바로 연결을 통해 전달할 메시지"
        }
      ]
    }
  }'

아이템 + 버튼 + 쿠폰

curl -L -X POST 'https://kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich' \
  -H 'HT-Client-Id: example-id' \
  -H 'HT-Client-Secret: example-secret' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_key": "example-user_key",
    "sender_key": "example-sender_key",
    "serial_number": "abc111test",
    "chat_bubble_type": "WIDE_ITEM_LIST",
    "message": "아이템 + 버튼 + 쿠폰",
    "header": "헤더 예시",
    "attachment": {
      "item": {
        "list": [
          {
            "title": "아이템 제목 1",
            "description": "아이템 추가 설명 1",
            "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
            "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
            "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
            "url_pc": "https://www.happytalk.io",
            "url_mobile": "https://www.happytalk.io"
          },
          {
            "title": "아이템 제목 2",
            "description": "아이템 추가 설명 2",
            "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
            "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
            "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
            "url_pc": "https://www.happytalk.io",
            "url_mobile": "https://www.happytalk.io"
          },
          {
            "title": "아이템 제목 3",
            "description": "아이템 추가 설명 3",
            "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
            "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
            "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
            "url_pc": "https://www.happytalk.io",
            "url_mobile": "https://www.happytalk.io"
          }
        ]
      },
      "buttons": [
        {
          "name": "WL 버튼 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "AL 버튼 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        }
      ],
      "coupon": {
        "title": "1000원 할인 쿠폰",
        "description": "소박한 할인쿠폰",
        "url_mobile": "https://www.happytalk.io",
        "url_pc": "https://www.happytalk.io"
      },
      "quick_replies": [
        {
          "name": "WL 바로 연결 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "AL 바로 연결 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "BK 바로 연결 예시",
          "type": "BK",
          "extra": "BK 바로 연결을 통해 전달할 메시지"
        }
      ]
    }
  }'

케러셀 + 버튼 + 바로 연결 + 쿠폰

curl -L -X POST 'https://kakao-api.happytalk.io/kakaoWebhook/v3/bzc/chat/send/rich' \
  -H 'HT-Client-Id: example-id' \
  -H 'HT-Client-Secret: example-secret' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_key": "example-user_key",
    "sender_key": "example-sender_key",
    "serial_number": "abc111test",
    "chat_bubble_type": "CAROUSEL_FEED",
    "message": "케러셀",
    "header": "헤더 예시",
    "carousel": {
      "list": [
        {
          "header": "케러셀 1",
          "message": "케러셀 메시지 1",
          "attachment": {
            "image": {
              "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
              "img_link": "https://www.happytalk.io"
            },
            "buttons": [
              {
                "name": "WL 버튼 예시",
                "type": "WL",
                "url_pc": "https://www.happytalk.io",
                "url_mobile": "https://www.happytalk.io"
              },
              {
                "name": "AL 버튼 예시",
                "type": "AL",
                "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
                "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
                "url_pc": "https://www.happytalk.io",
                "url_mobile": "https://www.happytalk.io"
              }
            ],
            "coupon": {
              "title": "1000원 할인 쿠폰",
              "description": "소박한 할인쿠폰",
              "url_mobile": "https://www.happytalk.io",
              "url_pc": "https://www.happytalk.io"
            },
            "quick_replies": [
              {
                "name": "WL 바로 연결 예시",
                "type": "WL",
                "url_pc": "https://www.happytalk.io",
                "url_mobile": "https://www.happytalk.io"
              },
              {
                "name": "AL 바로 연결 예시",
                "type": "AL",
                "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
                "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
                "url_pc": "https://www.happytalk.io",
                "url_mobile": "https://www.happytalk.io"
              },
              {
                "name": "BK 바로 연결 예시",
                "type": "BK",
                "extra": "BK 바로 연결을 통해 전달할 메시지"
              }
            ]
          }
        },
        {
          "header": "케러셀 2",
          "message": "케러셀 메시지 2",
          "attachment": {
            "image": {
              "img_url": "http://mud-kage.kakao.com/dn/bR...V/bt...cxZ6a/KqvAL....NCf5i30/img_l.jpg",
              "img_link": "https://www.happytalk.io"
            },
            "buttons": [
              {
                "name": "WL 버튼 예시",
                "type": "WL",
                "url_pc": "https://www.happytalk.io",
                "url_mobile": "https://www.happytalk.io"
              },
              {
                "name": "AL 버튼 예시",
                "type": "AL",
                "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
                "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
                "url_pc": "https://www.happytalk.io",
                "url_mobile": "https://www.happytalk.io"
              }
            ],
            "coupon": {
              "title": "1000원 할인 쿠폰",
              "description": "소박한 할인쿠폰",
              "url_mobile": "https://www.happytalk.io",
              "url_pc": "https://www.happytalk.io"
            },
            "quick_replies": [
              {
                "name": "WL 바로 연결 예시",
                "type": "WL",
                "url_pc": "https://www.happytalk.io",
                "url_mobile": "https://www.happytalk.io"
              },
              {
                "name": "AL 바로 연결 예시",
                "type": "AL",
                "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
                "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
                "url_pc": "https://www.happytalk.io",
                "url_mobile": "https://www.happytalk.io"
              },
              {
                "name": "BK 바로 연결 예시",
                "type": "BK",
                "extra": "BK 바로 연결을 통해 전달할 메시지"
              }
            ]
          }
        }
      ],
      "tail": {
        "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
        "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
        "url_pc": "https://www.happytalk.io",
        "url_mobile": "https://www.happytalk.io"
      }
    },
    "attachment": {
      "quick_replies": [
        {
          "name": "WL 바로 연결 예시",
          "type": "WL",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "AL 바로 연결 예시",
          "type": "AL",
          "scheme_android": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "scheme_ios": "naversearchapp://inappbrowser?url=https://www.happytalk.io",
          "url_pc": "https://www.happytalk.io",
          "url_mobile": "https://www.happytalk.io"
        },
        {
          "name": "BK 바로 연결 예시",
          "type": "BK",
          "extra": "BK 바로 연결을 통해 전달할 메시지"
        }
      ]
    }
  }'

Response (Json)

Parameter

Field Name	Type	Description
code	Text	결과 코드 (0은 정상 / 나머지는 오류)
message	Text	처리 실패 시 결과 메시지
created_at	Text	메시지 발송 후 카카오 DB에 저장된 시각

Example

Success

{
    "code": 0,
    "created_at": "2025-05-09T13:58:20.707"
}

Failure

{
    "code": -510,
    "message": "NoImageException(serialNumber: test-serial-number)"
}

Data Dictionary

Request DictionaryResponse Dictionary

chat_bubble_typeattachmentbuttonsbuttons typeimageitemcouponcarouselcarousel attachmentquick_repliesQuickRepliy type

Type	Description
TEXT	텍스트
IMAGE	이미지
WIDE	와이드 이미지
ITEM_LIST	아이템 리스트
WIDE_ITEM_LIST	와이드 아이템 리스트
CAROUSEL_FEED	캐러셀 피드

Field Name	Type	Required	Description
image	Image	-	이미지 요소 이미지 필드 필수 타입 - IMAGE - WIDE (가로:세로 비율 2:1이상, 1:1이하)
buttons	Button[]	N	버튼 목록 - TEXT, IMAGE, ITEM_LIST Coupon을 적용할 경우 최대 4개, 그 외 최대 5개) - WIDE, WIDE_ITEM_LIST, CAROUSEL_FEED 최대 2개
quick_replies	QuickReply[]	N	바로연결 목록 (최대 10개)
coupon	Coupon	N	쿠폰 요소 (메세지 최하단 노출)
item	Item	-	아이템 리스트 요소 이미지 필드 필수 타입 - WIDE_ITEM_LIST

주의사항

- 버튼 제목은 28자까지 발송 가능하지만, 말풍선 타입 또는 사용자 디바이스 환경에 따라 말줄임 되어 보여질 수 있습니다.

Name	Type	Description	Required
name	Text(28)	버튼 제목	Y
type	Text(2)	버튼 타입별 필수 파라미터를 모두 입력해야 메시지 발송 가능	Y
scheme_android	Text(1000)	MOBILE Android 환경에서 클릭 시 실행할 application custom scheme	-
scheme_ios	Text(1000)	MOBILE iOS 환경에서 클릭 시 실행할 application custom scheme	-
url_mobile	Text(1000)	MOBILE 환경에서 클릭 시 이동할 URL	-
url_pc	Text(1000)	PC 환경에서 클릭 시 이동할 URL	N
url_target	Text	외부브라우저로 열려면 'out' 입력	N
extra	Text	상담톡<->카카오톡 챗봇 전환 시 전달할 메타정보 BK, MD 버튼 발송 시 전달할 extra 정보	N
chat_event	Text	카카오톡 챗봇 전환 시 연결할 카카오톡 챗봇 이벤트명	N
start_type	Text	상담 시작 타입	N
biz_form_key	Text	비즈니스폼 업로드 API를 통해 발급받은 bizFormKey	-

Type	Description	Available Parameters	Required Parameters
WL	지정한 웹 링크로 이동 (http 또는 https만 입력 가능)	url_mobile url_pc url_target	url_mobile
AL	지정한 앱 스킴 또는 웹 링크로 이동	scheme_android scheme_ios url_mobile url_pc	다음 중 2가지 이상 scheme_android scheme_ios url_mobile
BK	해당 버튼 텍스트 발송	extra
MD	해당 버튼 텍스트 + 메시지 본문 발송	extra
BT	상담톡에서 봇상담으로 전환 (상담톡 세션 종료) * 상담톡 세션 종료하고, 봇 이벤트 호출	extra chat_event
BF	카카오 비즈니스폼을 실행 강조형 버튼(노란색)으로 표기되며, 첫번째 버튼에 위치 name은 다음 중 사용 가능 - 톡에서 예약하기 - 톡에서 설문하기 - 톡에서 응모하기	biz_form_key	biz_form_key
PA	채널 추가 버튼 강조형 버튼(노란색)으로 표기

Field Name	Type	Required	Description
img_url	Text	Y	이미지 업로드 API로 등록한 이미지 URL
img_link	Text(1000)	N	이미지 클릭시 이동할 URL

ITEM_LIST 타입에서 사용되는 타입WIDE_ITEM_LIST 타입에서 사용되는 타입

주의사항

하이라이트는 이미지가 존재할 시 title: 21자 description: 13자, 이미지가 없을 시 title: 30자, description: 19자까지 입력 가능

Name	Type	Description	Required
highlight	Json	아이템 하이라이트	-
└ title	Text	하이라이트 내용 이미지 유무에 따라 21자~30자 (줄바꿈: 최대 1개)	Y
└ description	Text	하이라이트 추가설명 이미지 유무에 따라 13자~19자	N
└ img_url	Text	하이라이트 이미지 1:1 비율만 발송 허용	N
list	Json[]	아이템 리스트 (최소:2, 최대:10)	-
└ title	Text(6)	아이템 제목	Y
└ description	Text(23)	아이템 추가설명 최대 23자 (줄바꿈: 최대 1개)	Y
summary	Json	아이템 요약정보	N
└ title	Text(6)	요약정보 제목	Y
└ description	Text(14)	요약정보 추가설명	Y

주의사항

1번째 아이템은 title 필수 아님. 2~4번째 아이템은 title 필수 입력

Name	Type	Description	Required
list	Json[]	와이드 리스트 (최소:3, 최대:4)	Y
└ title	Text	아이템 제목 1번째 아이템 - 최대 25자 (줄바꿈: 최대 1개) 2~4번째 아이템 - 최대 30자 (줄바꿈: 최대 1개)	-
└ img_url	Text	아이템 이미지 URL 2~4번째 아이템 이미지는 1:1 비율만 발송 허용	Y
└ scheme_android	Text(1000)	MOBILE Android 환경에서 클릭 시 실행할 application custom scheme	N
└ scheme_ios	Text(1000)	MOBILE iOS 환경에서 클릭 시 실행할 application custom scheme	N
└ url_mobile	Text(1000)	MOBILE 환경에서 클릭 시 이동할 URL	Y
└ url_pc	Text(1000)	PC 환경에서 클릭 시 이동할 URL	N

주의사항

- 채널 쿠폰 URL(포맷: alimtalk=coupon://) 사용시 scheme_android, scheme_ios 중 하나 필수 입력
- 채널 쿠폰 URL이 아닌 기본 쿠폰 사용시 url_mobile 필수 입력

Name	Type	Description	Required
title	Text	쿠폰 제목 사용 가능한 쿠폰 제목 - ${숫자}원 할인 쿠폰 (숫자: 1 ~ 99,999,999) - ${숫자}% 할인 쿠폰 (숫자: 1 ~ 100) - 배송비 할인 쿠폰 - ${7자 이내} 무료 쿠폰 - ${7자 이내} UP 쿠폰	Y
description	Text	쿠폰 설명 - WIDE, WIDE_ITEM_LIST - 최대 18자 (줄바꿈: 불가) - 그 외 최대 12자 (줄바꿈: 불가)	Y
url_pc	Text(1000)	PC 환경에서 클릭 시 이동할 URL	N
url_mobile	Text(1000)	MOBILE 환경에서 클릭 시 이동할 URL	-
scheme_android	Text(1000)	MOBILE Android 환경에서 클릭 시 실행할 application custom scheme	-
scheme_ios	Text(1000)	MOBILE iOS 환경에서 클릭 시 실행할 application custom scheme	-

Name	Type	Description	Required
list	Json[]	캐러셀 리스트 • 2~6개	Y
└ header	Text(20)	캐러셀 리스트 헤더 • 최대 20자 (줄바꿈: 불가)	Y
└ message	Text(180)	캐러셀 리스트 메시지 • 최대 180자 (줄바꿈: 최대 2개)	Y
└ attachment	Attachment	캐러셀 아이템 이미지, 버튼 정보	Y
tail	Json	더보기 버튼	N
└ url_pc	Text(1000)	PC 환경에서 클릭 시 이동할 URL	N
└ url_mobile	Text(1000)	MOBILE 환경에서 클릭 시 이동할 URL	Y
└ scheme_ios	Text(1000)	MOBILE iOS 환경에서 클릭 시 실행할 application custom scheme	N
└ scheme_android	Text(1000)	MOBILE Android 환경에서 클릭 시 실행할 application custom scheme	N

Name	Type	Description	Required
buttons	Button[]	캐러셀 리스트 버튼 목록 최소 1개, 최대 2개	-
image	Image	캐러셀 이미지	Y
coupon	Coupon	캐러셀 리스트 쿠폰 캐러셀 리스트 최하단 노출	N

Name	Type	Description	Required
name	Text(14)	바로연결 제목	Y
type	Text(2)	바로연결 타입	Y
scheme_android	Text(300)	mobile android 환경에서 바로연결 클릭 시 실행할 application custom scheme	-
scheme_ios	Text(300)	mobile ios 환경에서 바로연결 클릭 시 실행할 application custom scheme	-
url_mobile	Text(300)	mobile 환경에서 바로연결 클릭 시 이동할 url (http 또는 https만 입력 가능)	-
url_pc	Text(300)	pc 환경에서 바로연결 클릭 시 이동할 url (http 또는 https만 입력 가능)	-
url_target	Text	외부브라우저로 열려면 'out' 입력	-
extra	Text(100)	BK 버튼 발송 시, 상담톡<->카카오톡 챗봇 전환 시 전달할 메타정보	-
chat_event	Text(50)	봇 전환 시 연결할 봇 이벤트명	-

Type	Description	Available Parameters	Required Parameters
WL	지정한 웹 링크로 이동 (http 또는 https만 입력 가능)	url_mobile url_pc url_target	url_mobile
AL	지정한 앱 스킴 또는 웹 링크로 이동	scheme_android scheme_ios url_mobile url_pc	다음 중 2가지 이상 필수 입력 scheme_android scheme_ios url_mobile
BK	해당 버튼 텍스트 발송	extra	-
BT	카카오 I 오픈빌더의 챗봇을 사용하는 카카오톡 채널만 이용가능	extra chat_event	-
BF	비즈니스폼 버튼 사용을 위한 비즈니스폼 키를 비즈니스폼 업로드 API를 이용해 발급	biz_form_key	biz_form_key

None

Reference

코드 정의

Rich 메시지 발송

Endpoint

Introduce

Request (Json)

Header

Body

Example

Response (Json)

Parameter

Example

Data Dictionary

Reference