워크스페이스 최고 관리자는 모두싸인 웹 화면에서 웹훅마다 최근 30일의 전송 결과를 확인하고, 받지 못한 이벤트를 골라 다시 받을 수 있습니다(웹훅 재전송). 이벤트가 오지 않았을 때 모두싸인이 보냈는지, 수신 서버가 어떻게 응답했는지를 화면에서 바로 확인할 수 있습니다.

아래는 웹훅 주소를 바꾼 뒤 실패한 건을 다시 받은 전송 한 건의 시도 내역 예시입니다.

세 시도 모두 같은 전송 ID로 나갔고, 3번 시도가 성공하면서 이 건의 결과는 성공으로 바뀝니다.

---

1. 이용 조건

---

2. 전송 이력 확인하기

전송 이력 화면 열기

1. 통합 설정 > 워크스페이스 관리 > API 연동 > 웹훅 메뉴에서 확인할 웹훅을 선택해 웹훅 상세 화면으로 들어갑니다.
2. 웹훅 상세 화면의 웹훅 전송 이력 영역에서 웹훅 전송 이력 보기 버튼을 누릅니다.

목록에서 찾기

웹훅 전송 이력은 웹훅마다 따로 보이며, 전송 일시가 최근인 건부터 표시됩니다. 행마다 결과, 이벤트 종류, 문서 ID, 전송 일시가 한 줄로 보이며, 아래 조건으로 원하는 건을 찾을 수 있습니다.

목록 위에는 전체 건수와 목록을 불러온 기준 시각이 보입니다. 최신 결과를 보려면 기준 시각 옆의 새로고침 버튼을 눌러 주세요.

결과 확인하기

목록과 상세에서 건마다 아래 결과 중 하나가 보입니다.

웹훅 재전송을 시작해 그 시도가 아직 끝나지 않은 건에는 결과와 함께 재전송 중이 표시됩니다. 재전송 중은 검색 조건에 없으므로, 재전송 중인 건은 원래 결과(성공 또는 실패)로 검색해 찾을 수 있습니다.

시도 내역 확인하기

목록에서 건을 선택하면 오른쪽에 전송 상세가 열립니다. 상태(결과), 이벤트 종류(이벤트 이름과 코드), 전송 일시, 문서 ID, 전송 ID와 함께 시도 내역이 보입니다. 실패한 건은 맨 위에 마지막 시도의 실패 원인과 확인할 곳이 안내됩니다.

• 시도 내역에는 끝난 시도만 보입니다. 아직 보내는 중인 시도는 시도 내역에 나오지 않고, 목록에 전송 중 또는 재전송 중으로 표시됩니다.
• 수신 서버가 돌려준 응답 본문과 요청에 실린 헤더는 전송 이력에 남지 않습니다. 응답 본문은 수신 서버의 로그에서 확인해 주세요.
• 웹훅 주소를 바꿔도 바꾸기 전 주소로 보낸 건은 같은 웹훅의 전송 이력에 남습니다.

실패 원인 확인하기

실패한 건은 마지막 시도의 실패 원인이 상세 상단에 보이고, 실패한 시도마다 실패 원인이 함께 보입니다. 실패 원인은 아래 세 가지 중 하나입니다.

원인이 수신 서버나 웹훅 주소·헤더에 있다면 먼저 고친 뒤 웹훅 재전송해 주세요. 리다이렉트와 관련된 주의사항은 Webhook 설정을 참고하세요.

---

3. 웹훅 재전송하기

받지 못한 이벤트를 골라 다시 보낼 수 있습니다. 결과가 실패인 건뿐 아니라 성공인 건도 다시 보낼 수 있습니다.

재전송 방법

한 건만 다시 보낼 때는 전송 상세 하단의 재전송하기 버튼을 눌러도 됩니다. 여러 건을 한 번에 보낼 때는 아래 순서를 따릅니다.

1. 웹훅 전송 이력 목록에서 다시 보낼 건의 체크박스를 선택합니다. 한 건만 고르거나, 지금 화면에 보이는 건 가운데 최대 100건을 골라 한 번에 보낼 수 있습니다. 전송 중이거나 재전송 중인 건은 선택할 수 없습니다.
2. 목록 위에 선택한 건수와 함께 나타나는 웹훅 재전송 버튼을 누릅니다. 선택을 모두 풀려면 선택 해제를 누릅니다.
3. 확인 창에서 보낼 건수와 보낼 주소(현재 설정된 웹훅 주소)를 확인하고 재전송하기를 누릅니다.
4. 재전송 결과 창에서 재전송을 시작한 건수를 확인합니다. 제외된 건이 있으면 문서 ID와 제외 사유(예: 완료되지 않은 전송입니다.)가 함께 보입니다.

재전송되는 내용

웹훅 주소나 헤더를 고친 뒤 재전송하면 고친 설정으로 보내므로, 예전 주소로 실패한 건도 새 주소로 받을 수 있습니다. 여러 건을 한 번에 보내도 모두 실행한 시점의 설정을 씁니다.

재전송할 수 없는 건

고를 수 없는 건은 화면에 그 이유가 보입니다. 재전송을 실행하는 순간 고른 건을 다시 확인해, 그사이 위 조건에 해당하게 된 건은 빼고 나머지만 재전송합니다. 뺀 건은 재전송 결과 창에서 확인할 수 있습니다.

재전송 후 결과

• 재전송 시도가 끝날 때까지 그 건에는 재전송 중이 표시되며, 목록에서 빠지지 않습니다.
• 재전송 시도가 성공하면 결과가 성공으로 바뀝니다. 실패였던 건도 성공이 됩니다.
• 재전송 시도가 실패하면 결과는 바뀌지 않습니다.
• 재전송 시도는 그 건의 시도 내역에 웹훅 재전송 시도로 추가됩니다.

---

4. 수신 서버에서 할 일

모두싸인은 모든 Webhook 요청에 아래 헤더를 싣습니다. 자동 재시도와 웹훅 재전송에도 같은 규칙으로 실립니다.

웹훅 재전송으로 같은 이벤트가 다시 도착할 수 있으므로, Modusign-Delivery-Id로 이미 처리한 전송인지 확인해 주세요.

1. 요청을 받으면 Modusign-Delivery-Id 값을 읽습니다.
2. 이미 처리를 마친 전송 ID이면 2xx로 응답하고 다시 처리하지 않습니다.
3. 처음 받은 전송 ID이면 2xx로 응답한 뒤 처리하고, 처리한 전송 ID를 저장합니다.

헤더 규칙과 중복 수신 처리의 자세한 내용은 Webhook event를 확인해 주세요.

---

5. 주의사항

• 웹훅을 삭제하면 그 웹훅의 전송 이력도 함께 지워집니다. 삭제할 때 확인 창에서 이 내용을 안내합니다. 삭제한 뒤 같은 주소로 다시 등록하면 새 웹훅이 되어 Webhook ID와 전송 ID도 새 값이 됩니다.
• 보내지 않은 이벤트는 전송 이력에 남지 않습니다. 요금제에 웹훅 기능이 없을 때 발생한 이벤트, 구독하지 않은 이벤트, 웹훅 허용 정책으로 막은 이벤트는 보내지 않으므로 목록에 나타나지 않습니다.
• 이벤트 구독을 꺼도 전송 이력은 그대로 남습니다.

---

6. 자주 묻는 질문

FAQ

---