실패한 웹훅이 알려주지 않는 모든 것
알림이 도착하지 않으면 늘 같은 질문이 떠올라요. 발신 측이 실제로 호출했는가? 호출했다면 저희 쪽에서 무엇이 잘못됐는가?
모든 요청의 로그
모든 호출을 최신순으로 기록하고, 목록에서 바로 펼쳐볼 수 있어요. 메서드, 출발지 IP, 크기, 콘텐츠 타입을 한눈에 확인하세요.
헤더와 페이로드 전체
도착한 그대로의 전체 헤더와 원본 본문을 보여줘서, 서비스가 보낸다고 주장하는 내용과 실제로 보낸 내용을 비교할 수 있어요.
템플릿이 만든 결과
페이로드에서 템플릿이 렌더링한 메시지를 페이로드 원본 옆에서 확인하세요. 템플릿 버그를 더 이상 짐작할 필요가 없어요.
구체적인 실패 사유
실패 원인을 구체적으로 알려드려요. 잘못된 JSON, 누락된 %path%로 인한 빈 메시지, 비활성화된 웹훅 중 하나예요.
마스킹 및 암호화
Authorization, 쿠키, API 키 헤더는 저장 전에 가려지고, 페이로드는 사용자의 키로 암호화되어 저장돼요.
필터링, 페이지 이동, 가져오기
처리 결과로 필터링하고 대시보드에서 기록을 넘겨볼 수 있어요. API로 기록을 가져와 직접 분석할 수도 있어요.
실제로 무엇이 도착했는지 확인하세요
서비스에 웹훅 연결하기
웹훅을 만든 뒤, 평소처럼 서비스에 그 URL을 설정하세요.
기록 열기
대시보드에서 웹훅을 열고 기록 화면으로 이동하세요.
호출 펼쳐보기
호출을 펼치면 헤더, 본문, 렌더링된 메시지, 실패 원인을 볼 수 있어요.
웹훅 기록의 동작 방식
웹훅 URL로 들어오는 모든 요청은 처리되기 전에 먼저 기록되고, 처리가 끝나면 결과가 함께 저장돼요. 그래서 성공한 호출뿐 아니라 실패한 호출도 똑같이 확인할 수 있어요. 비활성화했다가 잊어버린 웹훅으로 들어온 호출도 포함해서요.
대시보드에서 웹훅을 열면 최신순으로 기록이 보이고, 각 행을 펼치면 쿼리 문자열, 전체 헤더, JSON 형식으로 정리된 본문을 확인할 수 있어요. 같은 데이터를 REST API에서도 success와 error로 필터링해서 가져올 수 있어요.
템플릿 디버깅하기
가장 흔한 실패 원인은 네트워크 문제가 아니라, 발신 측이 실제로 보내지 않는 필드를 %path% 플레이스홀더가 가리키는 경우예요. 기록에서는 원본 페이로드와 템플릿이 만든 메시지를 나란히 보여줘서, 대부분 몇 초 안에 불일치를 찾을 수 있어요.
개인정보 보호
페이로드에는 비밀 정보가 들어 있는 경우가 많아서, 개인 키로 저장 시 암호화하고 Authorization, 쿠키, API 키 헤더는 저장 전에 [redacted]로 바꿔요. 보관 기간은 무료 플랜의 7일부터 Large 플랜의 1년까지예요.
궁금한 점을 답해드려요
타임스탬프, HTTP 메서드, 출발지 IP, 콘텐츠 타입, 쿼리 문자열, 전체 헤더, 원본 본문, 페이로드 크기, 템플릿으로 생성된 메시지, 알림 생성 여부, 생성되지 않았다면 실패 사유, 처리에 걸린 시간을 기록해요.
무료 플랜은 7일, Starter는 30일, Medium은 90일, Large는 365일 동안 보관해요. 보관 기간이 지난 호출은 자동으로 삭제되며, 웹훅 하나의 기록이 1,000건을 넘으면 가장 오래된 항목부터 삭제돼요.
네, 안전해요. 페이로드는 메시지 내용과 마찬가지로 개인 키로 저장 시 암호화되며, Authorization, 쿠키, API 키 헤더는 저장 전에 [redacted]로 바뀌어요.
기록을 보면 원인을 알 수 있어요. 아무 기록도 없다면 발신 측 요청이 저희 서버에 도달하지 않은 거예요. 오류와 함께 기록되었다면 사유를 알려드려요. 잘못된 JSON, 페이로드에 존재하지 않는 %path%에서 가져온 빈 메시지, 또는 비활성화된 웹훅 등이에요.
대시보드에서 웹훅을 열면 최신순으로 정렬된 기록이 바로 보이고, 각 호출을 펼쳐서 자세히 볼 수 있어요. 프로그래밍 방식으로 가져오고 싶다면 REST 엔드포인트도 있으며, 성공과 오류로 필터링할 수 있어요.
네, 무료 플랜에서도 7일 동안 기록을 볼 수 있어요. 더 오래 보관하려면 유료 플랜에서 보관 기간을 늘릴 수 있어요.