본문 바로가기


챗봇 관리자센터

챗봇 관리자센터 메뉴

카카오 고객센터 본문

봇 생성하기

봇 생성하기 카테고리

봇 생성하기 본문

  1. 카드형 말풍선의 스킬 예제는 도움말의 [스킬 개발 가이드 > 응답 타입별 JSON 포맷]에서 BasicCard를 참고해주시기 바랍니다.

    ※ 챗봇 관리자센터 도움말 ▶ 바로가기


  2. 로컬서버에서 테스트 시 정상적으로 스킬이 동작하지 않습니다.
    봇 시스템에 응답할 수 있는 개발환경으로 스킬서버를 세팅해주세요. 개발환경 세팅과 관련된 자세한 도움말은 아래 버튼을 클릭하여 확인해주세요.


  3. 요청하는 스킬이 가이드에 명시된 규격을 준수하였는지 혹은 카카오톡채널이 챗봇에 정상적으로 연결된 상태인지 확인부탁드립니다.
  4. 봇테스트에서 출력되는 응답값은 배포되기 전의 현재 작업 중인 내용을 기반으로 합니다. 따라서 카카오톡 채널에서 직접 테스트 하시기 위해서는 수정한 항목을 확인 후 '배포'를 진행하시기 바랍니다.
  5. 스킬 서버를 생성하고 실행하는 방법이나 JSON 포맷을 이용해 응답 템플릿을 구성하는 방법은 도움말을 통해 상세히 확인할 수 있습니다.
    도움말 대로 JSON이 작성 되지 않은 경우 스킬서버에 이상이 없더라도 봇에서 발화에 따른 응답처리가 불가합니다.

    따라서 JSON코드를 도움말과 비교하여 재점검 하여 주시기 바라며,
    코드 이상이 아닐 경우 서버오류일 수 있어 아래 내용을 체크하여 주시기 바랍니다.

    1. 봇 작업자의 스킬 서버가 로컬(local) 환경인 경우
    - 공인IP 또는 공중망 도메인 가능
    2. 스킬 기능은 동작했으나 출력할 값이 없는 경우
    3. JSON 포맷 구성이 올바르지 않은 경우
    4. 사용자의 봇 서버에 이슈가 있는 경우 등
    5. 사용자의 스킬서버에서 응답을 만들어서 전송하는데 5초이상 소요될 경우

  6. 블록에서 다른 블록으로의 버튼 설정은 스킬을 통해 구현하셔도 되고, 챗봇 관리자센터에 설정해두신 말풍선에서 직접 설정하여 사용하실 수 있습니다.

    스킬 구현시 action의 값에 block으로 기재, webLinkUrl 대신 blockId를 키로 놓고 값으로 blockId를 기입합니다.





  7. 1.스킬에 기입한 URL의 오기재가 되었는지, 변경 뒤 최신 URL로 기입되었는지 체크해 주세요.
    2. 봇 작업자의 스킬서버에서 응답을 주기까지 5초 초과하면 타임아웃으로 봇이 응답을 내보내줄 수 없게 됩니다. 
    따라서 사용자의 스킬 서버에서 응답을 빨리 줄 수 있도록 환경구축이 필요합니다.
  8. 1) event > data 하위로 원하는 키값을 쓰시고
    2) 봇응답에서 {{#current.event.data.paramName}} 으로 설정하면 됩니다.

    1) params 하위로 원하는 키 값을 쓰시고
    2) 봇응답에서 {{#current.params.paramName}} 으로 설정하면 됩니다.
  9. 케로셀 타입은 이미지형을 제외하고 모든 말풍선에서 사용할 수 있습니다.
    자세한 내용은 [도움말 > 스킬 개발 가이드 > 응답 타입별 JSON 포맷] 항목에서 Carousel 을 참고해주시기 바랍니다.

    ※ 단, 리스트형(케로셀), 아이템형(단일, 케로셀)의 경우 스킬API로 응답 구현이 가능한 말풍선으로 스킬을 연결하시어 응답으로 사용하실수 있습니다.


  10. JSON 포맷으로 응답 구성시 button > extra 필드를 활용해보시기 바랍니다.        

    extra' 필드는 버튼의 block이나 message action으로 블록을 호출하는 경우 작업자의 스킬 서버에 추가적으로 제공하는 정보입니다.        

    바로연결의 extra 필드 하위로 원하는 파라미터를 입력하는 경우 연결된 다음 블록에서 페이로드의        

    client Extra 해당 값을 확인할 있습니다.       

    다만 바로연결 버튼을 통해 입력된 발화에서 별도로 엔티티를 추출하여 파라미터로 전달하지는 않습니다.


    챗봇 관리자센터에서 응답 구성시에는 버튼이나 바로연결 설정에서 버튼 기능을 블록 연결이나 메시지 전송으로 설정하면 추가 정보를 입력할 있습니다. 추가 정보에 입력한 값은 'extra' 필드 기능과 동일하게 동작됩니다.




문의하기

원하시는 답변을 찾지못하셨다면, 고객센터로 문의해 주세요.