콘텐츠로 건너뛰기
주의:: 이 문서는 사용자의 편의를 위해 제공됩니다. 이 문서는 번역 소프트웨어를 사용하여 자동으로 번역되었으며 교정을 거치지 않았을 수 있습니다. 이 문서의 영어 버전이 가장 최신의 정보를 확인할 수 있는 공식 버전으로 간주해야 합니다. 여기에서 액세스할 수 있습니다..

'웹훅 수신 시' 워크플로 트리거 설정

마지막 업데이트 날짜: 2026년 8월 3일

명시된 경우를 제외하고 다음 구독 중 어느 것에서나 사용할 수 있습니다.

외부 타사 애플리케이션에서 웹훅이 수신되면 레코드가 워크플로에 자동으로 등록되도록 등록 트리거를 설정하세요. 워크플로 등록 설정에 대해 자세히 알아보세요.

제한 사항 및 요구 사항 이해

권한 필요 워크플로를 생성하고 편집하려면 슈퍼 관리자 또는 워크플로 권한이 필요합니다.

  • HubSpot 계정에 해당 고유 속성 값을 가진 기존 레코드가 있는 경우에만 워크플로가 트리거됩니다.

  • 웹훅 트리거는 application/json 콘텐츠 유형으로 전송된 수신 데이터만 지원합니다.

'웹훅 수신 시' 워크플로 트리거 설정

웹훅을 통해 워크플로를 트리거하려면:

  1. HubSpot 계정에서 더 보기를 클릭한 다음 자동화 > 워크플로로 이동하세요. 더 보기가 계정에 표시되지 않으면 바로 자동화 > 워크플로로 이동하세요.
  2. 기존 워크플로우의 이름을 클릭하거나 새 워크플로우를 생성합니다.
  3. 워크플로를 처음부터 생성하는 경우:
    • 왼쪽 패널에서 ‘사용자 정의 이벤트 및 외부 이벤트’ 섹션을 클릭하여 펼칩니다.
    • '외부 앱에서 웹훅 수신'을 클릭합니다.
  4. 기존 워크플로를 편집하는 경우:
    • 워크플로 편집기에서 [객체] 등록 트리거 카드를 클릭합니다.
    • 기존 워크플로 트리거가 있는 경우, 왼쪽 패널에서 '시작 트리거 변경'을 클릭합니다. 이렇게 하면 현재 등록 트리거가 모두 삭제됩니다.
    • 표시되는 대화 상자에서 ‘확인’을 클릭합니다.
    • 왼쪽 패널의 ‘고급 옵션’에서 ‘웹훅 수신 시’를 클릭합니다.
  1. 새 웹훅을 추가하려면 ‘+ 웹훅 추가’를 클릭하십시오. 최대 100개의 고유한 웹훅 이벤트를 생성할 수 있습니다.

workflows-webhook-add

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


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