웹훅 미전파 이슈 대응 안내

고객 정보 변경(연락처, 광고 수신 설정) 및 고객 삭제 데이터가 웹훅으로 전달되지 않는 일시적인 문제가 있었기에 관련 내용과, 대응 방안 안내드립니다.

• 장애 발생 시간 : 2024년 11월 1일 12:40 AM ~ 2024년 11월 12일 15:37 PM

• 장애 발생 범위 : 웹훅을 사용하는 채널에 한해 고객 정보 변경(연락처, 광고 수신 설정) 및 고객 삭제 데이터가 등록된 웹훅으로 전파되지 않았습니다.

• 장애 원인 : 최근 배포 중 발생한 오류로 인해 문제가 발생했습니다.

• 조치내용 : 원인 부분의 코드를 수정하여 이후 정상적으로 정보가 전파되도록 조치를 완료했습니다.

11월 12일 15:37PM 이후 웹훅은 정상 동작하고 있습니다. 채널톡 배포 장애로 인해 번거로운 작업 요청 드려 죄송합니다

채널톡의 Open API를 통해 작동되지 않은 웹훅을 개발팀을 통해 아래 가이드를 참고하여 자체적으로 ‘한번’ 실행하길 요청드립니다. 삭제된 고객(유저) 정보는 채널톡에서 가지고 있지 않아 직접 처리를 요청드리는 점 양해 바랍니다.

1. 채널톡 User(고객)의 memberId에 대응되는 고객사의 자체 유저 id들을 수집.

2. 고객사의 자체 유저 id로 Get user by memberId OpenAPI 호출.

3. 응답 받은 user의 아래 필드들이 고객사가 들고 있는 유저와 다른지 확인

   (참고: mobileNumber 필드는 user.mobileNumber에도 있고 user.profile.mobileNumber에도 있습니다. 두 값은 모두 같습니다. email 필드 또한 같습니다)

   1. mobileNumber

   2. email

   3. unsubscribeEmail

   4. unsubscribeTexting

4. 다르다면 채널톡으로부터 request body 값이 “event”: “upsert”인 웹훅 요청이 왔다고 가정 하여 채널톡에 등록한 웹훅의 로직을 수행.

1. 채널톡 User(고객)의 memberId에 대응되는 고객사의 자체 유저 id들을 수집.

2. 고객사의 자체 유저 id로 Get user by memberId OpenAPI 호출.

3. 응답 받은 user의 type 필드가 “unified”인지 확인

4. “unified”인 경우 채널톡으로 부터 request body 값이 “event”: “delete”인 웹훅 요청이 왔다고 가정하여 채널톡에 등록한 웹훅의 로직을 수행.

1. 채널톡 User(고객)의 memberId에 대응되는 고객사의 자체 유저 id들을 수집.

2. 고객사의 자체 유저 id로 Get user by memberId OpenAPI 호출.

3. 404 Not found response가 온다면, 채널톡으로 부터 request body 값이 “event”: “delete”인 웹훅 요청이 왔다고 가정하여 채널톡에 등록한 웹훅의 로직을 수행.