플러그인에 스킬 적용하기

챗봇 관리자센터의 또 하나의 자랑, 카카오톡 화면에 있었으면 했던 바로 그 기능을 ‘플러그인’과 함께 연동된 스킬이 대신할 수 있습니다.

사용자가 간편하게 날짜/시간 전송, 이미지 보안 전송, 바코드(QR) 전송까지 할 수 있는 챗봇 관리자센터의 초필살기 메뉴!

앞으로 더욱 다양한 기능을 가진 플러그인이 봇 작업자 여러분을 찾아갈 예정입니다.

내가 고른 플러그인을 간단히 설정하고 스킬서버와 연동까지! 한 번에 경험해보세요.

바코드(QR) 플러그인

바코드(QR) 플러그인이란?

바코드(QR) 플러그인은 사용자가 코드 스캐너를 통해 봇에게 정확한 바코드(QR)값을 전송할 수 있도록 입력받는 역할을 합니다. 봇과의 대화중 사용자의 바코드(QR)입력이 필수로 필요한 경우, 봇 작업자가 설정해 둔 플러그인을 통해 코드 스캐너를 띄워 사용자가 정확한 코드값을 쉽게 입력할 수 있도록 도와줍니다.

Tip. 바코드(QR) 플러그인을 통해서 호출되는 코드 스캐너는 QR코드와 바코드를 하나의 화면에서 구분없이 인식할 수 있습니다.

바코드(QR) 플러그인 설정

Step 1. 파라미터 설정 영역을 펼친 후 파라미터 만들기 눌러 팝업을 띄웁니다.

Step 2. 플러그인 및 필수 파라미터를 설정하고 확인을 누릅니다.

우측 상단에서 ‘플러그인’으로 변경한 다음 ‘필수 파라미터로 설정’을 체크합니다. (필수 파라미터로 체크하지 않을 경우, 되묻기 질문을 통해 코드 스캐너를 띄워주는 말풍선을 설정할 수 없습니다.)

그 후, 파라미터명을 입력하고 플러그인 목록에서 [sys.plugin.barcode]를 선택하고 확인 버튼을 누릅니다.

Tip. 바코드(QR) 플러그인을 사용하려면 '엔티티 메뉴 - 시스템 엔티티'에서 @sys.plugin.barcode 항목이 활성화되어있어야 합니다.

Step 3. 설정된 화면을 확인하고 되묻기 질문 버튼을 클릭합니다.

입력 완료 후 ‘확인’ 버튼을 누르면 아래와 같이 설정됩니다. 그 다음 [되묻기 질문] 버튼을 클릭하여 설정 팝업을 띄웁니다.

Step 4. 되묻기 질문 설정 팝업에서 말풍선에 표시될 텍스트와 버튼명을 입력합니다.

Step 5. 플러그인 호출이 필요한 발화를 입력하게 되면 아래와 같이 말풍선이 출력됩니다.

바코드(QR) 인식이 완료되면 자동으로 코드 스캐너 화면이 닫히고 “바코드(QR) 전송 완료” 메시지가 전송됩니다. 메시지를 통해서 파라미터의 Value에 인식된 값을 받을 수 있고 스킬 API까지 아래와 같은 포맷으로 전송받을 수 있습니다.

타입	포맷	예시
QR/바코드	숫자 혹은 영문 조합	URL 형태 : https://kakao.ai/about 바코드 숫자 형태 : 8801236002224

타입

포맷

예시

QR/바코드

숫자 혹은 영문 조합

URL 형태 : https://kakao.ai/about

바코드 숫자 형태 : 8801236002224

스킬 호출값

스킬명이 ‘바코드’이고 파라미터명을 ‘barcode’로 설정한 상태에서 사용자가 바코드를 전송했을 때 호출되는 payload는 아래와 같습니다.

{
  "action": {
    "id": "5ab1cb5c9418c22b668807d4",
    "name": "바코드",
    "clientExtra": {},
    "params": {
      "barcode": "{\"barcodeData\":\"8801236002224\"}"
    },
    "detailParams": {
      "barcode": {
        "origin": "바코드(QR)전송 완료",
        "value": "{\"barcodeData\":\"8801236002224\"}",
        "groupName": ""
      }
    }
  }
}

날짜/시간 플러그인

날짜/시간 플러그인이란?

날짜/시간 플러그인은 봇 작업자가 설정한 제한값 안에서 사용자들에게 정확한 날짜와 시간 데이터를 입력받는 역할을 합니다. 봇 작업자가 설계한 말풍선에서 날짜/시간 플러그인 호출을 위한 버튼을 눌렀을 때, 해당 피커가 뜨게 되고 사용자는 그 안에서 원하는 값을 설정할 수 있습니다.

Information. 날짜/시간 플러그인은 한국시간 기준(UTC+09:00)으로 피커가 노출됩니다.

날짜/시간 플러그인 설정하기

Step 1. 파라미터 설정 영역을 펼친 후 파라미터 만들기 눌러 팝업을 띄웁니다.

Step 2. 플러그인 및 필수 파라미터를 설정하고 확인을 누릅니다.

그 후, 파라미터명을 입력하고 목록에서 사용 목적에 따른 플러그인을 선택합니다.

Tip.

날짜/시간 플러그인을 사용하려면 '엔티티 메뉴 - 시스템 엔티티'에서 아래의 엔티티가 활성화되어있어야 합니다.

‘날짜/시간’은 sys.plugin.datetime
‘날짜’는 sys.plugin.date
‘시간’은 sys.plugin.time

Step 3. 설정된 화면을 확인하고 되묻기 질문 버튼을 클릭합니다.

Step 4. 되묻기 질문을 설정 팝업에서 말풍선에 표시될 텍스트와 버튼명을 입력합니다.

Step 5. 플러그인 상세설정에서 버튼명과 원하는 날짜/시간 범위를 입력합니다.

Information. ‘파라미터 만들기’ 화면에서 선택한 플러그인에 따라 sys.plugin.datetime은 날짜/시간, sys.plugin.date은 날짜, sys.plugin.time은 시간의 범위를 지정할 수 있습니다.

‘범위 지정’ 방식은 사용자가 클라이언트에 노출된 말풍선 생성일을 기준으로 ‘오늘을 포함한 과거 혹은 미래의 범위 날짜값’을 노출하는 방식입니다. 선택가능한 범위는 현재일 기준으로 30일, 60일, 90일, 180일, 360일이며, 형태는 ‘미래’ 범위 노출, ‘과거’ 범위 노출, ‘과거부터 미래’ 범위로 설정 가능합니다.

Example.

현재일이 3월 20일 경우, 미래 30일을 선택하면 3월 20일(D+1) , 3월 21일(D+2), …, 4월 18(D+30)일이 노출됩니다. 동일하게 현재일이 3월 20일 경우, 과거/미래 30일을 선택하면 D-30 ~ D+30 범위의 날짜가 노출됩니다.

‘직접지정’ 방식은 사용자가 클라이언트에 ‘시작일’ 과 ‘종료일’을 사용자가 직접 지정하여 노출하는 방식입니다. 직접 지정할 수 있는 날짜의 범위는 제한되어 있으며 올해를 기준으로 -100년, +100년 사이의 날짜범위를 지정할 수 있습니다. 사용자에게 노출하는 시간 제한값은 ‘선택 시간단위’, ‘시작 시간’, ‘종료 시간’ 을 설정하여 제한할 수 있습니다.

만약 ‘선택 가능 시간단위’를 20분으로 하고 ‘시작 시간’이 10시 40분, ‘종료 시간’이 19시 40분이면 사용자가 선택한 수 있는 값의 범위는 10시 40분부터 19시 40분 사이의 시간 중 20분 단위의 시간이 노출되고 이 중 하나를 선택할 수 있게 됩니다.

Example. 10시 40분, 11시, 11시 20분, 11시 40분 … 19시, 19시 20분, 19시 40분

선택가능한 시간단위는 1분 / 5분 / 10분 /15분 / 20분 / 30분 이며, 시작시간과 종료시간에서 선택할 수 있는 ‘분 단위’는 선택 가능 시간 단위에 따라 달라집니다.

Example.

시간단위를 15분으로하고 시작시간을 10시 10분으로 설정(X)

시간단위를 30분으로하고 시작시간을 9시 30분으로 설정(O)

타입별 노출 피커 형태

사용자에게 노출되는 피커는 사용자가 설정한 플러그인의 타입에 따라 세 가지 방식으로 나누어 집니다.

날짜/시간 플러그인일 경우, 사용자가 선택할 수 있는 날짜의 범위는 일정제한에서 입력한 ‘시작일’ 부터 ‘종료일’ 혹은 ‘날짜 범위’이고, 시간제한에서 입력한 ‘시작 시간’ 부터 선택한 시간단위로 ‘종료 시간’까지의 범위로 노출됩니다.

Example. YYYY년 MM월 DD일 HH : MM

날짜 플러그인 일 경우, 일정제한에서 입력한 ‘시작일’ 부터 ‘종료일’ 혹은 ‘날짜 범위’ 사이의 값들이 노출됩니다.

Example. YYYY년 MM월 DD일

시간 플러그인일 경우, 시간제한에서 입력한 ‘시작 시간’ 부터 선택한 시간단위로 ‘종료 시간’까지의 범위로 노출됩니다.

Example. HH : MM

Tip.

사용자가 카카오톡에서 설정한 언어/위치에 따라 노출되는 피커가 달라집니다.

국문 : 2018년 11월 30일 / 오후 9:40
영문 : November 30, 2018 / 9:40PM
중문 : 2018年 11月 30日 / 午後 9:40

사용자가 선택한 값은 되묻기 파라미터의 Value에 값을 받을 수 있고 스킬 API까지 아래와 같은 포맷으로 전송받을 수 있습니다.

타입	포맷	예시
날짜/시간	yyyy-mm-dd ’T’ hh:mm:ss	2018-03-19T10:15:00
날짜	yyyy-mm-dd	2018-03-19
시간	hh:mm:ss	10:15:00

타입

포맷

예시

날짜/시간

yyyy-mm-dd ’T’ hh:mm:ss

2018-03-19T10:15:00

날짜

yyyy-mm-dd

2018-03-19

시간

hh:mm:ss

10:15:00

스킬 호출값

날짜/시간

스킬명이 ‘날짜시간’이고 파라미터명을 ‘datetime’으로 설정한 상태에서 사용자가 3월 20일 10:15를 입력했을 때 스킬로 호출되는 payload는 아래와 같습니다.

{
  "action": {
    "name": "날짜시간",
    "clientExtra": null,
    "params": {
        "datetime": "{\"value\":\"2018-03-20T10:15:00\",\"userTimeZone\":\"UTC+9\"}"
    },
    "id": "5ab1cb5c9418c22b668807d4",
    "detailParams": {
      "datetime": {
          "origin": "2018-03-20T10:15:00",
          "value": "{\"value\":\"2018-03-20T10:15:00\",\"userTimeZone\":\"UTC+9\"}",
          "groupName": ""
      }
    }
  }
}

날짜

스킬명이 ‘날짜’고 파라미터명을 ‘date’로 설정한 상태에서 사용자가 3월 20일을 입력했을 때 스킬로 호출되는 payload는 아래와 같습니다.

{
  "action": {
    "name": "날짜",
    "clientExtra": null,
    "params": {
      "date": "{\"value\":\"2018-03-20\",\"userTimeZone\":\"UTC+9\"}"
    },
    "id": "5ab1cb5c9418c22b668807d4",
    "detailParams": {
      "date": {
        "origin": "2018-03-20",
        "value": "{\"value\":\"2018-03-20\",\"userTimeZone\":\"UTC+9\"}",
        "groupName": ""
      }
    }
  }
}

시간

스킬명이 ‘시간’이고 파라미터명을 ‘time’으로 설정한 상태에서 사용자가 15:30을 입력했을 때 스킬로 호출되는 payload는 아래와 같습니다.

{
  "action": {
    "name": "시간",
    "clientExtra": null,
    "params": {
      "time": "{\"value\":\"15:30:00\",\"userTimeZone\":\"UTC+9\"}"
    },
    "id": "5ab1cb5c9418c22b668807d4",
    "detailParams": {
        "time": {
            "origin": "15:30:00",
            "value": "{\"value\":\"15:30:00\",\"userTimeZone\":\"UTC+9\"}",
            "groupName": ""
        }
    }
  }
}

이미지 보안전송 플러그인

이미지 보안전송 플러그인이란?

이미지 보안전송 플러그인은 사용자가 봇에게 개인정보가 포함된 이미지를 최대 10장까지 전송할 수 있는 플러그인입니다. 사용자가 전송한 이미지는 카카오 내부 보안정책에 의해서 안전하게 보관되며, 이미지의 URL은 최대 10분간 유지됩니다.

이미지 보안전송 플러그인 설정

Step 1. 파라미터 설정 영역을 펼친 후 파라미터 만들기 눌러 팝업을 띄웁니다.

Step 2. 플러그인 및 필수 파라미터를 설정하고 확인을 누릅니다.

그 후, 파라미터명을 입력하고 플러그인 목록에서 @sys.plugin.secureimage를 선택합니다.

Step 3. 설정된 화면을 확인하고 되묻기 질문 버튼을 클릭합니다.

파라미터명을 입력하고 플러그인을 선택한 후, ‘확인’ 버튼을 누르면 아래와 같이 설정됩니다. 여기서 [되묻기 질문] 버튼을 클릭하여 플러그인을 통해서 값을 전달받을 수 있는 버튼이 포함된 말풍선을 설정합니다.

Step 4. 되묻기 질문 설정 팝업에서 말풍선에 표시될 텍스트와 버튼명을 입력합니다.

Step 5. 플러그인 상세설정에서 버튼명을 입력하고 이미지를 전송하는 사용자에게 보여줄 개인정보 동의 수집 항목을 입력합니다.

Caution.

수집하는 항목에 대한 내용을 정확하게 작성한 후 사용해주세요. 아래 내용에 동의하지 않으면 사용자는 이미지를 전송할 수 없습니다.

Step 6. 봇은 사용자가 보내는 이미지를 아래 순서에 따라 전송받을 수 있습니다.

메시지를 통해서 파라미터의 Value에 인식된 값을 받을 수 있고 스킬 API까지 아래와 같은 포맷으로 전송받을 수 있습니다.

타입	포맷	예시
이미지	privacyAgreement : 개인정보 제공동의여부 imageQuantity : 이미지 수량 secureUrls : 이미지 URL목록	privacyAgreement : Y imageQuantity : 1 secureUrls : http://secure.xxxxx.xxxx.xxxxx

타입

포맷

예시

이미지

privacyAgreement : 개인정보 제공동의여부

imageQuantity : 이미지 수량

secureUrls : 이미지 URL목록

privacyAgreement : Y

imageQuantity : 1

secureUrls : http://secure.xxxxx.xxxx.xxxxx

스킬 호출값

스킬명이 ‘이미지보안’이고 파라미터명을 ‘secureimage’로 설정한 상태에서 사용자가 이미지를 전송했을 때 호출되는 payload는 아래와 같습니다.

{
  "action": {
    "name": "이미지보안",
    "clientExtra": null,
    "params": {
      "secureimage": "{\"privacyAgreement\":\"Y\",\"imageQuantity\":\"1\",\"secureUrls\":\"List(http://secure.kakaocdn.net/dna/O5UOr/K6auLPnoAf/XXX/img.jpg?credential=Kq0eSbCrZgKIq51jh41Uf1jLsUh7VWcz&expires=1542358548&allow_ip=&allow_referer=&signature=fDuwSKWhQP%2FJdp0nKdunC4XDW%2BM%3D)\",\"expire\":\"1970-01-19T05:25:58+0900\"}"
    },
    "id": "5ab1cb5c9418c22b668807d4",
    "detailParams": {
      "secureimage": {
          "origin": "List(http://secure.kakaocdn.net/dna/O5UOr/K6auLPnoAf/XXX/img.jpg?credential=Kq0eSbCrZgKIq51jh41Uf1jLsUh7VWcz&expires=1542358548&allow_ip=&allow_referer=&signature=fDuwSKWhQP%2FJdp0nKdunC4XDW%2BM%3D)",
          "value": "{\"privacyAgreement\":\"Y\",\"imageQuantity\":\"1\",\"secureUrls\":\"List(http://secure.kakaocdn.net/dna/O5UOr/K6auLPnoAf/XXX/img.jpg?credential=Kq0eSbCrZgKIq51jh41Uf1jLsUh7VWcz&expires=1542358548&allow_ip=&allow_referer=&signature=fDuwSKWhQP%2FJdp0nKdunC4XDW%2BM%3D)\",\"expire\":\"1970-01-19T05:25:58+0900\"}",
          "groupName": ""
      }
    }
  }
}

위치전송 플러그인

위치전송 플러그인이란?

위치전송 플러그인은 사용자가 봇 작업자에게 위치 정보를 전송할 수 있도록 지도를 통해 장소를 지정하여 입력받는 역할을 합니다. 봇 작업자가 설계한 말풍선에서 사용자가 위치 입력을 위한 버튼 클릭 시 지도가 뜨며, 사용자의 현재 위치 정보를 입력할 수 있습니다.

사전 설정하기

챗봇 관리자센터에서 위치전송 플러그인을 사용하시려면 아래와 같은 사전 설정이 필요합니다.

Step 1. 카카오싱크 설정하기

위치전송 플러그인을 사용하기 위해서는 비즈니스 인증을 통한 카카오싱크 설정이 필수입니다. 이때, 싱크1단계(비즈 채널-앱 연결)만으로 플러그인을 사용할 수 있습니다.

Information.

카카오톡 비즈니스 채널(인증된 프로필)과 디벨로퍼스 비즈 앱 생성 방법 및 카카오싱크 신청하는 방법은 카카오싱크 공통 가이드에서 상세하게 확인할 수 있습니다.

카카오 디벨로퍼스에서 위에서 만든 비즈니스 인증을 받은 채널과 앱을 연결할 수 있습니다. 이때, 카카오 비즈니스 인증 채널을 신청하실 때에는 실제 서비스에서 사용할 카카오톡 채널로 신청해야 합니다.

Step 2. 위치사업자 검수 요청하기

싱크1단계가 완료되면 위치기반 사업자임을 증빙하기 위해 카카오 고객센터 문의하기를 통해 위치사업자 검수를 요청합니다. 카카오비즈니스 관리자센터 문의하기 내 비즈플러그인 > 플러그인 등록하기 카테고리를 이용합니다.

신청자 계정은 비즈 앱 및 비즈니스 채널에 권한이 있어야 하며, 신청하는 사업자의 소속임을 증빙해야 합니다. 권한 신청시 필요한 항목은 아래와 같습니다.

카카오계정(이메일주소)
사업자등록증상의 업체명
사업자등록번호
비즈 앱 ID
신청하는 정보와 수집조건을 검수 할 수 있는 증빙자료 제출 -위치기반서비스 사업자라는 증빙(자사 사이트 위치기반 서비스 이용약관 URL, 부득이한 경우 자격서류 등)
기타 첨부서류 : 비즈 앱, 약관의 사업자정보와 일치하는 사업자등록증, 재직증명서 필수 첨부

Step 3. 디벨로퍼스 설정하기

제품 설정 > 카카오 로그인 메뉴에서 '활성화 설정' 상태를 반드시 ON으로 변경해주세요.

Step 4. 비즈플러그인에서 위치전송 플러그인 등록하기

사전 설정이 완료되면 카카오비즈니스 관리자센터의 비즈플러그인 메뉴에서 위치전송 플러그인을 등록하여 플러그인ID를 발급받을 수 있습니다.

(1) 비즈플러그인 등록하기를 클릭합니다.

(2) 위치전송 플러그인을 사용하고자하는 비즈앱을 선택합니다.

(3) 플러그인 목적 선택시 '위치 전송'를 선택합니다. 위치전송 플러그인은 앱별로 1개 생성이 가능합니다.

Caution. 아래 경우 위치전송 플러그인 선택이 불가능합니다.

위치사업자 검수가 완료되지 않은 경우
이미 해당 앱에 생성된 위치전송 플러그인이 있는 경우

(4) 플러그인 이름 및 사용 목적, 상세주소 노출 여부를 입력한 후 [등록] 버튼을 클릭하면 위치전송 플러그인 등록 및 플러그인ID 발급이 완료됩니다. 입력한 사용목적은 카카오의 위치기반서비스 이용약관 내 위치정보 제공 현황 자세히 보기 페이지에 노출됩니다.

Information. 이미 생성된 위치전송 플러그인에서 상세주소 기능을 설정하고 싶은 경우, 플러그인 상세 화면 > 플러그인 속성 편집에서 상세주소 ON/OFF 설정이 가능합니다.

Step 5. 챗봇 관리자센터와 채널 연결하기

위치전송 플러그인이 정상적으로 동작하기 위해서는 반드시 동일한 앱에 연결된 운영 채널과 개발 채널이 모두 봇과 연결되어 있어야 합니다. 이때, 채널 관리자 센터에서 개발자용 채널을 생성하면 더욱 쉽게 연결을 준비할 수 있습니다.

Information. 개발자용 채널 생성하기 개발자용 프로필은 카카오톡 채널 관리자 센터에서 제공하는 기능으로 기존 생성된 프로필의 친구들에게 영향을 주지 않고 비즈니스 인증 채널에 제공되는 다양한 기능을 테스트해 볼 수 있는 프로필을 신규 생성하는 기능입니다. 자세히보기

(1) 카카오톡 채널 관리자 센터 > 내 채널 목록에서 개발자용 채널을 생성합니다.

(2) 개발자용 프로필을 생성한 후, 카카오싱크 페이지에서 싱크 검수 완료된 비즈 앱과 추가로 연결합니다.

(3) 챗봇 관리자센터의 설정 메뉴 > 기본 정보에서 운영 채널과 개발 채널을 모두 연결합니다.

챗봇 관리자센터 연동하기

사전 설정을 완료한 후 일반블록의 필수 파라미터 생성을 통해 위치전송 플러그인을 설정할 수 있습니다.

Step 1. 인증블록 설정하기

(1) 파라미터 생성 팝업 내 플러그인 목록에서 위치전송 플러그인(@sys.plugin.current_location)을 선택한 후 파라미터 설정을 완료합니다.

(2) 필수 파라미터가 지정된 상태에서 '되묻기 질문'을 클릭합니다.

(3) 되묻기 질문 작성 팝업에서 사용자들이 플러그인 실행을 위해 접하게 되는 말풍선의 가이드 문구와 버튼명을 설정할 수 있습니다.

Step 2. 데이터 전달방식 확인하기

(1) 개인정보를 포함한 정보를 전달하기 때문에 OTP URL 전송방식을 이용합니다.

(2) appUserId는 plain text로 전달되며 위치정보는 OTP URL에 포함되어 있습니다.

(3) 전달된 OTP URL을 이용해 위치 정보를 조회하고자 하는 경우, 위치전송 플러그인 개발 가이드를 참고해주시기 바랍니다.

OTP URL을 통해 위치 정보를 아래와 같은 포맷으로 전송받을 수 있습니다.

타입	포멧	예시
현위치	latitude : 위도 (좌표계 : WGS84) longitude : 경도 (좌표계 : WGS84) land_address : 지번 주소 정보 road_address : 도로명 주소 정보 detail : 상세주소(동/호수 등 사용자가 직접 입력한 정보)	{ "latitude": 37.40201073377386, "longitude": 127.10849451749681, "land_address": { "address_name": "경기 성남시 분당구 삼평동 681", "region_1depth_name": "경기", "region_2depth_name": "성남시 분당구", "region_3depth_name": "삼평동", "mountain_yn": "N", "main_address_no": "681", "sub_address_no": "" }, "road_address": { "address_name": "경기도 성남시 분당구 판교역로 235", "region_1depth_name": "경기", "region_2depth_name": "성남시 분당구", "region_3depth_name": "", "road_name": "판교역로", "underground_yn": "N", "main_building_no": "235", "sub_building_no": "", "building_name": "에이치스퀘어 엔동", "zone_no": "13494" } "detail" : "8층 카카오" }

타입

포멧

예시

현위치

latitude : 위도 (좌표계 : WGS84)

longitude : 경도 (좌표계 : WGS84)

land_address : 지번 주소 정보

road_address : 도로명 주소 정보

detail : 상세주소(동/호수 등 사용자가 직접 입력한 정보)

{ "latitude": 37.40201073377386, "longitude": 127.10849451749681, "land_address": { "address_name": "경기 성남시 분당구 삼평동 681", "region_1depth_name": "경기", "region_2depth_name": "성남시 분당구", "region_3depth_name": "삼평동", "mountain_yn": "N", "main_address_no": "681", "sub_address_no": "" }, "road_address": { "address_name": "경기도 성남시 분당구 판교역로 235", "region_1depth_name": "경기", "region_2depth_name": "성남시 분당구", "region_3depth_name": "", "road_name": "판교역로", "underground_yn": "N", "main_building_no": "235", "sub_building_no": "", "building_name": "에이치스퀘어 엔동", "zone_no": "13494" } "detail" : "8층 카카오" }

※ OS 버전에 따라 주소 형식에 차이가 존재할 수 있습니다.

※ 상세주소("detail" 필드)는 위치전송 플러그인 상세설정 > 상세주소 ON 일 경우에만 데이터가 전달됩니다.

※ 위치정보를 전달할 수 없는 경우 otp url에 x,y 좌표 대신 하기 내용이 포함됩니다.

Example. "is_usable_user" : false

프로필이용 플러그인

프로필이용 플러그인이란?

카카오톡 채팅방(봇)에서 사용자의 정보가 필요한 경우, 프로필이용 플러그인을 통해 사용자 정보 수집 및 동의처리를 화면 전환 없이 수행할 수 있습니다.

Information.

[받을 수 있는 정보 종류] 프로필 정보, 이메일, 전화번호, 배송지정보, 성별, 연령대, 생일, 출생연도, *CI *CI(연계정보)는 '회원비교식별' 목적으로 활용하며, 보유기간은 '제공목적(회원비교식별)'이 달성되면 지체없이 파기해야 합니다.

사전 설정하기

챗봇 관리자센터에서 프로필이용 플러그인을 사용하시려면 아래와 같은 사전 설정이 필요합니다.

Step 1. 카카오싱크 설정하기

프로필이용 플러그인을 사용하기 위해서는 비즈니스 인증을 통한 카카오싱크 설정이 필수입니다. 회원가입 체계가 없는 사업자라도 싱크 설정(비즈 채널-앱 연결)만으로 프로필이용 플러그인을 사용할 수 있습니다.

Information.

카카오톡 비즈니스 채널(인증된 프로필)과 디벨로퍼스 비즈 앱 생성 방법 및 카카오싱크 신청하는 방법은 카카오싱크 공통 가이드에서 상세하게 확인할 수 있습니다.

(1) 비즈니스 채널과 앱 연결하기

채널-앱 연결만 완료했을 경우 수집할 수 있는 개인정보는 아래와 같습니다.

프로필 정보(닉네임/프로필 사진)
이메일
전화번호

(2) 카카오싱크 검수 신청하기

만일, 프로필 정보/전화번호/이메일 외에 추가로 수집하고자 하는 정보가 있다면 카카오싱크 검수까지 완료하셔야 합니다. 채널-앱 연결을 완료한 후, 싱크 검수 단계에서 신청 권한 선택 시 반드시 '②카카오 로그인시 개인정보제공 항목 검수'를 포함하여 신청해야 프로필이용 플러그인 이용시 수집 가능한 항목이 추가됩니다.

Step 2. 디벨로퍼스 설정하기

제품 설정 > 카카오 로그인 메뉴에서 '활성화 설정' 상태를 반드시 ON으로 변경해주세요.

Step 3. 챗봇 관리자센터와 채널 연결하기

챗봇 관리자센터에서 프로필이용 플러그인을 설정하기 위해서는 반드시 동일한 앱에 연결된 운영 채널과 개발 채널이 모두 봇과 연결되어 있어야 합니다. 이때, 채널 관리자 센터에서 개발자용 채널을 생성하면 더욱 쉽게 연결을 준비할 수 있습니다.

(1) 카카오톡 채널 관리자 센터 > 내 채널 목록에서 개발자용 채널을 생성합니다.

(2) 개발자용 프로필을 생성한 후, 카카오싱크 페이지에서 싱크 검수 완료된 비즈 앱과 추가로 연결합니다.

(3) 챗봇 관리자센터의 설정 메뉴 > 기본 정보에서 운영 채널과 개발 채널을 모두 연결합니다.

(4) 위 설정까지 완료했다면, 시나리오 > 기본 시나리오에 인증블록이 추가된 것을 확인하실 수 있습니다.

챗봇 관리자센터 연동하기

사전 설정을 완료한 후 인증블록의 필수 파라미터 생성을 통해 프로필이용 플러그인을 설정할 수 있습니다.

Step 1. 인증블록 설정하기

(1) 파라미터 생성 팝업 내 플러그인 목록에서 프로필이용 플러그인(@sys.plugin.profileshare)을 선택한 후 파라미터 설정을 완료합니다.

(2) 필수 파라미터가 지정된 상태에서 '되묻기 질문'을 클릭합니다.

(3) 되묻기 질문 작성 팝업에서 사용자들이 플러그인 실행을 위해 접하게 되는 말풍선의 가이드 문구와 버튼명을 설정할 수 있습니다.

(4) 되묻기 질문 작성 팝업에서 [버튼명 입력] 버튼을 클릭하면 프로필이용 플러그인을 통해 수집할 수 있는 개인정보 제공 동의 항목을 확인 및 선택할 수 있습니다.

Information.

채널-앱 연결(싱크 1단계) 완료, 싱크 검수(싱크 2단계) 미완료시에는 프로필 정보, 전화번호, 이메일만 사용 가능합니다.
상세 화면에 노출되는 개인정보 제공 동의 항목은 카카오 디벨로퍼스의 '내 애플리케이션 > 제품설정 > 카카오 로그인 > 동의항목'에서 설정할 수 있습니다.

Step 2. 인증블록 연결하기

인증블록 설정 및 저장이 완료되면, 챗봇 시나리오 상 프로필이용 플러그인 실행이 필요한 블록에서 인증블록을 연결합니다. 봇 응답(말풍선) 내 버튼의 '블록연결' 기능을 통해 프로필이용 플러그인이 설정된 인증블록을 연결시킬 수 있습니다. 인증블록이 정상적으로 저장되지 않은 경우, 연결 가능한 블록 목록에 노출되지 않을 수 있습니다.

Step 3. 데이터 전달방식 확인하기

(1) 개인정보를 포함한 정보를 전달하기 때문에 OTP URL 전송방식을 이용합니다.

(2) appUserId는 plain text로 전달되며 개인정보는 OTP URL에 포함되어 있습니다.

(3) 전달된 OTP URL을 이용해 사용자 정보를 조회하고자 하는 경우, 사용자 정보 요청 API(OTP API) 가이드를 참고해주시기 바랍니다.

카카오싱크 플러그인

카카오싱크 플러그인이란?

카카오톡 채널 채팅방에서 봇 서비스 제공 중 회원 가입 및 정보 연동이 필요한 경우, 카카오싱크 플러그인을 통해 화면 전환 없이 채널 채팅방 안에서 회원 가입 절차를 수행할 수 있습니다. 카카오싱크 플러그인(이하 싱크 플러그인)은 채팅방에 자연스럽게 노출되는 형태로 사용자 정보 제공 및 약관 동의 팝업을 제공, 카카오계정으로 서비스에 가입할 수 있는 카카오싱크의 간편가입 기능을 카카오톡에서 봇과의 대화 중에도 쓸 수 있도록 해 줍니다. REST API 방식의 카카오 로그인 기반으로 회원가입 연동이 가능하며, 이미 카카오 로그인이 구현된 서비스에서는 보다 쉽게 적용할 수 있습니다.

Information. [받을 수 있는 정보 종류]

사용자관리 제공 정보 : 프로필 정보, 이메일, 전화번호, 배송지정보, 성별, 연령대, 생일, 출생연도, *CI *CI(연계정보)는 '회원비교식별' 목적으로 활용하며, 보유기간은 '제공목적(회원비교식별)'이 달성되면 지체없이 파기해야 합니다.

[설정할 수 있는 약관 종류]

해당 서비스의 약관 : 필수 약관, 선택 약관 (필요시, 개정된 약관의 동의도 가능)

사전 설정하기

챗봇 관리자센터에서 싱크 플러그인을 사용하시려면 아래와 같은 설정이 필요합니다.

Step 1. 카카오싱크 설정하기

싱크 플러그인을 사용하기 위해서는 비즈니스 인증을 통한 카카오싱크 설정이 필수입니다.

Information.

서비스에서 로그인 Redirect URI를 통해 정보 조회를 위한 'code' 값과 회원가입 완료 또는 추가 맵핑 등에 필요한 'continue URL' 값을 전달받게 되며, 자세한 내용은 카카오싱크 플러그인 개발가이드를 확인해주시기 바랍니다. Redirect URI은 테스트앱을 사용해야 하는데 챗봇에서는 일반앱 등록이 필요합니다. 위와 같이 테스트앱을 사용해야 하는 경우 테스트용 봇을 하나 더 생성하시고 해당 봇에서 Redirect URI를 테스트하신 후 문제없을 시 기존 앱에 적용할 수 있습니다.

(1) 비즈니스 채널과 앱 연결하기

(2) 카카오싱크 검수 신청하기

채널-앱 연결을 완료한 후, 싱크 검수를 요청합니다.

Step 2. 디벨로퍼스 설정하기

(1) 제품 설정 > 카카오 로그인 메뉴에서 '활성화 설정' 상태를 ON으로 변경해주세요.

(2) 제품 설정 > 카카오 로그인 > 간편가입 메뉴에서 '사용 여부' 상태를 ON으로 변경해주세요.

(3) 제품 설정 > 간편가입 메뉴에서 카카오싱크 플러그인 Redirect URI를 입력해주세요.

Information. 서비스에서 로그인 Redirect URI를 통해 정보 조회를 위한 'code' 값과 회원가입 완료 또는 추가 맵핑 등에 필요한 'continue URL' 값을 전달받게 되며, 자세한 내용은 카카오싱크 플러그인 개발가이드를 확인해주시기 바랍니다.

Step 3. 비즈플러그인에서 카카오싱크 플러그인 등록하기

사전 설정이 완료되면 카카오비즈니스 관리자센터의 비즈플러그인 메뉴에서 카카오싱크 플러그인을 등록하여 플러그인ID를 발급받을 수 있습니다.

(1) 비즈플러그인 등록하기를 클릭합니다.

(2) 싱크 플러그인을 사용하고자하는 비즈앱을 선택합니다.

(3) 플러그인 목적 선택시 '카카오싱크'를 선택합니다. 싱크 플러그인은 앱별로 1개 생성이 가능합니다.

Caution. 아래 경우 카카오싱크 플러그인 선택이 불가능합니다.

카카오싱크 검수가 완료되지 않은 경우
디벨로퍼스 설정에 오류가 있는 경우
이미 해당 앱에 생성된 카카오싱크 플러그인이 있는 경우

(4) 플러그인 이름을 설정한 후 [등록] 버튼을 클릭하면 카카오싱크 플러그인 등록 및 플러그인ID 발급이 완료됩니다.

Step 4. 챗봇 관리자센터와 채널 연결하기

인증블록에서 설정한 플러그인이 정상적으로 동작하기 위해서는 반드시 동일한 앱에 연결된 운영 채널과 개발 채널이 모두 봇과 연결되어 있어야 합니다. 이때, 채널 관리자 센터에서 개발자용 채널을 생성하면 더욱 쉽게 연결을 준비할 수 있습니다.

Information. 개발자용 채널 생성하기 개발자용 프로필은 카카오톡 채널 관리자 센터에서 제공하는 기능으로 기존 생성된 프로필의 친구들에게 영향을 주지 않고 비즈니스 인증 채널에 제공되는 다양한 기능을 테스트해 볼 수 있는 프로필을 신규 생성하는 기능입니다. 자세히보기

(1) 카카오톡 채널 관리자 센터 > 내 채널 목록에서 개발자용 채널을 생성합니다.

(2) 개발자용 프로필을 생성한 후, 카카오싱크 페이지에서 싱크 검수 완료된 비즈 앱과 추가로 연결합니다.

(3) 챗봇 관리자센터의 설정 메뉴 > 기본 정보에서 운영 채널과 개발 채널을 모두 연결합니다.

(4) 위 설정까지 완료했다면, 시나리오 > 기본 시나리오에 인증블록이 추가된 것을 확인하실 수 있습니다.

챗봇 관리자센터 연동하기

사전 설정을 완료한 후 인증블록의 필수 파라미터 생성을 통해 카카오싱크 플러그인을 설정할 수 있습니다.

Step 1. 인증블록 설정하기

(1) 파라미터 생성 팝업 내 플러그인 목록에서 카카오싱크 플러그인(@sys.plugin.sync)을 선택한 후 파라미터 설정을 완료합니다. 플러그인 목록에는 싱크 플러그인 생성시 입력한 플러그인 이름이 노출됩니다.

(2) 필수 파라미터가 지정된 상태에서 '되묻기 질문'을 클릭합니다.

플러그인은 필수 파라미터로 설정해야하며, 되묻기 상황을 정의해야 사용할 수 있습니다.

(3) 되묻기 질문 작성 팝업에서 사용자들이 플러그인 실행을 위해 접하게 되는 말풍선의 가이드 문구와 버튼명을 설정할 수 있습니다. 이때, [버튼명 입력] 버튼을 클릭하면 싱크 플러그인을 통해 수집할 수 있는 개인정보 제공 동의 항목을 확인할 수 있습니다.

Information. 개인정보 제공 동의 항목은 카카오 디벨로퍼스의 '내 애플리케이션 > 제품설정 > 카카오 로그인 > 동의항목'에서 수정할 수 있습니다.

Step 2. 인증블록 연결하기

인증블록 설정 및 저장이 완료되면, 챗봇 시나리오 상 싱크 플러그인 실행이 필요한 블록에서 인증블록을 연결합니다. 봇 응답(말풍선) 내 버튼의 '블록연결' 기능을 통해 싱크 플러그인이 설정된 인증블록을 연결시킬 수 있습니다. 인증블록이 정상적으로 저장되지 않은 경우, 연결 가능한 블록 목록에 노출되지 않을 수 있습니다.