카카오톡 비즈메시지

알림톡/친구톡

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

SMS

MMS

MMS

RCS

R

RCS

SMS

RS

RCS

MMS

RM

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/LMSNextRCS

Last updated