카카오톡 비즈메시지

알림톡/친구톡

AT 발송

알림톡은 비즈뿌리오 서버에 등록된 사용 가능한 발신프로필 키와 템플릿코드를 사용하여 발송됩니다.

알림톡은 변수 내용을 포함하고 한글, 영어, 숫자, 특수문자 및 공백을 모두 포함하여 최대 1000 자 까지만 발송 가능합니다.

INSERT INTO biz_msg (MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, 
DEST_PHONE, SEND_PHONE, MSG_BODY, TEMPLATE_CODE, SENDER_KEY, NATION_CODE)

VALUES (6, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.', {템플릿코드}, {발신프로필키}, '82')

템플릿 예시

### 비즈뿌리오 사이트에 등록한 템플릿 내용 ###

안녕하세요 #{고객명}님 다우기술 입니다. 
#{날짜}에 주문하신 상품이 발송 되었습니다. 
택배사명 : #{택배사}
배송일자 : #{배송일}

감사합니다.

### MSG_BODY 컬럼에 입력할 내용 ###

안녕하세요 홍길동님 다우기술 입니다. 
2020.01.01 에 주문하신 상품이 발송 되었습니다. 
택배사명 : 다우택배
배송일자 : 2020.01.02

감사합니다.

대체 발송 타입 (RE_TYPE)

1차 대체발송 타입에 따라 최대 2차 대체발송까지 가능합니다.

1차 대체 발송

2차 대체 발송

RE_TYPE 입력값

SMS

MMS

RCS

SMS

RCS

MMS

AT/FT + 1차 대체 발송

알림톡/친구톡 발송 결과 실패 시 지정하신 대체 발송 타입(SMS/MMS/RCS)과 대체 발송 본문을 사용하여 발송됩니다.

(단, 비즈뿌리오 ID 가 대체 발송 사용 가능하도록 설정되어 있어야 합니다.)

SMS/MMS 대체 발송의 경우 대체 발송 본문에 대해 동일 본문을 사용하려면, 대체 발송 메시지 필드(RE_BODY)를 비워두시면 됩니다.

(단, SMS 대체 발송의 경우에는 메시지 본문 (MSG_BODY) 길이가 SMS 의 허용 길이를 초과하였을 때 발송되지 않습니다.)

AT/FT + SMS 1차 대체 발송

AT/FT + SMS 1차 대체 발송

INSERT INTO biz_msg (
MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, 
SEND_PHONE, MSG_BODY, TEMPLATE_CODE, SENDER_KEY, NATION_CODE, RE_TYPE, RE_BODY)

VALUES (
6, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.', {템플릿코드}, {발신프로필키}, 
82, 'SMS', '[다우기술] 응모하신 프로모션에 당첨되셨습니다.')

AT/FT + MMS 1차 대체 발송

AT/FT + MMS 1차 대체 발송

INSERT INTO biz_msg (
MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE,
MSG_BODY, TEMPLATE_CODE, SENDER_KEY, NATION_CODE, RE_TYPE, RE_BODY, ATTACHED_FILE)

VALUES (
6, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.', {템플릿코드}, {발신프로필키}, 
82, 'MMS', '[다우기술] 응모하신 프로모션에 당첨되셨습니다.', {첨부파일명.jpg})

RCS 대체발송은 RCS 테이블의 데이터를 사용하여 메시지가 발송됩니다.

AT/FT + RCS 1차 대체 발송

AT/FT + RCS 1차 대체 발송

 INSERT INTO biz_msg (
MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE, 
MSG_BODY, TEMPLATE_CODE, SENDER_KEY, NATION_CODE, RE_TYPE, RCS_REFKEY)

VALUES (
6, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.', {템플릿코드}, {발신프로필키}, 
82, 'R', '{RCS_REFKEY}')

대체 발송이 이루어진 경우, 클라이언트는 수신 받은 리포트를 업데이트하는 시점에 대체 발송에 대한 정보를 추가 레코드로 신규 생성하게 됩니다. 알림톡/친구톡과 대체 발송에 대한 레코드의 매핑 키는 알림톡/친구톡의 UMID 필드가 대체 발송의 CMID 필드로 이루어집니다.

AT/FT + 2차 대체 발송

알림톡/친구톡 발송 실패 시 RCS메시지를 발송하며 RCS메시지 발송 결과 실패 시 지정한 2차 대체 발송 타입(SMS/MMS)과 대체 발송 본문을 사용하여 발송됩니다. (단, 비즈뿌리오 ID 가 대체 발송 사용 가능하도록 설정되어 있어야 합니다.)

대체 발송 본문에 대해 동일 본문을 사용하려면, 대체 발송 메시지 필드(RE_BODY)를 비워두시면 됩니다. (단, SMS 대체발송의 경우에는 메시지 본문(MSG_BODY) 길이가 SMS 의 허용 길이를 초과하였을 때 발송되지 않습니다.)

AT/FT + RCS(1차) + SMS(2차)

AT/FT + RCS(1차) + SMS(2차)

INSERT INTO biz_msg (
MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE, 
MSG_BODY, TEMPLATE_CODE, SENDER_KEY, NATION_CODE,RE_TYPE, RE_BODY, RCS_REFKEY)

VALUES (
6, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.', {템플릿코드}, {발신프로필키}, 
82, 'RS', '[다우기술] 응모하신 프로모션에 당첨되셨습니다.', '{RCS_REFKEY}')

대체 발송이 이루어진 경우, 클라이언트는 수신 받은 리포트를 업데이트하는 시점에 대체 발송에 대한 정보를 추가 레코드로 신규 생성하게 됩니다. 알림톡/친구톡과 대체 발송에 대한 레코드의 매핑 키는 알림톡/친구톡의 UMID 필드가 대체 발송의 CMID 필드로 이루어집니다.

2차 대체 발송이 이루어진 경우, 알림톡/친구톡의 UMID 값 앞에 "**RE_"**이 추가된 문자열이 2차 대체 발송의 CMID 필드로 이루어지며 1차 대체 발송의 UMID 도 같은 값으로 설정됩니다.

AT/FT + ATTACHMENT 발송

알림톡/친구톡에 버튼 및 추가 기능을 사용하고자 할 경우 환경설정 파일에서 지정한 파일경로(FILE_PATH)에 JSON 형식 파일을 업로드 한 후, 첨부될 파일은 ATTACHED_FILE 필드에 입력합니다.

(JSON 형식 파일 인코딩은 EUC-KR 로 생성되어 있어야 합니다.)

(웹 링크, 앱 링크에 변수가 있거나 JSON 파일 생성이 어려운 경우 FILE_HANDLING_MODE 테이블을 활용 할 수 있습니다.)

(버튼 및 추가 기능이 등록된 템플릿코드만 사용가능합니다.)

AT + ATTACHMENT

INSERT INTO biz_msg (
MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE, 
MSG_BODY, TEMPLATE_CODE, SENDER_KEY, NATION_CODE, ATTACHED_FILE)

VALUES (
6, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.', 
{템플릿코드}, {발신프로필키}, '82', '{파일명}.json')

FT + ATTACHMENT

INSERT INTO biz_msg (
MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE, 
MSG_BODY, SENDER_KEY, NATION_CODE,ATTACHED_FILE)

VALUES (7, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.', 
{발신프로필키}, '82', '{파일명}.json')

알림톡 ATTACHMENT 정보

Key:supplement 항목은 아래 이어지는 supplement 테이블을 참고

supplement

버튼

버튼 타입

AT + 버튼 타입별 속성

버튼 첨부파일 예시

button.json

{
  "button": [
    {
      "name": "미리 주문하기",
      "type": "WL",
      "url_mobile": "http://www.kakao.com"
    },
    {
      "name": "상담원 연결하기",
      "type": "MD"
    },
    {
      "name": "방송 알림 설정 보기",
      "type": "AL",
      "scheme_android": "daumapps://open",
      "scheme_ios": "daumapps://open"
    }
  ]
}

바로연결

알림톡 바로연결이란?

알림톡 하단에 가로 슬라이드 형태로 표시되며 웹/앱 연결, 상담톡 전환 등을 호출하는 기능
상담톡 또는 챗봇을 사용하는 발신프로필만 이용 가능
바로연결은 최대 10개까지 사용 가능, 사용 시 버튼 개수는 2개로 제한 *(챗봇, 상담톡 사용 채널에만 한해 사용 가능합니다.)

바로연결 타입별 속성

바로연결 첨부파일 예시

quick_reply.json

{
  "button": [
    {
      "name": "비즈뿌리오 바로가기",
      "type": "WL",
      "url_mobile": "https://www.bizppurio.com/"
    }
  ],
  "extra": {
    "supplement": {
      "quick_reply": [
        {
          "name": "비즈뿌리오",
          "type": "WL",
          "url_mobile": "https://www.bizppurio.com/"
        },
        {
          "name": "봇키워드하기",
          "type": "BK"
        },
        {
          "name": "메시지전달하기",
          "type": "MD"
        },
        {
          "name": "상담톡전환",
          "type": "BC"
        }
      ]
    }
  }
}

강조 표기

템플릿 내용 중 강조 표기할 핵심 정보 (메시지 강조 표기 타이틀은 최대 50 자 까지 설정 가능하며 알림톡 본문(1000 자)에 포함되지 않습니다.)

강조 표기 첨부파일 예시

Title.json (버튼이 없는 경우)

{
  "extra" : {
    "title" : "입금 123,456 원"
  }
}

Title.json (버튼이 있는 경우)

{
  "button": [
    {
      "name": "채널 추가",
      "type": "AC"
    }
  ],
  "extra": {
    "title": "입금 123,456 원"
  }
}

알림톡 이미지, 아이템 리스트

이미지와 구조화된 목록이 포함된 알림톡

기존 텍스트 알림톡 기본형에 (이미지 / 헤더 / 아이템 하이라이트 / 아이템리스트 / 아이템 요약정보) 5가지 항목이 추가로 구성
이미지, 헤더, 아이템 하이라이트 영역을 필요에 따라 1 개 이상 필수 선택하여 템플릿 등록
템플릿 당 고정된 이미지만 사용 가능
아이템리스트는 최소 2개 이상 최대 10개 항목으로 구성 가능 (알림톡 템플릿 강조 유형이 이미지형(IMAGE) 인 경우에만 msg_type 을 ai 로 설정해주셔야 발송 가능합니다.) (ex. 알림톡 템플릿 강조 유형이 아이템리스트형이고 이미지가 포함된경우 msg_type 을 ai 로 설정시 발송 실패)

이미지, 아이템리스트형 첨부파일 예시

Alimtalk_image.json (이미지형)

{
  "extra": {
    "msg_type": "AI"
  }
}

Alimtalk_item_list.json (아이템리스트형, 헤더 + 아이템리스트 + 아이템 요약 정보)

{
  "item": {
    "list": [
      {
        "title": "가입일자",
        "description": "2021.5.23"
      },
      {
        "title": "이름",
        "description": "김카카오"
      }
    ],
    "summary": {
      "title": "구매가격",
      "description": "18,000 원"
    }
  },
  "extra": {
    "header": "카카오 가입을 환영합니다.",
    "msg_type": "AT"
  }
}

Alimtalk_item_list_button.json ( 아이템리스트형, 버튼 + 이미지 + 아이템 하이라이트 )

{
  "button": [
    {
      "name": "채널 추가",
      "type": "AC"
    }
  ],
  "item_highlight": {
    "title": "가입 환영 포인트",
    "description": "10,000P"
  }
}

FT 발송

친구톡은 비즈뿌리오 서버에 등록된 사용 가능한 발신 프로필 키를 사용하여 발송되며, 카카오톡 사용자이고 발신 프로필(카카오톡 채널)과 친구일 경우 발송 가능합니다.

친구톡은 한글, 영어, 숫자, 특수문자 및 공백을 모두 포함하여 최대 1000 자 까지만 발송 가능합니다.

INSERT INTO biz_msg (
MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, 
DEST_PHONE, SEND_PHONE, MSG_BODY, SENDER_KEY, NATION_CODE)

VALUES (
6, '201XXXXXXXXX', NOW(), NOW(), '01012341234', '0212341234',
'홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.', {발신프로필키}, '82'

FT 상품 타입

텍스트 타입 (FT)

텍스트 최대 1,000자 + 버튼 최대 5개

이미지 타입 (FI)

텍스트 최대 400자 + 이미지 1장(500KB) + 버튼 최대 5개
기본적으로 텍스트 타입과 동일하나 attachment 필드에 이미지를 추가하여 발송
비즈뿌리오 사이트에서 이미지 사전 등록 필요

와이드 이미지타입 (FW)

텍스트 최대 76자 + 이미지 1장(2MB) + 버튼 최대 1개
기본적으로 텍스트 타입과 동일하나 attachment 필드에 이미지를 추가하여 발송
비즈뿌리오 사이트에서 이미지 사전 등록 필요

와이드 아이템 리스트 타입 (FL)

리스트 최소 3개, 최대 4개
리스트당 텍스트 최대 25자 + 이미지 1장(2MB)
버튼 최대 2개(가로 정렬)
하나의 말풍선에 여러 아이템 리스트를 attachment.item.list 필드에 담아서 발송 가능
비즈뿌리오 사이트에서 이미지 사전 등록 필요
광고 발송만 가능

캐러셀 피드 타입 (FC)

캐러셀 최소 2장, 최대 6장
캐러셀당 제목 최대 20자, 본문 최대 80자 + 이미지 1장(2MB) + 버튼 최대 2개(가로정렬)
여러 말풍선을 carousel 필드에 list 로 추가 할 수 있고, 더보기 버튼(tail)을 지정하여 발송
비즈뿌리오 사이트에서 이미지 사전 등록 필요
광고 발송만 가능

* 비즈뿌리오 사이트의 [카카오톡 비즈메시지] – [친구톡 이미지 등록] 을 통해 업로드,

[친구톡 이미지 관리] 에서 해당이미지 URL을 확인

친구톡 ATTACHMENT 정보

#Carousel

버튼

버튼 타입

#버튼 타입 별 속성

#버튼 첨부파일 예시

{
  "button": [
    {
      "name": "미리 주문하기",
      "type": "WL",
      "url_mobile": "http://www.kakao.com"
    },
    {
      "name": "상담원 연결하기",
      "type": "MD"
    },
    {
      "name": "방송 알림 설정 보기",
      "type": "AL",
      "scheme_android": "daumapps://open",
      "scheme_ios": "daumapps://open"
    }
  ]
}

이미지, 와이드 이미지

이미지에 대한 정보는 JSON 파일로 만들어환경설정파일에서 지정한 파일경로(FILE_PATH)에 JSON형식 파일을 업로드 한 후, 첨부될 파일은 ATTACHED_FILE 필드에 입력합니다.

친구톡 이미지 타입 첨부파일의 실제 내용은 다음과 같이 JSON 형태로 구성됩니다.

friend_image.json

{
  "image": {
    "img_url": "등록된 이미지 URL",
    "img_link": "http://www.kakao.com"
  }
}

친구톡 와이드 이미지 + 버튼링크 첨부파일의 실제 내용은 다음과 같이 하나의 JSON 형태로 구성됩니다.

friend_wide_image_button.json

{
  "extra": {
    "msg_type": "FW"
  },
  "button": [
    {
      "name": "미리 주문하기",
      "type": "WL",
      "url_mobile": "http://www.kakao.com"
    }
  ],
  "image": {
    "img_url": "등록된 이미지 URL",
    "img_link": "http://bizmessage.kakao.com/"
  }
}

와이드 아이템 리스트

와이드 아이템 리스트에 대한 정보는 JSON 파일로 만들어 환경설정파일에서 지정한 파일경로(FILE_PATH)에 JSON형식 파일을 업로드 한 후, 첨부될 파일은 ATTACHED_FILE 필드에 입력합니다.

친구톡 와이드 아이템 리스트 타입 첨부파일의 실제 내용은 다음과 같이 JSON 형태로 구성됩니다.

friend_wide_itemlist.json

{
  "extra": {
    "msg_type": "FL"
  },
  "item": {
    "list": [
      {
        "title": "아이템 제목",
        "img_url": "등록된 이미지 URL",
        "url_mobile": "http://www.kakao.com"
      }
    ]
  }
}

캐러셀 피드

캐러셀에 대한 정보는 JSON 파일로 만들어 환경설정파일에서 지정한 파일경로(FILE_PATH)에 JSON형식 파일을 업로드 한 후, 첨부될 파일은 ATTACHED_FILE 필드에 입력합니다.

친구톡 캐피드 타입 첨부파일의 실제 내용은 다음과 같이 JSON 형태로 구성됩니다.

friend_carousel.json

{
  "extra": {
    "msg_type": "FC",
    "carousel": {
      "list": [
        {
          "header": "캐러셀 아이템 제목",
          "message": "캐러셀 아이템 메시지",
          "attachment": {
            "button": [
              {
                "name": "버튼 제목",
                "type": "버튼 타입",
                "scheme_android": "mobile android 환경에서 버튼 클릭 시 실행할 application custom scheme",
                "scheme_ios": "mobile ios 환경에서 버튼 클릭 시 실행할 application custom scheme",
                "url_mobile": " mobile 환경에서 버튼 클릭 시 이동할 url",
                "url_pc": "pc 환경에서 버튼 클릭 시 이동할 url"
              }
            ],
            "image": {
              "img_url": "캐러셀 썸네일 이미지 주소",
              "img_link": "캐러셀 썸네일 링크 주소"
            }
          }
        }
      ],
      "tail": {
        "url_pc": "pc 환경에서 버튼 클릭 시 이동할 url",
        "url_mobile": " mobile 환경에서 버튼 클릭 시 이동할 url",
        "scheme_ios": "mobile ios 환경에서 버튼 클릭 시 실행할 application custom scheme",
        "scheme_android": "mobile android 환경에서 버튼 클릭 시 실행할 application custom scheme"
      }
    }
  }
}

쿠폰

쿠폰에 대한 정보는 JSON 파일로 만들어 환경설정파일에서 지정한 파일경로(FILE_PATH)에 JSON형식 파일을 업로드 한 후, 첨부될 파일은 ATTACHED_FILE 필드에 입력합니다.

쿠폰형은 메세지 타입이 FT, FI, FW, FL인 경우 사용 가능함.
title의 경우 5가지 형식으로 제한 됨
"${숫자}원 할인 쿠폰" 숫자는 1이상 99,999,999 이하
"${숫자}% 할인 쿠폰" 숫자는 1이상 100 이하
"배송비 할인 쿠폰"
"${7자 이내} 무료 쿠폰"
"${7자 이내} UP 쿠폰"
url_pc, url_mobile, scheme_android, scheme_ios의 경우 필수값이 두가지 케이스로 구분됨
기본 - url_mobile 필수값 나머지 옵션값
채널 쿠폰 URL(포멧: alimtalk=coupon://) 사용 - scheme_android 혹은 scheme_ios 둘 중 하나 필수값 나머지 옵션값

친구톡 이미지 타입 첨부파일의 실제 내용은 다음과 같이 JSON 형태로 구성됩니다

friend_coupon.json

{
  "extra": {
    "msg_type": "FT"
  },
  "coupon": {
    "title": "쿠폰 이름 형식",
    "description": "쿠폰 상세 설명 (FT, FI - 12자 / FW, FL - 18자 제한)",
    "url_pc": "pc 환경에서 이미지 클릭 시 이동할 url",
    "url_mobile": "mobile 환경에서 이미지 클릭 시 이동할 url",
    "scheme_android": "mobile android 환경에서 쿠폰 클릭 시 실행할 application custom scheme",
    "scheme_ios": "mobile ios 환경에서 쿠폰 클릭 시 실행할 application custom scheme"
  }
}

FT + 이미지

이미지 타입의 친구톡을 발송하기 위하여 반드시 이미지를 사전에 비즈뿌리오 사이트의 [카카오톡 비즈메시지] – [친구톡 이미지 등록] 을 통해 업로드 해야 합니다. 이후 *[친구톡 이미지 관리]에서 해당 이미지 URL 을 확인하여 발송합니다.

이미지에 대한 정보는 JSON 파일로 만들어 환경설정 파일에서 지정한 파일경로(FILE_PATH)에 JSON 형식 파일을 업로드 한 후, 첨부될 파일은 ATTACHED_FILE 필드에 입력합니다.

친구톡 + 이미지 타입 첨부파일의 실제 내용은 다음과 같이 JSON 형태로 구성됩니다.

image.json

{
  "image": {
    "img_url": "등록된 이미지 URL",
    "img_link": "http://bizmessage.kakao.com/"
  },
  "extra": {
    "wide": "Y"
  }
}

친구톡+버튼링크+이미지타입 첨부파일의 실제 내용은 다음과 같이 하나의 JSON 형태로 구성됩니다.

button.json

{
  "button": [
    {
      "name": "미리 주문하기",
      "type": "WL",
      "url_mobile": "http://www.kakao.com"
    }
  ],
  "image": {
    "img_url": "등록된 이미지 URL",
    "img_link": "http://bizmessage.kakao.com/"
  }
}

카카오톡 이모티콘 삽입

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

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

카카오에서 공식적으로 지원하는 기능이 아니므로 명령어에 대한 변경이 있을 수 있습니다.

PreviousMMS/LMS NextRCS

Last updated 2 years ago

hashtagAT 발송

hashtag대체 발송 타입 (RE_TYPE)

hashtagAT/FT + 1차 대체 발송

hashtagAT/FT + 2차 대체 발송

hashtagAT/FT + ATTACHMENT 발송

hashtag알림톡 ATTACHMENT 정보

hashtag버튼

hashtagAT + 버튼 타입별 속성

hashtag버튼 첨부파일 예시

hashtag바로연결

hashtag바로연결 타입별 속성

hashtag강조 표기

hashtag알림톡 이미지, 아이템 리스트

hashtag

hashtag

hashtag

hashtagFT 발송

hashtagFT 상품 타입

hashtag친구톡 ATTACHMENT 정보

hashtag버튼

hashtagFT + 이미지

hashtag카카오톡 이모티콘 삽입

AT 발송

대체 발송 타입 (RE_TYPE)

AT/FT + 1차 대체 발송

AT/FT + 2차 대체 발송

AT/FT + ATTACHMENT 발송

알림톡 ATTACHMENT 정보

버튼

AT + 버튼 타입별 속성

버튼 첨부파일 예시

바로연결

바로연결 타입별 속성

강조 표기

알림톡 이미지, 아이템 리스트

FT 발송

FT 상품 타입

친구톡 ATTACHMENT 정보

버튼

FT + 이미지

카카오톡 이모티콘 삽입