페이지 이동경로
  • 문서>

채널 관계 알림 받기

채널 관계 알림 받기는 사용자가 서비스와 연결된 카카오톡 채널을 추가 또는 차단했을 때 알림을 받는 기능입니다. 애플리케이션(이하 앱)과 연결된 카카오톡 채널을 추가한 사용자들에게 카카오톡 채널 메시지를 보낼 때, 현재 채널을 차단한 사용자나 나중에 채널을 추가한 사용자는 자체적으로 파악이 어려울 수 있습니다. 이럴 때 채널 관계 알림 받기 기능이 유용합니다.

채널 관계 알림 받기 기능은 [앱 설정-사용자 관리]에서 카카오톡 채널 추가/차단 콜백 URL 설정에 알림을 받을 URL을 입력해 사용합니다. 알림은 callbck 형태로 전달되며, 아래 정보를 참고해 카카오 서버가 보내는 요청을 앱 서버가 받아 처리하는 기능을 구현합니다.

Request

  • URL
Method Request URL
POST 카카오톡 채널 추가/차단 콜백 URL 설정에 등록된 URL
  • Parameters
Field Type Description
event String 사용자와 채널 관계 변경사항, 추가 또는 차단(added or blocked)
id String 채널 추가 또는 차단한 사용자 식별자
id_type String 식별자 타입
plus_friend_public_id String 사용자와 채널의 관계가 바뀐 카카오톡 채널의 Public ID
updated_at Datetime 채널 관계가 변경된 시간
(RFC3339 internet date/time format)
  • Sample
curl -X POST https://example.com  \
  -H 'Authorization: KakaoAK ${adminKey}' \
  -H 'Content-Type: application/json' \
  -d '{"event":"added","id":"1111","id_type":"app_user_id","plus_friend_public_id":"_FLX","plus_friend_uuid":"@ad","updated_at":"2020-01-01T00:00:00Z"}'