마지막 업데이트 날짜: 2025년 7월 29일
외부 타사로부터 웹훅이 수신되면 워크플로우에 자동으로 레코드를 등록하도록 등록 트리거를 설정하세요. 워크플로 등록 설정에 대해 자세히 알아보세요.
참고하세요:
- 워크플로는 HubSpot 계정에 해당 고유 속성 값을 가진 기존 레코드가 있는 경우에만 트리거됩니다.
- 웹훅 트리거는 애플리케이션/json 콘텐츠 유형으로 전송된 수신 데이터만 지원합니다.
웹훅에서 워크플로를 트리거하려면 다음과 같이 하세요:
- HubSpot 계정에서 자동화 > 워크플로로 이동합니다.
- 기존 워크플로우의 이름을 클릭하거나 새 워크플로우를 만듭니다.
- 워크플로를 처음부터 새로 만드는 경우:
- 왼쪽 패널에서 사용자 지정 이벤트 및 외부 이벤트 섹션을 클릭하여 펼칩니다.
- 외부 앱에서 웹훅 수신하기를 클릭합니다.
- 기존 워크플로우에서 작업하는 경우:
- 워크플로 편집기에서 [대상] 카드 에 대한 등록 트리거를 클릭합니다.
- 기존 워크플로 트리거가 있는 경우 왼쪽 패널에서 시작 트리거 변경을 클릭합니다. 그러면 현재 등록 트리거가 모두 지워집니다.
- 대화 상자에서 확인을 클릭합니다.
-
- 왼쪽 패널의 고급 옵션 아래에서 웹훅 수신 시기를 클릭합니다.
- 새 웹훅을 추가하려면 + 웹훅 추가를 클릭합니다. 고유한 웹훅 이벤트는 최대 100개까지 만들 수 있습니다.
- 웹후크 이벤트 이름을 추가합니다. 그런 다음 다음을 클릭합니다.
- 웹후크 URL을 복사하여 연동하려는 앱의 웹후크 설정 페이지에 붙여넣습니다. 앱에서 웹후크 URL을 사용하여 테스트 이벤트를 전송합니다.
- 테스트 이벤트 검토 섹션에서 웹후크 이벤트를 검토하고 필요에 따라 업데이트합니다. 그런 다음 다음을 클릭합니다.
- 웹훅 속성에 대한 데이터를 매핑합니다:
- 필요에 따라 HubSpot 속성 레이블을 편집합니다.
- 데이터 유형 드롭다운 메뉴를 클릭하여 각 속성 레이블에 대한 데이터 유형을 선택합니다.
- 문자열, 열거형, 숫자 및 부울 값을 사용할 수 있습니다.
- 날짜/시간 속성은 지원되지 않으므로 대신 문자열 값으로 매핑해야 합니다. 그런 다음
strtotime을 사용하여 사용자 정의 코드 작업을 수행하여 날짜 시간 개체로 변환한 다음unixtimestamp을 사용하여 타임스탬프를 가져올 수 있습니다.
- 속성 레이블을 제거하려면 삭제 아이콘을 클릭합니다.
- 다음을 클릭합니다.
- 타사 웹훅에서 HubSpot 사용자 지정 속성 중 하나와 정확히 일치하는 속성을 선택하여 등록 속성을 일치시킵니다. 그런 다음 다음을 클릭합니다.
- 선택한 타사 웹후크 속성에 들어오는 웹후크 데이터에 비어 있지 않은 값이 있는 경우에만 워크플로가 트리거될 수 있습니다.
- 사용자 지정 속성에 고유한 속성 값 필요 확인란이 선택되어 있어야 합니다. 또는 고유한 값이 필요한 새 속성을 만듭니다.
- 계속을 클릭하여 설정을 트리거합니다.
- 웹훅을 등록 트리거로 사용하려면 왼쪽 패널에서 웹훅의 이름을 클릭합니다. 그런 다음 저장을 클릭합니다.