주의:: 이 문서는 사용자의 편의를 위해 제공됩니다. 이 문서는 번역 소프트웨어를 사용하여 자동으로 번역되었으며 교정을 거치지 않았을 수 있습니다. 이 문서의 영어 버전이 가장 최신의 정보를 확인할 수 있는 공식 버전으로 간주해야 합니다. 여기에서 액세스할 수 있습니다..
'웹훅 수신 시' 워크플로 트리거 설정
마지막 업데이트 날짜: 2026년 8월 3일
외부 타사 애플리케이션에서 웹훅이 수신되면 레코드가 워크플로에 자동으로 등록되도록 등록 트리거를 설정하세요. 워크플로 등록 설정에 대해 자세히 알아보세요.
제한 사항 및 요구 사항 이해
-
HubSpot 계정에 해당 고유 속성 값을 가진 기존 레코드가 있는 경우에만 워크플로가 트리거됩니다.
- 웹훅 트리거는 application/json 콘텐츠 유형으로 전송된 수신 데이터만 지원합니다.
'웹훅 수신 시' 워크플로 트리거 설정
웹훅을 통해 워크플로를 트리거하려면:
- HubSpot 계정에서 더 보기를 클릭한 다음 자동화 > 워크플로로 이동하세요. 더 보기가 계정에 표시되지 않으면 바로 자동화 > 워크플로로 이동하세요.
- 기존 워크플로우의 이름을 클릭하거나 새 워크플로우를 생성합니다.
- 워크플로를 처음부터 생성하는 경우:
- 왼쪽 패널에서 ‘사용자 정의 이벤트 및 외부 이벤트’ 섹션을 클릭하여 펼칩니다.
- '외부 앱에서 웹훅 수신'을 클릭합니다.
- 기존 워크플로를 편집하는 경우:
- 워크플로 편집기에서 [객체] 등록 트리거 카드를 클릭합니다.
- 기존 워크플로 트리거가 있는 경우, 왼쪽 패널에서 '시작 트리거 변경'을 클릭합니다. 이렇게 하면 현재 등록 트리거가 모두 삭제됩니다.
- 표시되는 대화 상자에서 ‘확인’을 클릭합니다.
-
- 왼쪽 패널의 ‘고급 옵션’에서 ‘웹훅 수신 시’를 클릭합니다.
- 새 웹훅을 추가하려면 ‘+ 웹훅 추가’를 클릭하십시오. 최대 100개의 고유한 웹훅 이벤트를 생성할 수 있습니다.

- 웹훅 이벤트 이름을 입력한 다음 ‘다음’을 클릭합니다.
- 웹훅 URL을 복사하여 연동하려는 앱의 웹훅 설정 페이지에 붙여넣으세요. 앱에서 웹훅 URL을 사용하여 테스트 이벤트를 전송해 보세요.

- '테스트 이벤트 검토' 섹션에서 웹훅 이벤트를 확인하고 필요한 경우 수정하십시오. 그런 다음 '다음'을 클릭하십시오.
- 웹훅 속성에 대한 데이터를 매핑하세요:
- 필요 에 따라 HubSpot 속성 레이블 을 편집하세요.
- '데이터 유형' 드롭다운 메뉴를 클릭하여 각 속성 레이블에 대한 데이터 유형을 선택하세요.
- 문자열, 열거형, 숫자 및 부울 값을 사용할 수 있습니다.
- 날짜/시간 속성은 지원되지 않으므로 대신 문자열 값으로 매핑해야 합니다. 이후
strtotime을 사용하는 사용자 정의 코드 액션을 통해 날짜/시간 객체로 변환한 다음,unixtimestamp을 사용하여 타임스탬프를 가져올 수 있습니다.
- 속성 레이블을 제거하려면 삭제 아이콘을 클릭하십시오.
- '다음'을 클릭하세요.
- HubSpot 사용자 정의 속성 중 하나와 정확히 일치하는 타사 웹훅의 속성을 선택하여 등록 속성을 매칭하십시오. 그런 다음 ‘다음’을 클릭하십시오.
- 선택한 타사 웹훅 속성의 수신 웹훅 데이터에 비어 있지 않은 값이 있는 경우에만 워크플로가 트리거될 수 있습니다.
- 사용자 정의 속성의 ‘속성에 고유 값 필수’ 확인란이 선택되어 있어야 합니다. 또는 고유 값이 필수인 새 속성을 생성하십시오.
- '계속'을 클릭하여 설정을 시작하세요.
- 웹훅을 등록 트리거로 사용하려면 왼쪽 패널에서 웹훅 이름을 클릭하십시오. 그런 다음 ‘저장’을 클릭하십시오.
Workflows
피드백을 보내 주셔서 감사합니다. 당사에 큰 도움이 될 것입니다.
이 양식은 문서 피드백에만 사용됩니다. HubSpot으로 도움을 받는 방법 알아보기.
