받는 주소

“연동” 메뉴의 “받는 주소” 탭입니다. 받는 주소는 외부 시스템이 전환·리뷰를 보내는 주소이며, 주소에 비밀 토큰이 들어 있어 만들 때 한 번만 보입니다. “받는 주소” 표에는 “이름”과 사이트, “종류”(“전환” 또는 “리뷰”), 주소의 앞부분(“주소”), “받은 수”, “마지막 받음”이 나옵니다. 토큰을 교체한 직후에는 “이전 토큰도 … 까지 받음”이 함께 보입니다.

“전환”은 주문·가입 같은 전환으로, 최근 활동과 전환 합계에 들어갑니다. “리뷰”는 외부 리뷰로, 승인 대기로 들어와 승인하면 보입니다.

“보내는 형식” 영역은 보내는 쪽이 지킬 규칙과 “전환”·“리뷰” 예시 JSON 을 보여 줍니다. 주소로 JSON 을 POST 하고, 같은 externalId 는 한 번만 받으며, 주소마다 분당 60번, 본문 8KB 까지입니다. 모르는 필드는 저장하지 않고 이메일·전화번호는 버리며, 토큰이 틀리면 이유 없이 401 로 답합니다.

받는 주소는 요금제에 따라 쓸 수 있습니다. 조직의 요금제에 웹훅·API 기능이 없으면 “웹훅·API 는 Growth 요금제부터 쓸 수 있습니다” 안내와 “요금제 보기”가 나오고, 새 주소를 만들거나 토큰을 교체할 수 없습니다.

1. 1단계 · 새 받는 주소 만들기

   “새 받는 주소”를 누르고 “사이트”, “종류”(“전환” 또는 “리뷰”), 목록에서 구분할 “이름”을 넣은 뒤 “만들기”를 누릅니다.

2. 2단계 · 비밀번호 확인하기

   “받는 주소를 만들려면 비밀번호 확인” 창에 “현재 비밀번호”를 넣고 “확인하고 저장”을 누릅니다.

3. 3단계 · 주소 복사해 넣기

   “받는 주소 — 지금만 보입니다” 창에서 “받는 주소 복사”를 눌러 보내는 쪽 시스템에 넣고 “복사해 두었습니다”를 누릅니다. 이 주소는 다시 보여 주지 않습니다.

4. 4단계 · 받은 기록 확인하기

   표의 “받은 기록”을 누르면 그 주소로 온 요청이 “받은 시각”, “결과”(“받음”·“중복 (무시)”·“형식 오류”), “외부 ID”, “남긴 값”, “참고”로 보입니다.

새 받는 주소

새 받는 주소 창을 엽니다. 요금제에 웹훅·API 기능이 있는 Owner·Admin 에게만 보이고, 조직이 읽기 전용이면 누를 수 없습니다.

받은 기록

그 주소가 받은 요청 목록을 엽니다.

토큰 교체

확인 창과 현재 비밀번호 확인을 거쳐 새 토큰이 든 주소를 만들어 한 번 보여 줍니다. 이전 주소는 24시간 동안 더 받고 그 뒤 거부됩니다.

서명

그 주소의 요청 서명 창을 엽니다. 서명이 하는 일과 보내는 쪽이 서명을 만드는 방법(코드 예)이 보입니다.

서명 켜기 · 서명 비밀 교체하기

현재 비밀번호 확인을 거쳐 서명 비밀을 만들어 한 번 보여 줍니다. 켜면 모든 요청에 BzWidget-Signature 헤더가 있어야 하고, 교체하면 이전 비밀도 24시간 동안 통합니다.

서명 끄기

확인 창과 현재 비밀번호 확인을 거쳐 다시 토큰만으로 받습니다.

삭제

확인 창을 거쳐 주소를 지웁니다. 그 주소로 오는 요청은 바로 거부되고 받은 기록도 지워지며, 이미 받은 활동·리뷰는 남습니다.

“연동” 메뉴는 Owner·Admin 만 열 수 있고, 받는 주소를 만들고 토큰을 교체하고 지우는 것도 Owner·Admin 만 할 수 있습니다. Editor·Analyst 에게는 메뉴가 보이지 않으며, 주소를 직접 열면 “이 작업을 할 권한이 없습니다.”가 나옵니다.

요금제에 웹훅·API 기능이 없으면 “새 받는 주소”와 “토큰 교체”가 보이지 않고, “받은 기록”과 “삭제”는 남습니다. 조직이 읽기 전용이면 “새 받는 주소”와 “토큰 교체”가 꺼지고 “조직이 읽기 전용이라 바꿀 수 없습니다.”가 보입니다.

받는 주소를 잃어버렸습니다.

주소에 비밀 토큰이 들어 있어 만들 때와 교체할 때 한 번만 보입니다. “토큰 교체”로 새 주소를 받아 보내는 쪽에 넣으세요. 이전 주소는 24시간 동안 더 받습니다.

받는 주소를 더 만들 수 없습니다.

사이트마다 만들 수 있는 받는 주소 수가 정해져 있습니다. 넘으면 “이 사이트에 만들 수 있는 받는 주소 수를 넘었습니다.”가 나옵니다. 이름은 1~60자여야 합니다.

보낸 요청이 “받은 기록”에 없습니다.

토큰이 틀린 요청과 속도 제한에 걸린 요청은 기록하지 않습니다. 기록은 30일 동안 보관하고, 이름은 이니셜로만 보입니다.

보낸 이메일이나 전화번호가 저장되지 않습니다.

받는 주소는 연락처를 받지 않습니다. 이메일·전화번호는 버리고 “받은 기록”의 “참고”에 “연락처라 버린 값:”으로 어떤 필드였는지만 남깁니다. 모르는 필드는 “저장하지 않은 필드:”로 보입니다.

서명을 켠 뒤 요청이 401 을 받습니다.

서명이 없거나, 틀리거나, 5분 넘게 지났거나, 같은 서명을 다시 보낸 요청은 틀린 토큰과 똑같은 401 을 받고 “받은 기록”에도 남지 않습니다. 본문을 보낸 그대로 서명했는지, 보내는 쪽 시계가 맞는지 확인하고, 다시 보낼 때는 새 시각으로 다시 서명하세요.