KakaoTalk Commerce Messages

KakaoTalk allows you to send Commerce Messages in a rich, native format to present product information. These kind of messages may include images, product information, text, and buttons. This functionality enables businesses to send interactive product offers (with buttons that link to product detail pages, purchase flows, or other targets) directly to users in chat.

It is possible to send a simple Commerce Message with a single card. You may also send a more complex Carousel Commerce Message with multiple cards and additional information.

In order to send a Commerce Message, use channel_specific_message feature of the Conversation API.

Simple Commerce Message

A simple Commerce Message contains a single card populated with product information.

Below is an example of how a simple Commerce Message may be rendered on a recipient's device:

Rendered Commerce Message

Below is an example of a simple Commerce Message payload:

Copy

Copied

{
  "app_id": "{{APP}}",
  "recipient": {
    "identified_by": {
      "channel_identities": [
        {
          "channel": "KAKAOTALK",
          "identity": "{{MSISDN}}"
        }
      ]
    }
  },
  "message": {
    "channel_specific_message": {
      "KAKAOTALK": {
        "message_type": "COMMERCE",
        "message": {
          "image": {
            "image_url": "https://example.com/product.png"
          },
          "commerce": {
            "title": "Offered product",
            "regular_price": 100,
            "discount_price": 75,
            "discount_fixed": 25
          },
          "additional_content": "Additional product information",
          "buttons": [
            {
              "name": "Buy now",
              "type": "WL",
              "link_mo": "https://example.com/buy-product"
            }
          ],
          "coupon": {
            "type": "PERCENTAGE_DISCOUNT_COUPON",
            "description": "50% discount",
            "discount_rate": 50,
            "link_mo": "https://example.com/discount-from-phone",
            "link_pc": "https://example.com/discount-from-desktop"
          }
        }
      }
    }
  }
}

Carousel Commerce Message

A Carousel Commerce Message contains multiple cards populated with product information. You may also include an optional introduction and a "More" button at the end of this type of message.

Below is an example of how a Carousel Commerce Message may be rendered on a recipient's device (note that the actualy message will be scrollable):

Rendered Carousel Commerce Message Introduction

Below is an example of a Carousel Commerce Message payload:

Copy

Copied

{
  "app_id": "{{APP}}",
  "recipient": {
    "identified_by": {
      "channel_identities": [
        {
          "channel": "KAKAOTALK",
          "identity": "{{MSISDN}}"
        }
      ]
    }
  },
  "message": {
    "channel_specific_message": {
      "KAKAOTALK": {
        "message_type": "CAROUSEL_COMMERCE",
        "message": {
          "carousel": {
            "head": {
              "header": "Introduction",
              "content": "Some description",
              "image_url": "https://example.com/carousel-introduction.png",
              "link_mo": "https://example.com/carousel-introduction"
            },
            "list": [
              {
                "image_url": "https://example.com/product-1.png",
                "commerce": {
                  "title": "Product 1",
                  "regular_price": 100
                },
                "buttons": [
                  {
                    "name": "Buy now",
                    "type": "WL",
                    "link_mo": "https://example.com/buy-product-1"
                  }
                ],
                "coupon": {
                  "type": "PERCENTAGE_DISCOUNT_COUPON",
                  "description": "50% off",
                  "discount_rate": 50,
                  "link_mo": "https://example.com/discount-from-phone",
                  "link_pc": "https://example.com/discount-from-desktop"
                }
              },
              {
                "image_url": "https://example.com/product-2.png",
                "commerce": {
                  "title": "Product 2",
                  "regular_price": 100,
                  "discount_price": 75,
                  "discount_fixed": 25
                },
                "additional_content": "Additional product information",
                "buttons": [
                  {
                    "name": "Buy now",
                    "type": "WL",
                    "link_mo": "https://example.com/buy-product-2"
                  }
                ],
                "coupon": {
                  "type": "FIXED_DISCOUNT_COUPON",
                  "description": "50 won off",
                  "discount_fixed": 50,
                  "link_mo": "https://example.com/discount-from-phone",
                  "link_pc": "https://example.com/discount-from-desktop"
                }
              }
            ],
            "tail": {
              "link_mo": "https://example.com/more-information"
            }
          }
        }
      }
    }
  }
}