LogoLogo
카카오비즈니스비즈니스관리자
  • 카카오비즈니스 가이드
  • 카카오비즈니스 바로가기
  • 비즈니스 세미나 바로가기
  • 비즈니스 시작하기
    • 카카오비즈니스 통합 가입
  • 채널
    • 소개
    • 채널 만들기
    • 운영하기
      • 대시보드
      • 프로필
      • 소식
      • 메시지
      • 비즈니스도구
      • 채팅
      • 통계/관리
      • 월렛/캐시 (비즈월렛)
      • 서비스 연결
    • FAQ
  • 광고
    • 소개
    • 카카오모먼트
      • 퀵스타트 가이드
      • 광고 유형
        • 카카오 비즈보드
          • 캠페인 만들기
          • 광고그룹 만들기
          • 소재 만들기
          • 카카오 비즈보드 제작가이드
          • 익스팬더블
        • 카카오 비즈보드 CPT
          • 집행 프로세스
            • 캠페인 만들기
            • 광고그룹 만들기
            • 소재 만들기
          • 제작가이드
          • 제한업종
          • 모션 비즈보드
            • 제작가이드
          • 커스텀 비즈보드
            • 제작가이드
        • 디스플레이 광고
          • 캠페인 만들기
          • 광고그룹 만들기
          • 소재 만들기
          • 디스플레이 광고 제작가이드
        • 브랜딩 디스플레이 광고
          • 집행 프로세스
          • 리치팝 올데이
            • 광고 만들기
            • 제작가이드
          • 포커스 보드
            • 광고 만들기
            • 제작가이드
          • 제한업종
        • 포커스 풀뷰beta
          • 집행 프로세스
          • 광고 만들기
          • 제작가이드
          • 제한업종
        • 프로필 풀뷰beta
          • 집행 프로세스
          • 광고 만들기
          • 제작 가이드
          • 제한업종
        • 동영상 광고
          • 캠페인 만들기
          • 광고그룹 만들기
          • 소재 만들기
          • 동영상 광고 제작가이드
        • 채널 메시지
          • 캠페인 만들기
          • 광고그룹 만들기
          • 소재 만들기
          • 메시지 만들기
            • 메시지 등록
            • 메시지 발송 설정
            • 메시지 대시보드
            • 메시지 보고서
          • 채널 메시지 제작가이드
          • 채널 메시지 집행가이드
          • 채널 메시지 발송 유의사항
        • 개인화 메시지
          • 사전 준비하기
          • 캠페인 만들기
          • 광고그룹 만들기
          • 소재 만들기
          • 개인화 메시지 제작가이드
        • 쇼핑 광고
          • 캠페인 만들기
          • 광고그룹 만들기
          • 소재 만들기
          • 쇼핑 광고 제작가이드
        • 상품 카탈로그
          • 캠페인 만들기
          • 광고그룹 만들기
          • 소재 만들기
          • 트래킹 URL 입력가이드
          • 상품 카탈로그 제작가이드
      • 지표 확인하기
        • 대시보드
        • 보고서
        • SKAdNetwork
      • 운영하기
        • 광고자산 관리
        • 타겟 관리
        • 계정 관리
        • 결제 관리
        • 전환 최적화 가이드
          • 전환 최적화 점검가이드
          • FAQ
        • 카카오 클릭 ID 랜딩 테스트 가이드
        • 동영상 조회수 연동 관리
        • 광고계정 운영 가이드
        • 광고 집행 권장사항
      • 심사가이드
        • 집행 기준 및 준수사항
        • 제한업종
        • 업종별 가이드
        • 소재 구성 가이드
    • 검색 광고
      • 키워드광고
        • 광고 만들기
        • 제작가이드
        • 운영하기
          • 소재 관리
          • 도구 관리
          • 효율 관리
          • 계정 관리
          • 결제 관리(비즈월렛)
          • 광고계정 운영 가이드
        • 심사가이드
          • 제한업종
          • 업종별가이드
          • 등록기준
      • 브랜드검색 광고
        • 광고 만들기
        • 제작가이드
        • 운영하기
          • 도구 관리
          • 효율 관리
          • 계정 관리
          • 결제 관리(비즈월렛)
          • 광고계정 운영 가이드
        • 심사가이드
          • 업종별가이드
          • 키워드/소재가이드
      • 톡채널검색
        • 광고 만들기
        • 제작가이드
        • 심사가이드
          • 제한업종
          • 업종별가이드
          • 등록기준
    • 브랜드 메시지
    • 알림톡
      • 알림톡 제작가이드
        • 이미지형 제작가이드
      • 알림톡 심사가이드
        • 알림톡 화이트리스트
        • 알림톡 블랙리스트
      • 메시지 발송 유의사항
    • 상담톡
    • 카카오쇼핑 광고센터
      • 광고 그룹
      • 광고선택 및 계약
      • 광고센터 월렛 생성하기
      • 지불 방식
      • 광고 집행
      • 대시보드
      • 리포트 (준비중)
      • 광고상품 소개서
    • 기타 광고 서비스
      • 브랜드이모티콘
        • 상품가이드
    • 광고피해신고
      • 광고 차단/신고 안내
      • 불법영업 피해 예방
  • 서비스/도구
    • 카카오싱크
      • 설계하기
      • 도입하기
      • 활용하기
      • FAQ
    • 톡체크아웃
      • 가입하기
      • 판매 관리
      • 정산 관리
      • 고객혜택 관리
      • 고객 관리
      • 판매점정보
      • 고객확인정보
      • 통계
      • 판매점 정책서
        • 판매점 입점 조건
        • 입점 심사 정책
        • 서비스 이용 규칙
    • 카카오톡 예약하기
      • 시작하기
      • 입점
      • 예약
      • 쿠폰
      • 정산
      • 통계
      • 관리
      • 장소
      • 상품
        • 시간예약형
        • 날짜/시간형
        • 날짜형
        • 상시형
        • 병원 예약형
        • 네일샵형
      • 메시지
      • 홍보
    • 카카오톡 주문하기
      • 입점하기
      • 운영하기
    • 카카오맵 매장관리
      • 가입하기
      • 매장 등록
      • 매장 수정/관리
      • 카카오맵 전용번호 관리
      • 소식/후기 관리
      • 매장 삭제/대표자 변경
      • 운영자 관리
    • 비즈니스폼
      • 만들기
      • 활용하기
      • 확인하기
      • 참고하기
    • 비즈플러그인
      • 만들기
      • 확인하기
      • 활용하기
    • 픽셀 & SDK
      • 서비스/도구 > 픽셀 & SDK
      • 픽셀 & SDK 연동 관리
      • 픽셀 & SDK 만들기
      • 카카오 픽셀 헬퍼(Pixel Helper)
      • 카카오 클릭 ID (kclid)
    • 카탈로그
    • 이미지 에디터
    • 챗봇 관리자센터
      • 시작하기
        • 챗봇 관리자센터 개요
        • 챗봇 관리자센터 준비하기
        • 챗봇 도우미
      • 튜토리얼
        • 챗봇 기획하기
        • 챗봇 만들기
          • 튜토리얼 1단계
          • 튜토리얼 2단계
          • 튜토리얼 3단계
        • 알아두면 유용한 팁!
        • 챗봇 제작 팁
      • 주요개념
        • 시나리오
        • 엔티티
        • 블록
        • 발화 패턴
        • 파라미터 설정
        • 응답 설정
        • 컨텍스트
        • Event API
        • 플러그인
        • 스킬
        • 배포
        • 학습
        • 통계
        • 인사이트
        • 권한
        • 봇테스트
        • 작업이력
        • 관리자
        • 봇 설정
        • 알림센터
        • 지식베이스
        • 머신러닝
        • ML+
        • 월렛
        • 내 정보
      • 스킬 개발 가이드
        • 스킬 만들기
        • 블록에 스킬 적용하기
        • 플러그인에 스킬 적용하기
        • 응답 타입별 JSON 포맷
        • 스킬 오류 내역 확인하기
        • AI 챗봇 콜백 개발 가이드
      • 기타
    • 지식
      • 주요 개념들
        • 지식 베이스
        • 지식
        • 카테고리
        • 작업 이력
        • 배포 이력
        • 관리자
        • 설정
    • 선물하기 for Biz
      • 회원가입
      • 선물발송
      • 취소/환불
      • 증빙
      • 선물발송도구
        • 이벤트메이커
        • 임직원/거래처 목록 관리
        • 기념일 예약 선물
        • 오픈API
    • 카카오톡 스토어
      • 입점하기
      • 카카오톡 채널 연동
      • 스토어/판매자 정보관리
      • 상품/리뷰관리
      • 고객혜택관리
      • 판매관리
      • 마케팅 메시지 관리
      • 통계
      • 정산관리
      • 스토어보드 발행 및 관리
      • 라이브 관리
      • 카카오톡 브랜드스토어
    • 비즈월렛
      • 비즈월렛 생성하기
      • 비즈월렛 운영하기
        • 연결/변경/해제/삭제
        • 멤버 초대 및 관리자 요청
        • 비즈월렛 알림
      • 비즈월렛 결제관리
        • 캐시 관리
        • 결제 카드 관리
        • 증빙 서류 관리
    • 카카오톡 지갑
      • 가입하기
      • 입장하기
        • MY BIZ
        • 대시보드
      • 이용기관 등록하기
        • 딜러사
          • 이용기관 등록
          • 기관 추가
        • 이용기관
          • 등록 정보 확인
          • 채널 정보 등록
          • 앱 정보 등록
      • 이용기관 관리하기
        • 딜러사
          • 이용기관 조회
          • 기관 조회
          • 기관 수정
        • 이용기관
          • 기관 조회
          • 기관 수정
      • 계약 관리하기
        • 딜러사
          • 딜러계약 조회
          • 이용기관 계약조회
          • 이용기관 계약추가
        • 이용기관
          • 계약 조회
          • 계약 추가
      • 정보 관리하기
      • 사용량 조회하기
      • 정산 관리하기
  • 파트너 지원 프로그램
    • 카카오광고 고객센터
      • 광고계정 맞춤 컨설팅
      • 문의게시판
      • 원격지원서비스
    • 광고주 성장 프로그램
      • 지원 프로그램
      • 스타터 리워드 프로그램
    • 카카오 RTB 연동
      • Bid Specification
      • Appendix
      • Sample
    • 크로스미디어
      • 제작가이드
    • 공식 대행사 리스트
      • KPP
      • ㄱ~ㅂ
      • ㅅ~ㅇ
      • ㅈ~ㅎ
    • 소상공인 지원 혜택
      • 비즈월렛 확인하는 방법
      • 비즈월렛 만드는 방법
      • 메시지 발송 비용 충전 확인하기
      • 카카오톡 채널 활성화 방법
        • 채널 기본 세팅
          • 채널 생성
          • 비즈월렛 생성
          • 소식 작성
          • 웰컴메시지
          • 채널홈 설정
        • 채널 응용 기능
          • 1:1 채팅 활성화
          • 채널추가 요청 메시지
          • 자주 쓰는 답변 관리
          • 채팅방 메뉴
          • 간편 채팅
          • 챗봇
        • 채널 친구 모으기
          • 카카오톡 채널 URL 활용하기
          • 1:1 채팅을 통한 추가 인증
          • 온/오프라인 홍보 도구
        • 채널 메시지 보내기
          • 메시지 보내기
          • 메시지 보내기(쿠폰형)
        • 서비스/비즈 도구 활용
          • 상담톡
          • 카카오싱크
          • 카카오톡 예약하기
          • 알림톡
          • 톡체크아웃
          • 카카오톡 스토어
          • 카카오맵 매장관리
    • 카카오비즈니스 자격증
      • 출제 범위 및 학습 콘텐츠
  • 개발자 지원 가이드
    • 카카오디벨로퍼스
    • 챗봇 관리자센터
Powered by GitBook
On this page
  • 블록과 스킬 연결하기
  • 응답설정을 값으로 사용하기
  • Step 1. 스킬 서버에서 응답값 설정
  • Step 2. 챗봇 관리자센터에서 응답형식(말풍선) 선택 및 값 입력
  • Step 3. 해당 블록을 호출하여 테스트
  • 응답설정을 스킬로 사용하기
  • 블록 Output 컨텍스트 스킬로 제어하기
  • 컨텍스트 정보를 스킬 응답(response)에서 활용하기
  • ContextControl

Was this helpful?

  1. 서비스/도구
  2. 챗봇 관리자센터
  3. 스킬 개발 가이드

블록에 스킬 적용하기

Previous스킬 만들기Next플러그인에 스킬 적용하기

Last updated 1 year ago

Was this helpful?

내가 만든 스킬 기능을 챗봇 관리자센터의 블록에 바로 붙여봅시다.

스킬을 정의하고, API URL을 등록한 다음 블록의 파라미터 설정에서 연결하면 끝! 이보다 간편한 외부시스템과의 연결은 없습니다. 스킬 연동과 함께 내가 만든 블록의 기능을 200% 활용해보시기 바랍니다.

이제 더이상 모바일 앱을 개발하지 않아도 ‘봇’만으로 간단한 사용자 응대 서비스를 뚝딱 만들어낼 수 있게 되었습니다.

블록과 스킬 연결하기

블록에 스킬을 연결하면 더욱 동적인 응답을 만들어낼 수 있습니다.

아래 화면과 같은 환율블록에서 “오늘 달러 환율 얼마야?”와 같은 질문에 실시간으로 변경되는 환율값으로 응답으로 주고 싶다면, 스킬 연결을 통해 구현할 수 있습니다.

스킬 연결을 하기 위해서는 1) 파라미터 설정을 클릭하여 2) 스킬 선택 목록을 펼친 뒤 미리 등록한 스킬 이름을 선택하시면 됩니다. 스킬을 선택하시면 해당 스킬의 최신 버전이 자동으로 선택됩니다. 다른 버전을 원하시면 버전을 선택하실 수 있습니다.

이렇게 스킬을 연결되면 블록이 실행될 때 스킬이 작동하게되며, 그것의 결과를 응답형식 설정에서 이용함으로써 더욱 다양한 응답을 생성할 수 있습니다.

응답설정을 값으로 사용하기

챗봇 관리자센터의 봇 응답형식 설정(말풍선 설정)에서 스킬 서버의 응답값을 텍스트 영역에 사용할 수 있습니다. 기본적으로 {{#webhook.<json_path>}}과 같은 형태로 사용합니다. 아래의 과정을 통해 적용 방법을 확인해봅시다.

Step 1. 스킬 서버에서 응답값 설정

‘Ryan’이라는 유저에 대한 정보가 아래와 같은 값으로 스킬서버에서 응답하도록 설정합니다.

{
  "version": "2.0",
  "data": {
    "msg":"HI",
    "name":"Ryan",
    "position":"Senior Managing Director"
  }
}

Step 2. 챗봇 관리자센터에서 응답형식(말풍선) 선택 및 값 입력

챗봇 관리자센터에서 원하는 봇 응답형식을 선택합니다. 스킬 응답값은 말풍선 종류에 상관없이 텍스트를 입력하는 부분에 적용 가능합니다.

Step 3. 해당 블록을 호출하여 테스트

스킬 응답값이 적용 된 블록의 발화 패턴을 입력하여 결과를 확인해봅니다.

  • List 형태는 지원하지 않습니다.

  • 없는 값의 path를 지정하실 경우 비어있는 텍스트로 출력됩니다.

응답설정을 스킬로 사용하기

텍스트형, 이미지형 등 기본 형식 외에 스킬데이터만을 이용해 응답형식을 설정할 수 있습니다. 아래 이미지와 같이 봇 응답형식을 추가할 때, 기본 제공형태가 아닌 스킬데이터로 사용을 클릭하면 스킬데이터를 응답형식으로 사용할 수 있습니다.

블록 Output 컨텍스트 스킬로 제어하기

컨텍스트 정보를 스킬 응답(response)에서 활용하기

스킬 응답에서 ‘Output 컨텍스트’의 정보를 직접 업데이트 할 수 있습니다. 예를 들어 다음과 같은 스킬 응답 포맷이 있다고 하겠습니다.

  • 스킬 응답의 Structure 예시

{
  "version": "2.0",
  "template": {
    ...
  },
  "context": {
    "values": [{
      "name": ...,
      "lifeSpan": ...,
      "params": ...
    },{
      "name": ...,
      "lifeSpan": ...,
      "params": ...
    },
    ...
    ]
  }
}

다음처럼,

  • 복수의 Output 컨텍스트들 중 특정 컨텍스트만 Output 되도록 변경할 수 있습니다. → name

  • 컨텍스트의 수명(lifespan)을 변경할 수 있습니다. → lifeSpan

  • 컨텍스트와 관련해 전달하고 싶은 값을 추가할 수 있습니다. → params

스킬 응답의 Output 컨텍스트에 들어있는 내용이 현재 블록의 Output 컨텍스트란에 존재하는 경우에는, 스킬에 들어있는 값으로 현재 Output 컨텍스트를 덮어쓰기합니다.

Information.

인풋(Input)으로 설정한 컨텍스트가 만료될 경우 해당 블록은 설정된 응답이 아닌 폴백 메시지로 응답하게 됩니다. 폴백 메시지가 설정되어 있지 않으면 빈 말풍선이 나가게 되므로 기본 시나리오> 폴백블록 에서 설정 상태를 확인해 주세요.

컨텍스트 갱신

스킬 응답으로 컨텍스트를 수정하는 경우, 변경하려는 output 컨텍스트가 미리 블록에서 설정되어야 합니다. 스킬 응답의 context 필드는 값을 수정할 뿐, 새로운 output 컨텍스트를 만들 수는 없습니다.

Example.

예를 들어 abc 라는 output 컨텍스트를 블록에서 생성했다면, 스킬 응답으로 abc name을 가지는 context의 lieSpan, params를 수정할 수 있습니다. 하지만 def 라는 output 컨텍스트를 블록에서 생성하지 않은 상황에서, 스킬 응답으로 def라는 name을 가지는 context를 수정한다면 이는 반영되지 않습니다.

ContextControl

context control 필드는 블록에서 생성한 outputContext의 lifeSpan, params 등을 제어할 수 있습니다.

상세 필드

이름
타입
필수 여부
제한

values

ContextValue

O

ContextValue 상세 필드

이름
타입
필수 여부
설명

name

string

O

수정하려는 output 컨텍스트의 이름

lifeSpan

int

O

수정하려는 ouptut 컨텍스트의 lifeSpan

params

Map <string, string>

X

output 컨텍스트에 저장하는 추가 데이터

예제 코드

{
  "version": "2.0",
  "context": {
    "values": [
      {
        "name": "abc",
        "lifeSpan": 10,
        "ttl": 60,
        "params": {
          "key1": "val1",
          "key2": "val2"
        }
      },
      {
        "name": "def",
        "lifeSpan": 5,
        "params": {
          "key3": "1",
          "key4": "true",
          "key5": "{\"jsonKey\": \"jsonVal\"}"
        }
      },
      {
        "name": "ghi",
        "lifeSpan": 0
      }
    ]
  }
}
  • abc output 컨텍스트의 lifeSpan을 10, ttl을 60로, params의 key1에 val1, key2에 val2를 추가합니다.

  • def name을 갖는 ContextValue의 param처럼, 다른 타입들 또한 stringify 하여 저장할 수 있습니다.

  • ghi name을 갖는 ContextValue처럼, lifeSpan을 0으로 바꿔서 삭제할 수 있습니다.

오늘의 환율을 얻어오는 환율스킬은 있다고 가정하겠습니다. (에서 자세히 확인할 수 있습니다.)

스킬의 결과를 응답형식에서 이용하는 방법으로는 웹훅 객체(webhook)를 통한 방법()과 스킬에서 직접 말풍선을 구성해서 응답하는 방법()이 있습니다.

상세한 포맷 및 세부 내용은 에서 확인 가능합니다.

스킬 개발 가이드>스킬만들기
스킬 개발 가이드 > 응답 타입별 JSON포맷
스킬 개발 가이드 > 응답 설정을 값으로 사용하기
스킬 개발 가이드 > 응답 설정을 스킬로 사용하기
오늘 달러 환율을 응대할 수 있는 간단한 블록 생성
블록에 미리 등록해 둔 환율스킬을 연결
챗봇 관리자센터에서 응답형식을 값으로 입력한 예시
응답설정을 값으로 설정한 출력 화면 예시
스킬값을 응답형식으로 사용하기 위해 '스킬 데이터로 사용'을 선택합니다.
스킬데이터 사용으로 응답형식을 설정한 화면