보이스봇

보이스봇은 카카오미니를 통해 대화형 음성 인터페이스로 제공되는 봇을 일컫습니다. 카카오 고유의 AI기술과 음성인식 기술이 함께 빛을 발하는 똑똑한 봇을 경험해보세요!

Information.

한시적으로, 챗봇 관리자센터 OBT기간 동안 보이스봇 서비스는 beta 상태로 제휴를 통해 운영됩니다. 신청 후, 카카오팀으로부터 해당 권한을 획득해야 챗봇 관리자센터에서 보이스봇을 설계할 수 있으며, 설계가 완료된 보이스봇은 내부 심사를 거쳐 카카오미니의 음성 서비스로 제공할 수 있습니다.

향후 공개 서비스가 될 때까지 잠시만 기다려주세요!

보이스봇 설정하기

보이스봇 생성

챗봇 관리자센터 화면의 우측 상단의 ‘+’ 마크를 누르면, 챗봇과 보이스봇 만들기 버튼이 나옵니다. 보이스봇을 누르고, 보이스봇의 이름을 입력하면, 보이스봇을 생성할 수 있습니다. 보이스봇을 생성할 때 입력하신 봇 이름은 추후 헤이카카오앱의 플러그인 메뉴에 노출됩니다. 생성 중에는 이름을 자유롭게 변경할 수 있으나, 심사를 마친 후에 이름을 변경하고자 할 경우 카카오로 연락을 주셔야 합니다.

Caution.

변경이 수시로 이루어질 수 없으므로 이름은 신중하게 지어주시기 바랍니다.

보이스봇 설정

상단의 메뉴바에서 [설정 > 보이스봇 설정]으로 들어가면, 보이스봇의 기본 정보를 설정을 할 수 있습니다. 기본 정보 설정은 보이스봇 생성에 있어 필수 사항이 아니므로, 설정을 하지 않아도 보이스봇을 만들 수 있습니다. 심사 요청 전까지만 해당 정보를 입력해주시면 됩니다.

기본정보

• 보이스봇 대표 이미지 : 보이스봇을 대표하는 이미지로, 헤이카카오앱의 플러그인 메뉴에 노출됩니다.

• 봇 카테고리 : 봇의 속성을 설정하는 메뉴로, 2차 카테고리까지 선택 가능합니다. 추후 헤이카카오앱에서 플러그인 검색 시 사용됩니다.

• 서비스 호출어 : 사용자가 보이스봇을 시작하기 위해 부를 때 사용하는 이름입니다. 2자~10자 내외의 한글만 입력할 수 있습니다. 사용자가 기억하기 쉽고, 부르기 편한 짧은 단어로 만드는 것이 좋습니다. 서비스 호출어는 등록 시 “심사 가능 여부 체크”를 한 뒤 이용하실 수 있으나, 실제 심사 과정에서 사용 가능 여부가 최종 결정됩니다.

  Caution.

  아래의 호출어는 사용할 수 없습니다.

  • Kakao i 호출명령어 (ex. 헤이카카오, 카카오, 카카오야, 카카오미니)
  • 트리거 워드에 해당하는 서술어 (ex. 틀어줘, 들려줘, 시작해줘 등)
  • 이미 사용 중인 호출어

• 발화 예시문장 : 사용자가 보이스봇을 이용하기 위해 발화할 문장의 예시를 입력합니다. 서비스 호출어의 심사 가능 여부를 체크하면, 발화 예시문장에 서비스 호출어를 입력하지 않아도 서비스 호출어가 자동 인식됩니다.

  예: {서비스호출어}에서 비트코인 시세 알려줘

보이스봇 설정의 기본정보

소개 정보

• 봇 소개정보 : 보이스봇의 특징 또는 주요 기능에 대한 소개 정보를 입력할 수 있습니다.
• 검색 키워드 : 보이스봇 검색용 키워드입니다. 향후 보이스봇 서비스가 확장될 경우, 사용자들은 키워드 검색을 통해 보이스봇을 검색하고 이용할 수 있습니다.

보이스봇 설정의 소개 정보

개발사 정보

• 개발사 정보 : 보이스봇을 개발한 개발사 정보를 입력합니다.
• 고객센터 연결 정보 : 보이스봇과 관련된 CS를 처리할 고객센터 정보를 등록합니다. 고객센터 전화번호나 이메일 주소, 고객센터 URL 정보를 입력하시면 됩니다.
• FAQ 등록 : 사용자에게 노출할 FAQ 목록을 등록할 수 있습니다. 보이스봇에 대한 사용 방법, 사용자들이 궁금해할 만한 내용을 알려줄 수 있습니다.

보이스봇 설정의 개발사 정보

Information. 소개정보와 개발사 정보에 입력한 내용은 헤이카카오 앱의 플러그인 메뉴에 노출됩니다.

서비스 연동 설정 및 개인정보 보호 규정

• 벤더명 : Kakao i의 Vender Interface에서 사용할 이름을 입력합니다. 영문 대문자 또는 소문자 조합으로 5~15자리까지 등록 가능합니다.
• 서비스 이용약관 URL : 유저에게 노출할 서비스 이용약관 URL을 입력해주세요.
• 개인정보 취급 : 유저에게 노출할 개인정보 취급 정책이 있는 경우, 개인정보 수집 사용을 체크해 주시기 바랍니다. 개인정보 수집 사용을 체크하면, 개인정보 취급방침 URL을 입력할 수 있는 창이 활성화됩니다.

보이스봇 설정의 서비스 연동 설정 및 개인정보 보호 규정

보이스봇 만들기

보이스봇은 사용자의 발화 의도를 이해하고 그에 맞는 기능을 정의하여 답변을 제공합니다. 다음 튜토리얼을 하나씩 따라가며 쉽고 빠르게 보이스봇을 만들어보세요.

보이스봇 서비스 정의

사용자에게 제공할 주요 기능과 서비스 범위, 사용자 시나리오를 정의합니다. 보이스봇은 대화형 음성 인터페이스로 제공되는 봇으로, 사용자 발화와 음성 답변으로 서비스 범위를 정의합니다.

예) 가상화폐 정보 조회 서비스 정의

사용자 시나리오 설계

사용자에게 제공할 주요 기능에 대한 정의가 완료되면 실제 사용자들이 발화할 것 같은 문장으로 사용자 시나리오를 설계합니다. 사용자 시나리오는 사용자의 발화와 보이스봇의 음성 답변으로 구성할 수 있습니다.

예를 들어, 가상화폐 시세를 조회하는 기능은 아래와 같이 정의할 수 있습니다.

시나리오를 설계하는 법은 챗봇과 유사하므로, 자세한 내용은 아래 메뉴를 참고해주시길 바랍니다.

• 튜토리얼(챗봇) > 시나리오와 블록 만들기
• 튜토리얼(챗봇) > 기본 블록 설정하기
• 튜토리얼(챗봇) > 엔티티 설정하기
• 튜토리얼(챗봇) > 발화 패턴 만들기

음성 답변 가이드

기본 Rule

사용자의 입력 명령을 처리할때, 음성 답변 없이 실행 결과(성공/실패)를 명확히 알 수 있을 경우, 음성답변을 제공하지 않습니다.

Example.

• (O) : 기능 Feature(볼륨 조절 / 멜론 Top 100 재생 / 라디오 재생 등)는 음성답변 제공 안함
• (X) : 볼륨을 5로 할게요, 멜론 탑 100을 들려줄게요, 아이유의 좋은날을 들려줄게요 등 음성답변 제공

기본 응답은 표준어를 사용합니다. 비속어나 방언, 줄임말은 지양합니다.

Example.

사용자 발화 : 나 어때?

• (O) : 당신의 있는 그대로의 모습을 좋아해요 등
• (X) : 존예예요 등

음성 답변은 가능한 한 질문으로 끝나지 않습니다.

문장 구성

맞춤법과 온점, 쉼표를 활용하여 정확한 문장을 구성합니다.

• 앞 부분만 듣고 이해할 수 있도록 두괄식 문장 구성합니다.

Example.

사용자 발화 : 오늘 날씨

• 답변 : 맑아요. 최고 온도는 xx도, 최저 온도는 xx도예요.

• 중요한 정보는 앞과 뒤에 배치합니다.

Example.

사용자 발화 : 9008번 버스 언제와?

• 답변 : 7분 24초 후, 삼평동 방향 9008번 버스가 도착해요. 3개 정류장 전에 있어요.

• 인물에 대한 질문의 경우, 인물명을 가능한한 앞에 배치합니다.

Example.

사용자 발화 : 이순신이 누구야?

• 답변 : 이순신은, (상세설명).

Example.

사용자 발화 : 골든 슬럼버 주인공이 누구야?

• 답변 : 강동원이 골든 슬럼버 주인공이에요.

• 음성 답변은 가능한한 짧게 하며, 2개 문장 이내로 대답합니다.

• 사용자가 발화하지 않아 기본 값으로 답변 할 경우, 가능한 기본 요소를 생략합니다.

Example.

사용자 발화 : 날씨

• 답변 : (지역/날짜/시간 생략) 맑아요.

• 제공해야 될 정보가 많을 경우, 3개 값을 말하고 계속할지 재질의 하거나 혹은 카카오톡으로 관련 컨텐츠를 전송합니다. 가능한한 4개 이상 값을 계속 말하지 않습니다.

Example.

• (O) : 현재 알람은 오전 10시 30분, 11시 40분, 오후 5시 20분이에요. 더 알려줄까요?
• (X) : 현재 알람은 오전 10시 30분, 오전 11시 40분, 오후 5시 20분, 오후 6시 20분, 오후 7시 30분이에요.

• 지역은 최하 동까지 답변 가능하며, 사용자가 말한 지역 단위만 말해줍니다.

Example.

사용자 발화 : 삼평동 비 와?

• (O) : 삼평동 비 와요.
• (X) : 경기도 분당구 삼평동 비 와요.

• 반복적으로 표현해야하는 단어는 가능한한 생략합니다.

Example.

• (O) : 쥬라기 공원의 가까운 상영 영화관은 강남 CGV예요.
• (X) : 영화 쥬라기 공원의 가까운 상영 영화관은 강남 CGV예요.

Example.

• (O) : 현재 알람은 오전 10시 30분, 11시 40분이에요.
• (X) : 현재 알람은 오전 10시 30분, 오전 11시 40분이에요.

• 항상 최신 정보를 제공할 경우, 기준일 표기 보다는 현재/지금 등의 단어를 사용합니다.

Example.

• (O) : 현재 박스 오피스 순위는 1위 골든 슬럼버예요.
• (X) : 2월 28일 기준, 박스 오피스 순위는 1위 골든 슬럼버예요.

• 정보 출처는 매 답변마다 제공하지 않고, 출처를 물어볼 경우에만 제공합니다.

Example.

• (O) : 오징어 칼로리는 117kcal예요.

사용자 발화 : 출처가 어디야?

• (O) : 농업진흥청이에요.
• (X) : 농업진흥청에 따르면, 오징어 칼로리는 117kcal예요.

• 가능한한 말이 명확하게 들릴 수 있도록 구조화 하며, 주어는 짧게 구성합니다.

Example.

• (O) : 주말 예능은 무한도전이 볼만해요.
• (X) : 요즘 볼만한 주말 예능은 무한도전이에요.

어투

• 말의 끝은 가능한한 “~요”를 사용하나, 필요에 따라 “~니다”를 사용할 수 있습니다.

• 극존칭어를 사용하지 않고, 친근하고 편안한 사이에서의 가벼운 존댓말을 사용합니다.

Example.

• (O) : 이름
• (X) : 존함, 성함

Example.

• (O) : 아파요?
• (X) : 편찮으세요?, 아프세요?

Example.

• (O) : 들려 줄게요
• (X) : 들려 드릴게요

• “~네요” 보다는 “~어요” 체를 사용합니다.

Example.

• (O) : 찾는 곡이 없어요
• (X) : 찾는 곡이 없네요

Example.

• (O) : 슬퍼요
• (X) : 슬프네요

• 능동적이며 인성이 느껴지는 동사를 사용합니다.

Example.

• (O) : 음악을 들려줄게요
• (X) : 음악을 틀게요, 음악을 재생할게요

• 형용사와 부사 등, 미사여구를 가능한한 사용하지 않습니다.

Example.

• (O) : 곡을 찾지 못했어요
• (X) : 원하시는 곡을 찾지 못했어요

• 웃음소리, “흠” 등의 인간과 같은 의성어, 추임새, 의태어는 가능한한 사용하지 않습니다.

• 사용자를 부를 때 ‘당신’으로 호칭하나, 가능한한 사용하지 않습니다.

재질의

필수 값(엔티티)을 사용자가 발화하지 않아 재질의 해야하는 경우, 아래의 가이드를 따릅니다.

재질의 유형

• 값을 정확히 말할 수 있는 질문 형태로 구성

Example.

사용자 발화 : 알람 맞춰줘.

재질의 : 몇시로 할까요?

• 기존 대화내용에서 참고할 만한 값, 자주 사용하는 값이 있는 경우, 추천

Example.

사용자 : 배달해줘.

재질의 : 에이치스퀘어 10층으로 할까요?

• 상세하게 가이드가 필요할 경우, 발화 방법 설명

Example.

사용자 : 이메일 보내줘

재질의 : 영어로 된 카카오 계정의 알파벳을 천천히 말해주세요.

재질의를 여러번 해야 하는 경우

• 다수의 필수 엔티티를 채우기 위해서 재질의가 여러번 필요한 경우, 순서에 따라 단계적으로 물어보며 최종적으로 확인 단계를 거칩니다.

Example.

사용자 발화: 카카오톡 메시지 보내줘

재질의1 : 누구에게 보낼까요? 재질의2 : 엄마에게 뭐라고 보낼까요? 최종 확인 : 엄마에게 배고파라고 메시지를 보낼까요?

• 단계별로 재질의 할 경우, 다음 단계에서 전 단계의 값을 확인할 수 있도록 같이말해줍니다.

Example.

사용자 발화 : 일정 등록해줘

재질의1 : 날짜는요? 재질의2 : 3월 2일에 일정명을 뭐라고 보낼까요?

재질의 실패

재질의 후, 사용자의 응답이 없거나 답변이 유효하지 않아 재질의가 실패한 경우, 각 단계별로 최대 두 번까지 동일 질문을 반복할 수 있으며, 기본적으로 한 번만반복합니다.

Example.

사용자 발화 : 카카오톡 메시지 보내줘

재질의1 : 누구에게 보낼까요?

사용자 발화 : 홍길동

재질의1(실패) : 홍길동이 없어요. 누구에게 보낼까요?

사용자 발화 : 홍길동

답변 : 찾으시는 사용자가 없어요. (종료)

추천 질의

• Y/N 형태의 연결질의를 통해 사용자에게 시스템 주도적으로 추천을 할 수 있습니다.

곡을 찾지 못했어요. 이전 재생 목록을 들려줄까요?

• 사용자 답변이 N일 경우 종료, Y일 경우 그 기능을 수행할 수 있도록 명확한 질문형태로 구성합니다.

실패 시 답변 가이드라인

• 실패 원인과 해결할 수 있는 방안을 파악할 수 있도록 대답합니다.

Example.

10일 이후 날씨를 물을 경우

(O) : 열흘 이내의 날씨 정보만 알려줄 수 있어요. (X) : 그날 날씨는 몰라요.

• 가능한 한 긍정적인 방향으로 대답합니다

Example.

10일 이후 날씨를 물을 경우

• (O) : 10일 이내의 날씨 정보만 알려줄 수 있어요.
• (X) : 10일 이후의 날씨 정보는 갖고 있지 않아요.

• 사용자가 질의한 정보가 없을 경우, 정확하게 없다고 대답합니다.

Example.

사용자 : 카카오 프렌즈 주식 알려줘

• (O) : 카카오 프렌즈 종목은 없어요.
• (X) : 카카오 프렌즈 종목 몰라요.
• (X) : 카카오 프렌즈 종목을 찾지 못했어요

기타 주의사항

• 문장 내에 의미없는 특수부호는 가능한한 제거합니다.

Example.

• 유지: , . ! ? & ~ $ % – ‘(어퍼스트로피) “ “ @ + = #
• 제거 : () / : ; < > ^ _ { | } * ”

• 문장 중간에는 문장을 종결하는 . ! ?이 오지 않도록 합니다.

Example.

• (O) : 오늘 쉴래요는 MBN 예능이에요.
• (X) : 오늘 쉴래요?는 MBN 예능이에요.

• 특정 도메인에서만 사용하는 발음은 한글로 문장을 구성합니다.

Example.

• (O) : 요즘 인기있는 영화는 일구팔칠이에요.
• (X): 요즘 인기있는 영화는 1987이에요. (x, 천구백팔십칠로 읽음)

보이스봇 스킬 개발 가이드

보이스봇 스킬 개발 가이드는 제휴사에게 별도로 제공할 예정입니다.

보이스봇 테스트

개발 중인 보이스봇은 헤이카카오 앱과 스피커를 연동하여 음성 테스트를 진행할 수 있습니다. 테스트 중인 보이스봇의 정보를 변경한 경우, 헤이카카오 앱에 실시간으로 반영되지 않을 수 있습니다.

앱에서 개발 중인 봇 확인하기

헤이카카오 앱 우측 상단의 메뉴를 클릭한 후 메뉴 하단의 플러그인 서비스를 선택합니다.

플러그인 서비스 메뉴로 접속하면, 내가 개발중인 보이스봇 목록이 노출됩니다.

보이스봇 목록을 클릭하면, Kakao i developers에서 등록한 보이스봇 정보를 확인할 수 있습니다.

음성 테스트 진행하기

테스트 시작 전에...

• 개발 중인 보이스봇을 테스트하기 위해서는 헤이카카오 앱과 카카오 미니 스피커가 필요합니다.
• 구글 플레이 또는 앱스토어에서 헤이카카오 앱을 다운로드하신 후 회원으로 가입하셔야 하며, 해당 계정에 보유하고 있는 스피커를 연결하셔야 합니다.
• 회원가입 시 카카오 계정은 Kakao i 디벨로퍼스 계정과 동일해야 합니다.

음성 테스트 진행을 위해서는 개발 중인 보이스봇에 서비스 호출어가 등록되어 있어야 합니다. 서비스 호출어가 등록된 봇을 선택한 후 봇 하단의 [내 기기로 테스트하기]를 활성화하면, 해당 계정으로 연결된 카카오 미니에서 음성 테스트를 진행할 수 있습니다.

호출어를 변경한 후 음성 테스트를 진행하기 위해서는,

• 헤이카카오앱에서 서비스 호출어 변경 여부 확인
• [내 기기로 테스트하기] 기능을 비활성화 → 활성화로 변경해야 합니다.

개발 중에 서비스 호출어를 변경한 경우, 변경된 호출어로 음성 테스트를 하려면 최대 15분의 시간이 소요됩니다.

보이스봇 심사/배포

보이스봇 개발이 완료된 뒤 배포를 하기 위해서는 심사 프로세스를 거쳐야 합니다. 심사 요청은 해당 보이스봇 상단의 [설정> 보이스봇 설정]에서 필수 정보를 모두 입력한 뒤 심사/배포 메뉴에서 심사요청을 하시면 됩니다.

심사 항목

심사 담당자는 보이스봇 설정 정보와 봇 설계 정보를 바탕으로 심사를 진행합니다.

보이스봇 설정 정보

개발사가 등록한 설정 정보가 설계된 봇을 설명하는데 적합한지, 헤이카카오 앱에 노출될 내용에 오탈자 또는 잘못된 내용이 없는지를 위주로 심사합니다. 또한, 등록한 서비스 호출어의 적합성 및 사용 가능 여부를 심사합니다.

호출어 심사 기준은 아래 항목을 참조하시기 바랍니다.

등록이 불가능한 호출어

• Kakao i 호출명령어 (헤이카카오, 카카오, 카카오야, 카카오미니)
• 트리거 워드에 해당하는 서술어 (예: 틀어줘, 들려줘, 시작해줘 등)
• 이미 사용 중인 호출어

등록해도 심사 통과가 어려운 호출어

• 심사 요청을 한 보이스봇과 관련 없는 호출어
• 특정 회사명, 상표 등 저작권 이슈가 발생할 수 있는 단어가 포함된 호출어

봇 설계 정보

챗봇 관리자센터를 통해 설계한 봇의 동작을 검증하는 단계입니다. 이 과정에서 단순히 봇의 동작만 테스트 하는 것이 아니라, 음성 인식이 제대로 되는지, 사용자로부터 부적절한 정보를 요구하지는 않는지 등 전반적인 검증을 진행합니다.

심사 상태값

심사 상태는 아래와 같이 3가지 단계로 분류되며, 심사요청을 한 시점 이후부터 각 단계를 거치게 됩니다.

심사 대기

보이스봇 개발자가 심사 요청을 할 경우, 해당 봇의 상태는 심사 대기로 변경됩니다. 심사 대기 중에는 심사 요청을 취소할 수 있습니다.

심사 중

보이스봇 심사 담당자가 해당 봇의 상태를 심사 중으로 변경할 경우, 해당 봇의 상태는 심사 중으로 변경됩니다. 심사 중에는 심사 요청을 취소할 수 없습니다.

심사 완료 (승인 또는 반려)

보이스봇 심사 담당자가 해당 봇의 심사를 완료한 경우, 해당 봇의 상태는 심사 완료 상태로 변경됩니다.

심사 완료 상태는 심사 완료(배포승인) 또는 심사 완료(반려)의 두가지 상태를 가지게 되며, 배포 승인이 된 경우에는 배포 승인 또는 반려 상태로 변경됩니다.

심사 히스토리

심사 중인 봇의 심사 히스토리

심사/배포 메뉴를 통해 보이스봇의 심사, 배포 히스토리를 확인할 수 있습니다. 심사 히스토리는 현재 진행 중인 심사에 대해서만 확인이 가능하며, 이전 버전에 대한 히스토리는 배포 히스토리에서 확인 가능합니다.

심사 프로세스

심사요청

심사 요청하기

심사/배포 메뉴를 통해 1) 새로운 버전 설명 메시지와 2) 담당자에게 전할 메시지를 입력한 뒤 심사 요청 버튼을 클릭합니다. 새로운 버전 설명 메시지는 헤이카카오 앱에 노출되는 정보로, 현재 서비스 중인 보이스봇에서 변경된 사항을 사용자에게 안내하고 싶을 때 작성하는 정보입니다. 담당자에게 전할 메시지는 현재 서비스 중인 보이스봇의 변경된 정보를 자세히 작성해야 합니다. 심사 담당자는 해당 메시지를 위주로 보이스봇을 검증하고 심사를 진행하게 되므로, 최대한 자세하고 구체적으로 작성해 주시기 바랍니다.

봇 목록에서 확인 가능한 심사 상태

심사 요청과 동시에 보이스봇 상태는 심사 대기로 전환되고, 심사 담당자에게 심사 요청 사항이 자동으로 전달됩니다. 심사 대기중에는 보이스봇 정보를 수정할 수 없으며, 정보 변경이 필요한 경우에는 심사/배포 메뉴에서 심사 요청을 취소한 후 변경할 수 있습니다.

심사 중

심사 중인 봇은 편집한 내용을 저장할 수 없습니다

심사 담당자가 심사를 시작하면, 봇은 심사 중 상태로 변경됩니다. 심사 중인 봇은 심사가 반려되거나 승인될 때까지 편집한 내용을 저장하실 수 없습니다.

심사완료

심사 승인되어 배포가 가능한 봇

반려된 봇은 심사 히스토리의 “반려사유”를 클릭하면 아래와 같은 팝업에서 반려사유를 확인하실 수 있습니다

심사 반려 사유

보이스봇 등록 정보와 보이스봇 심사 정보를 바탕으로 최종 심사를 거쳐 배포 여부를 평가하게 됩니다. 심사 결과는 ‘배포 승인’과 ‘반려’ 두 가지로 구분됩니다.

• 배포 승인된 보이스봇은 배포 대기상태가 되며, 심사/배포 메뉴에서 배포하기를 클릭하시면 봇이 바로 배포됩니다. 만약 심사 승인 되었지만 배포하고 싶지 않으시다면, 배포 승인 취소를 클릭하면 다시 봇을 편집하실 수 있습니다. 배포에 대한 상세한 내용은 배포 가이드를 참조해주세요.
• 반려된 보이스봇은 심사 히스토리에 있는 <반려 사유>를 클릭하면, 심사가 반려된 사유를 확인하실 수 있습니다. 동일한 보이스봇에 대해 재심사를 받고 싶으시다면, 위 내용을 참고하셔서 수정을 진행하신 후 다시 심사를 요청해주세요.