웹훅은 한 서비스에서 사건이 생겼을 때 다른 서비스의 주소로 데이터를 보내는 방식입니다. 폼 제출, 결제 완료와 새 주문을 주기적으로 확인하지 않고 거의 바로 자동화를 시작할 수 있습니다.
요청 안에 무엇이 들어오나
보통 사건 종류, 발생 시각, 원본 ID와 관련 데이터가 JSON 형태로 전달됩니다. 자동화 도구의 테스트 주소로 표본을 받은 뒤 필드 이름과 빈 값 가능성을 확인합니다. 화면에 보이는 이름과 실제 필드 이름이 다를 수 있습니다.
주소는 비밀번호처럼 다룹니다
웹훅 URL을 아는 사람이 임의 요청을 보낼 수 있는 서비스도 있습니다. URL을 공개 문서나 로그에 넣지 않고, 제공되는 경우 서명 검증이나 비밀 토큰을 사용합니다. 발신 IP만 믿는 방식은 서비스 정책과 변경 가능성을 확인해야 합니다.
빠르게 응답하고 나중에 처리합니다
웹훅을 받은 서버가 오래 작업하면 발신 서비스가 실패로 판단해 같은 사건을 다시 보낼 수 있습니다. 수신과 기본 검증 후 빠르게 응답하고, 무거운 AI 처리나 파일 변환은 대기열에서 실행하는 구조가 안정적입니다.
중복은 정상 상황입니다
네트워크 오류와 재시도로 같은 이벤트가 여러 번 올 수 있습니다. 원본 이벤트 ID를 저장하고 이미 처리한 ID라면 결과를 다시 만들지 않습니다. ID가 없다면 안정적인 필드를 조합해 중복 키를 설계합니다.
실패한 사건을 보존합니다
잘못된 요청을 조용히 버리지 말고 수신 시각, 사건 ID와 오류 이유를 기록합니다. 개인정보와 비밀 토큰은 로그에서 가립니다. 수정 후 특정 사건만 안전하게 재처리할 수 있어야 합니다.
웹훅은 실시간 자동화의 출발점이지만 전달 성공이 업무 완료를 뜻하지는 않습니다. 목적지에 결과가 실제 생성됐는지까지 확인해야 완전한 워크플로가 됩니다.