Event API
Event API란?
챗봇과 사용자 간의 대화는 기본적으로 사용자가 먼저 대화를 건내면 이에 대해서 챗봇이 응답하는 구조를 가지고 있습니다.
그러나 실생활에서의 대화가 항상 한 쪽으로부터만 시작되지 않는 것과 같이 챗봇이 먼저 사용자에게 말을 거는 것이 자연스러운 상황이 있습니다.
Event API는 이와 같은 상황에서 챗봇이 먼저 대화를 시작할 수 있도록 도와주는 기능으로 특정 이벤트에 대한 알림, 안내 등의 목적으로 사용할 수 있습니다.
다만, 예상치 못한 메시지가 너무 빈번하게 오는 것은 사용자를 쉽게 피로하게 만들 수 있기 때문에 이를 고려하여야 사용자와의 관계를 오래 지속할 수 있을 것입니다!
Information.
운영채널 및 개발채널에서의 Event API 메시지 사용량은 모두 과금 대상이며, 메시지 1건당 15원(VAT 별도)씩 과금됩니다.따라서 Event API를 통한 메시지를 전송하기 위해서는 월렛 생성 및 연결이 선행되어야 합니다. 월렛에 대한 상세한 내용은 주요개념 > 월렛을 참고해주시기 바랍니다.
Event API 활용 예시
그렇다면 Event API는 어떤 상황에서 어떻게 사용할 수 있을까요?
위 Event API에 대한 간략한 설명만으로 감을 잡기 어려운 분들을 위해 몇 가지 시나리오 예시를 준비했습니다.
아래 예시 외 다양한 시나리오에서도 Event API를 적절히 사용해 사용자와의 대화를 더욱 풍성하게 만들어보세요!
정보성 메시지 예시 시나리오
1) 경기결과 알림
사용자가 관심있는 경기정보에 대해 사전에 알림 설정을 해두면, 관련 경기가 종료된 후 경기 결과를 Event API로 발송하는 시나리오입니다.
알림설정
사전 알림 설정은 Event API 사용을 위한 필수 요소는 아니며 사용자에게 적합한 정보를 정제하여 전달하기 위한 하나의 장치라고 볼 수 있습니다.
2) 주문 상품 준비 완료 안내
커피 주문 후 제조가 완료되면 Event API로 안내하는 시나리오입니다.
3) 재입고 알림
사용자가 관심있는 상품에 대해 재입고 알림설정을 해두면, 상품이 재입고되었을 때 Event API로 안내 메시지를 발송하는 시나리오입니다.
광고성 메시지 예시 시나리오
광고성 내용 포함
발송하려는 메시지가 광고성 내용을 포함하는 경우 광고성 메시지임을 표기해야 합니다. 광고성 메시지 기준 및 광고성 메세지 표기 방법은 아래 Event API 광고표시 의무 를 확인해주세요.
1) 프로모션 안내
이벤트/특가판매 등 프로모션에 대해서 필요한 시각에 Event API로 광고 메시지를 발송하는 시나리오입니다.
2) 관심상품 알림
사용자가 관심상품 키워드를 미리 등록해두면 관련 상품 판매 시작시 관련 Event API로 광고 메시지를 발송하는 시나리오입니다.
Event API 메시지 전송 정책
- Event API는 채널을 추가한 유저에게만 전송 가능하므로, 채널을 추가하지 않았거나 차단한 경우 전송은 실패합니다.
- Event API 요청 1회당 최대 발송 건수는 100건이며 유저아이디 중복은 허용되지 않습니다.
- Event를 발송할 대상인 유저아이디 타입은 아래 값 중 하나여야 합니다. 유효하지 않은 사용자에게 발송한 메시지는 전송 실패합니다.
- Event API 발송시 채널 추가한 유저의 전체 유저키를 한번에 조회하거나 업로드 하는 기능은 지원하지 않습니다.
- appUserId (카카오 디벨로퍼스 앱유저 아이디)
- plusfriendUserKey (skill서버에 전달되는 톡채널 유저 식별값)
- botUserKey (skill 서버에 전달되는 봇 유저 식별값)
Information.
요청 성공 여부는 이벤트 블록 호출 API의 status값에서 확인 가능하며, 전송 성공 여부는 이벤트 발송 성공여부 조회 API를 통해 확인할 수 있습니다. 전송 성공된 메시지 건에 대해서만 과금 처리됩니다.
상세한 설정 방법은 튜토리얼 > Event API 사용하기를 참고하시길 바랍니다.