사이드 메뉴
커뮤니케이션
API 제공
어드민 API
이용 안내
웹훅
이 문서는 카카오 또는 공동체 서비스에 제공하는 웹훅(Webhook) 기능을 안내합니다. 공통 설명은 오픈 문서를 참고합니다.
아래는 카카오 또는 공동체 서비스용으로 제공하는 웹훅 목록입니다.
| 웹훅 | 설명 | 관련 제품 | 필수 |
|---|---|---|---|
| 연결 해제 웹훅 | 사용자 카카오계정과 서비스 앱의 연결이 끊어졌을 때, 해당 사용자를 탈퇴 처리할 수 있도록 관련 정보를 서비스로 전달 | 카카오 로그인 | O |
| 로그아웃 웹훅 | 서비스 외부에서 사용자의 로그아웃 요청 또는 기타 이유로 로그아웃이 발생한 경우, 관련 정보를 서비스로 전달 | 카카오 로그인 | X |
| 계정 상태 변경 웹훅 | 서비스로 사용자의 계정 상태 변경 이벤트 정보 전달 | 카카오 로그인 | X |
| 카카오톡 공유 웹훅 | 카카오톡 공유 메시지 전송에 성공했을 때, 전송한 메시지의 정보를 서비스로 전달 | 카카오톡 공유 | X |
| 카카오톡 채널 웹훅 | 사용자가 서비스의 카카오톡 채널을 추가 또는 차단했을 때, 서비스로 관련 정보 전달 | 카카오톡 채널 | X |
모든 웹훅 요청에 대해 서비스 서버는 3초 이내에 정해진 각 웹훅의 필수 응답 규격으로 응답해야 합니다. 카카오 또는 공동체 서비스에 제공하는 웹훅의 필수 응답 규격은 기능 소개의 각 웹훅 개발 문서에서 확인할 수 있습니다.
카카오 또는 공동체 서비스가 웹훅을 수신하려면 사내망을 허용해야 합니다. 서비스 서버가 카카오 사내망이 아닌 외부에 있는 경우, 허용할 IP 목록을 참고해 ACL에 허용 IP를 등록합니다.