Webhook 연동

응답이 들어올 때마다 내 서버로 보내기. 아직 시험 중인 기능이에요.

Webhook이란

응답이 들어올 때마다 정한 주소로 응답 내용을 담은 요청을 보내요. 사내 시스템이나 자동화 도구로 응답을 보낼 때 써요.

주의 아직 시험 중인 기능이에요. 외부 주소로 보내지 못하는 경우가 있어 원인을 확인하고 있어요. 설정한 뒤 전송 이력에 성공으로 남는지 꼭 확인하고, 실패가 이어지면 오른쪽 아래 채널톡으로 알려 주세요. 전송에 실패해도 응답은 저장돼요.

설정하기

  1. 설문 설정이나 설문 상세 화면의 Webhook 연동에서 Webhook 추가를 눌러요.
  2. 받을 주소를 http나 https로 시작하게 적어요.
  3. 필요하면 서명 비밀키를 적어요. 요청에 서명 헤더가 붙어서 위조된 요청을 가려낼 수 있어요.
  4. 사용을 켜고 저장해요. 꺼 두면 응답이 들어와도 보내지 않아요.

주의 더폼 서버에서 직접 보내기 때문에 인터넷에서 접속할 수 있는 주소여야 해요. localhost나 사내망 주소처럼 인터넷에 공개되지 않은 주소로는 보내지 않고 실패로 기록해요. 주소에 아이디와 비밀번호를 넣는 형식(https://아이디:비밀번호@주소)도 쓸 수 없어요. 인증이 필요하면 서명 비밀키를 쓰세요.

전송 이력

Webhook 연동의 전송 이력에서 최근 전송 결과를 볼 수 있어요. 건마다 성공·실패와 응답 코드, 시도 횟수가 남아요.

팁 전송에 실패하면 잠시 뒤 두 번 더 보내요. 그래도 실패하면 이력에 실패로 남아요. 응답은 그대로 저장되니 결과 화면에서 볼 수 있어요.

주의 보낼 수 없는 주소라고 판단하면 다시 보내지 않고 한 번만 실패로 기록하며, 이력에 이유를 적어요. 적어 둔 주소가 다른 주소로 넘기는 응답(3xx)을 돌려줘도 따라가지 않고 실패로 기록하니, 최종 주소를 직접 적어 주세요.

관련 문서