> For the complete documentation index, see [llms.txt](https://biztech.gitbook.io/webapi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://biztech.gitbook.io/webapi/api/dispatch/kakao.md).

# 카카오톡 비즈메시지

### 알림톡 (AT/AI**)**

(AT: 알림톡, AI:이미지 알림톡)

<figure><img src="/files/ge39kPTnE0gBTi0IczXV" alt=""><figcaption></figcaption></figure>

### BUTTON

<figure><img src="/files/P4nimSlVRpKX5toWV1Mm" alt=""><figcaption></figcaption></figure>

**버튼 타입 별 속성 (\*type)**

<figure><img src="/files/BGPO5jAnn7Mley6oQPak" alt=""><figcaption></figcaption></figure>

### ITEM

<figure><img src="/files/OGtBfLoDGVEHJsg6p0yW" alt=""><figcaption></figcaption></figure>

### ITEMHIGHLIGHT

<figure><img src="/files/M5dZpWHxJxQMTGkny0zP" alt=""><figcaption></figcaption></figure>

### IMAGE

![](/files/nnSXX66RU0fY5kqaIPSb)

### QUICKREPLY

<figure><img src="/files/iXa2GPpJ3Rba7XMPpLYC" alt=""><figcaption></figcaption></figure>

**LINK**&#x20;

<figure><img src="/files/SAF9CB4Wnr7X24GVEf6s" alt=""><figcaption></figcaption></figure>

### 친구톡 (FT/FI/FW/FL/FC/FM/FP/FA)

(FT: 친구톡 , FI: 기본이미지  친구톡 , FW: 와이드이미지 친구톡, FL: 와이드 아이템 리스트 친구톡

FC: 캐러셀피드 친구톡,   FM: 커머스  친구톡, FP: 프리미엄 동영상 친구톡, FA: 캐러셀커머스   친구톡 )

<figure><img src="/files/xeMwRObxh4dKlEFg0GDd" alt=""><figcaption></figcaption></figure>

### BUTTON

<figure><img src="/files/p3wROLkZmip4XJl1ns08" alt=""><figcaption></figcaption></figure>

**버튼 타입별 속성 (\*type)**

<figure><img src="/files/Mz9ww5YrDvwqNSBwasHW" alt=""><figcaption></figcaption></figure>

### IMAGE

![](/files/nnSXX66RU0fY5kqaIPSb)

### ITEM

<figure><img src="/files/lPaoI1S9FNVY5QPDDpBv" alt=""><figcaption></figcaption></figure>

### COUPON

<figure><img src="/files/cgxDk6nOomW44h0d4kW4" alt=""><figcaption></figcaption></figure>

### CAROUSEL

<figure><img src="/files/z56R7mu0uQNKi8LlmlBY" alt=""><figcaption></figcaption></figure>

### COMMERCE

<figure><img src="/files/bAby2BztJB2CFUBDovZj" alt=""><figcaption></figcaption></figure>

### VIDEO

<figure><img src="/files/00yS4XwMbhDslN7NqalA" alt=""><figcaption></figcaption></figure>

### Examples

**알림톡**

<pre class="language-json5"><code class="lang-json5">{
  "account": "test",
  "refkey": "test1234",
  "type": "at",
  "from": "07000000000",
  "to": "01000000000",
  "content": {
    "at": {
      "senderkey": "12345",
      "templatecode": "template",
      "message<a data-footnote-ref href="#user-content-fn-1">"</a>: "알림톡 + 버튼(WL)",
      "button": [
        {
          "name": "웹 링크 버튼",
          "type": "WL",
          "url_pc": "http://www.bizppurio.com",
          "url_mobile": "http://www.bizppurio.com"
        }
      ]
    }
  }
}
</code></pre>

**알림톡 아이템 리스트형**

```json5
{
  "account": "test",
  "refkey": "test1234",
  "type": "at",
  "from": "07000000000",
  "to": "01000000000",
  "content": {
    "at": {
      "senderkey": "12345",
      "templatecode": "template",
      "message": "알림톡 아이템리스트 + 버튼(WL)",
      "header": "헤더 (최대 16자)",
      "button": [
        {
          "name": "웹 링크 버튼",
          "type": "WL",
          "url_pc": "http://www.bizppurio.com",
          "url_mobile": "http://www.bizppurio.com"
        }
      ],
      "item": {
        "list": [
          {
            "title": "타이틀",
            "description": "디스크립션"
          },
          {
            "title": "타이틀2",
            "description": "디스크립션2"
          }
        ],
        "summary": {
          "title": "요약 타이틀",
          "description": "$100,000원"
        }
      },
      "itemhighlight": {
        "title": "타이틀",
        "description": "디스크립션"
      }
    }
  }
}
```

**알림톡 이미지**

```json5
{
  "account": "test",
  "refkey": "test1234",
  "type": "ai",
  "from": "07000000000",
  "to": "01000000000",
  "content": {
    "ai": {
      "senderkey": "12345",
      "templatecode": "template",
      "message": "알림톡 이미지"
    }
  }
}
```

**알림톡 + 대표링크**

```json5
{
  "account": "test",
  "refkey": "test1234",
  "type": "at",
  "from": "07000000000",
  "to": "01000000000",
  "content": {
    "at": {
      "senderkey": "12345",
      "templatecode": "template",
      "message": "알림톡 이미지",
      "button": [
        {
          "name": "웹 링크 버튼",
          "type": "WL",
          "url_pc": "http://www.bizppurio.com",
          "url_mobile": "http://www.bizppurio.com"
        }
      ],
      "link": {
        "url_mobile": "https://www.bizppurio.com",
        "url_pc": "https://www.bizppurio.com"
      }
    }
  }
}
```

**친구톡 텍스트 + 버튼 + 쿠폰**

```json5
{
  "account": "test",
  "refkey": "test1234",
  "type": "ft",
  "from": "07000000000",
  "to": "01000000000",
  "content": {
    "ft": {
      "senderkey": "1234",
      "message": "친구톡 텍스트 + 버튼 + 쿠폰",
      "adflag": "Y",
      "coupon": {
        "title": "문자 발송 무료 쿠폰",
        "description": "비즈뿌리오",
        "url_mobile": "http://www.bizppurio.com"
      },
      "button": [
        {
          "name": "버튼 제목",
          "type": "WL",
          "url_pc": "http://www.bizppurio.com",
          "url_mobile": "http://www.bizppurio.com"
        },
        {
          "name": "버튼 제목",
          "type": "WL",
          "url_pc": "http://www.bizppurio.com",
          "url_mobile": "http://www.bizppurio.com",
          "scheme_ios": "sceme://xxx.xxx",
          "schemea_ndroid": "sceme://xxx.xxx"
        }
      ]
    }
  }
}
```

**친구톡 이미지**

```json5
{
  "account": "test",
  "refkey": "test1234",
  "type": "fi",
  "from": "07000000000",
  "to": "01000000000",
  "content": {
    "fi": {
      "senderkey": "1234",
      "message": "친구톡 이미지",
      "adflag": "Y",
      "image": {
        "img_url": "노출할 이미지 url",
        "imglink": "http://www.bizppurio.com"
      }
    }
  }
}

```

**친구톡 와이드 이미지**

```json5
{
  "account": "test",
  "refkey": "test1234",
  "type": "fw",
  "from": "07000000000",
  "to": "01000000000",
  "content": {
    "fw": {
      "senderkey": "1234",
      "message": "친구톡 와이드 이미지",
      "adflag": "Y",
      "image": {
        "img_url": "노출할 와이드 이미지 url",
        "imglink": "http://www.bizppurio.com"
      }
    }
  }
}
```

**친구톡 와이드 아이템 리스트**

```json5
{
  "account": "test",
  "refkey": "test1234",
  "type": "fl",
  "from": "07000000000",
  "to": "01000000000",
  "content": {
    "fl": {
      "senderkey": "1234",
      "header": "아이템 리스트 제목",
      "adflag": "Y",
      "item": {
        "list": [
          {
            "title": "title",
            "img_url": "아이템 이미지 URL",
            "url_mobile": "http://www.bizppurio.com/"
          },
          {
            "title": "title",
            "img_url": "아이템 이미지 URL",
            "url_mobile": "http://www.bizppurio.com/"
          },
          {
            "title": "title",
            "img_url": "아이템 이미지 URL",
            "url_mobile": "http://www.bizppurio.com/"
          },
          {
            "title": "title",
            "img_url": "아이템 이미지 URL",
            "url_mobile": "http://www.bizppurio.com/"
          }
        ]
      }
    }
  }
}

```

**친구톡 캐러셀 피드**

<pre class="language-json5"><code class="lang-json5"><strong>{
</strong>  "account": "test",
  "refkey": "test1234",
  "type": "fc",
  "from": "07000000000",
  "to": "01000000000",
  "content": {
    "fc": {
      "senderkey": "1234",
      "adflag": "Y",
      "carousel": {
        "tail": {
          "url_mobile": "http://www.bizppurio.com"
        },
        "list": [
          {
            "header": "헤더",
            "message": "메세지",
            "attachment": {
              "button": [
                {
                  "name": "비즈메시지 소개",
                  "type": "WL",
                  "url_pc": "http://www.bizppurio.com",
                  "url_mobile": "http://www.bizppurio.com"
                },
                {
                  "name": "비즈메시지 소개",
                  "type": "WL",
                  "url_pc": "http://www.bizppurio.com",
                  "url_mobile": "http://www.bizppurio.com"
                }
              ],
              "image": {
                "img_url": "케러셀 썸네일 이미지 주소",
                "img_link": "http://www.bizppurio.com"
              }
            }
          },
          {
            "header": "헤더",
            "message": "메세지",
            "attachment": {
              "button": [
                {
                  "name": "비즈메시지 소개",
                  "type": "WL",
                  "url_pc": "http://www.bizppurio.com",
                  "url_mobile": "http://www.bizppurio.com"
                },
                {
                  "name": "비즈메시지 소개",
                  "type": "WL",
                  "url_pc": "http://www.bizppurio.com",
                  "url_mobile": "http://www.bizppurio.com"
                }
              ],
              "image": {
                "img_url": "케러셀 썸네일 이미지 주소",
                "img_link": "http://www.bizppurio.com"
              }
            }
          }
        ]
      }
    }
  }
}

</code></pre>

**친구톡 커머스**

```json5
{
  "account": "test",
  "refkey": "test1234",
  "type": "fm",
  "from": "07000000000",
  "to": "01000000000",
  "content": {
    "fm": {
      "senderkey": "2662e99eb7a1f21abb3955278e9955f5a9a99b62",
      "image": {
        "img_url": "https://mud-kage.kakao.com/xxx.jpg",
        "img_link": "http://www.bizppurio.com"
      },
      "additionalcontent": "부가 정보",
      "commerce": {
        "title": "상품제목 (최대 30자)",
        "regular_price": 10000,
        "discount_price": 9000,
        "discount_fixed": 1000
      },
      "button": [
        {
          "name": "비즈메시지 소개",
          "type": "WL",
          "url_pc": "http://bizmessage.kakao.com/",
          "url_mobile": "http://bizmessage.kakao.com/"
        },
        {
          "name": "비즈메시지 소개",
          "type": "WL",
          "url_pc": "http://bizmessage.kakao.com/",
          "url_mobile": "http://bizmessage.kakao.com/"
        }
      ]
    }
  }
}
```

**친구톡 프리미엄 동영상**

```json5
{
  "account": "test",
  "refkey": "test1234",
  "type": "fp",
  "from": "07000000000",
  "to": "01000000000",
  "content": {
    "fp": {
      "senderkey": "2662e99eb7a1f21abb3955278e9955f5a9a99b62",
      "message": "사용자에게 전달될 메시지",
      "video": {
        "video_url": "https://tv.kakao.com/channel/10095965/cliplink/xxxxxxxx"
      },
      "button": [
        {
          "name": "비즈메시지 소개",
          "type": "WL",
          "url_pc": "http://bizmessage.kakao.com/",
          "url_mobile": "http://bizmessage.kakao.com/"
        }
      ]
    }
  }
}

```

**친구톡 캐러셀 커머스**

<pre class="language-json5"><code class="lang-json5"><strong>{
</strong>  "account": "test",
  "refkey": "test1234",
  "type": "fa",
  "from": "07000000000",
  "to": "01000000000",
  "content": {
    "fa": {
      "senderkey": "2662e99eb7a1f21abb3955278e9955f5a9a99b62",
      "carousel": {
        "head": {
          "header": "캐러셀 인트로 헤더",
          "content": "캐러셀 인트로 내용",
          "image_url": "https://mud-kage.kakao.com/xxx.jpg",
          "url_pc": "http://bizmessage.kakao.com/",
          "url_mobile": "http://bizmessage.kakao.com/"
        },
        "tail": {
          "url_pc": "http://bizmessage.kakao.com/",
          "url_mobile": "http://bizmessage.kakao.com/"
        },
        "list": [
          {
            "additionalcontent": "부가 정보",
            "attachment": {
              "coupon": {
                "title": "999999원 할인 쿠폰",
                "description": "비즈뿌리오비즈뿌리오12",
                "url_mobile": "https://bizppurio.com"
              },
              "commerce": {
                "title": "상품제목 (최대 30자)",
                "regular_price": 10000,
                "discount_price": 9000,
                "discount_fixed": 1000
              },
              "button": [
                {
                  "name": "비즈메시지 소개",
                  "type": "WL",
                  "url_pc": "http://bizmessage.kakao.com/",
                  "url_mobile": "http://bizmessage.kakao.com/"
                }
              ],
              "image": {
                "img_url": "https://mud-kage.kakao.com/xxx.jpg",
                "img_link": "https://daou.co.kr"
              }
            }
          },
          {
            "attachment": {
              "commerce": {
                "title": "상품제목 (최대 30자)",
                "regular_price": 10000,
                "discount_price": 9000,
                "discount_fixed": 1000
              },
              "button": [
                {
                  "name": "비즈메시지 소개",
                  "type": "WL",
                  "url_pc": "http://bizmessage.kakao.com/",
                  "url_mobile": "http://bizmessage.kakao.com/"
                }
              ],
              "image": {
                "img_url": "https://mud-kage.kakao.com/xxx.jpg",
                "img_link": "https://daou.co.kr"
              }
            }
          }
        ]
      }
    }
  }
}

</code></pre>

### 카카오톡 이모티콘 삽입

카카오톡 기본 이모티콘 삽입을 원할 경우 이모티콘에 해당하는 명령어를 입력합니다.

예) 안녕하세요 (하하)(씨익)

<figure><img src="/files/fIuh1ZOrFoWxasUNGwp8" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
카카오에서 공식적으로 지원하는 기능이 아니므로 명령어에 대한 변경이 있을 수 있습니다.
{% endhint %}

[^1]: