콘텐츠로 건너뛰기

웹훅 사용자 지정(베타)

마지막 업데이트 날짜: 2월 12, 2025

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

Operations Hub   Professional , Enterprise

워크플로에서 웹훅을 사용하여 워크플로에서 POST 또는 GET 요청을 보내는 경우 웹훅을 사용자 지정하여 주고받는 데이터를 제어할 수 있습니다.

POST 요청에서는 CRM과 같은 외부 시스템으로 전송되는 속성을 지정할 수 있습니다. 마찬가지로 GET 요청에서는 쿼리 매개변수를 통해 요청되는 속성을 지정할 수 있습니다.

개발자 웹훅 문서에서 웹훅에 대해 자세히 알아보세요. HubSpot에서 웹후크를 구체적으로 구현하는 방법에 대해 궁금한 점이 있으면 HubSpot 개발자 포럼에 문의하세요.

참고: 실패한 웹훅은 실패 후 1분부터 최대 3일 동안 재시도됩니다. 이후의 실패는 점점 더 긴 간격으로 재시도되며, 최대 8시간의 간격을 두고 재시도합니다. 특정 오류 코드 예외에 대한 자세한 내용은 HubSpot의 개발자 문서에서 확인하세요.

웹훅 설정하기

웹훅을 만들고 사용자 지정하려면 다음과 같이 하세요:

  • HubSpot 계정에서 자동화 > 워크플로로 이동합니다.
  • 워크플로우의 이름을 클릭합니다.
  • 아이콘을 클릭하여 작업을 추가합니다.
  • 오른쪽 패널에서 웹훅 보내기를 선택합니다.
  • 방법 드롭다운 메뉴를 클릭한 다음 POST 또는 GET을 선택합니다.
  • 웹후크 URL을 입력합니다. 웹훅 URL은 보안 프로토콜로 제한되며 HTTPS로 시작해야 합니다. 특정 정보를 요청하려면 웹후크 URL에 ?queryparameter=abc 등의 쿼리 매개변수를 추가할 수 있습니다. 쿼리 매개변수를 추가하지 않으면 일반 POST 또는 GET 요청이 전송됩니다.
  • 웹훅에 대한 요청을 인증할 인증 유형을 설정합니다:
    • 웹훅 헤더에 요청 서명을 사용하려면 다음과 같이 하세요:
      • 인증 유형 드롭다운 메뉴를 클릭합니다. 그런 다음 헤더에 요청 서명 포함을 선택합니다.
      • 그런 다음 HubSpot 앱 ID를 입력합니다. 요청 서명을 확인하는 방법을 알아보세요.
    • 인증에 API 키를 사용할 수도 있습니다. 인증에 API 키를 사용할 때 사용되는 API 키 이름과 API 키 위치는 웹훅이 구성된 방식에 따라 달라집니다. 보안상의 이유로 API 키는 테스트 요청에 표시되지 않습니다. API 키를 사용하려면 다음과 같이 하세요:
      • 인증 유형 드롭다운 메뉴를 클릭합니다. 그런 다음 API 키를 선택합니다.
      • API 키 이름을 입력합니다.
      • API 키 위치 드롭다운 메뉴를 클릭합니다. 그런 다음 쿼리 매개변수 또는 요청 헤더를선택합니다. HubSpot에서 API 키를 사용하는 방법에 대해 자세히 알아보세요.

POST 요청 사용자 지정

POST 요청을 설정하는 경우 CRM 레코드의 모든 속성을 포함하거나 특정 속성만 보내도록 선택할 수 있습니다:
  • 모든 속성을 포함하려면 요청 본문 사용자 지정 섹션에서 모든 속성 포함을 선택합니다.
  • 특정 속성만 포함하려면 다음과 같이 하세요:
    • 요청 본문 사용자 지정 섹션에서 특정 속성 선택을 선택합니다.
    • 속성 선택 드롭다운 메뉴를 클릭합니다. 그런 다음 이 워크플로우에서 [개체] 를 클릭하고 속성을 선택합니다.
    • 웹훅에서 속성 이름을 변경하려면 속성 이름 텍스트 필드를 편집합니다. 이렇게 하면 POST 요청의 속성 이름만 업데이트되며, HubSpot의 속성 이름이나 내부 이름은 업데이트되지 않습니다.
    • 다른 속성을 추가하려면 속성 추가를 클릭합니다.
    • 속성을 제거하려면 delete 휴지통 아이콘을 클릭합니다.


GET 요청 사용자 지정하기

GET 요청을 설정하는 경우 속성을 쿼리 매개변수로 사용하여 특정 데이터를 검색할 수 있습니다:
  • 쿼리 매개변수 섹션에서 속성 선택 드롭다운 메뉴를 클릭합니다. 그런 다음 이 워크플로우에서 [개체] 를 클릭하고 속성을 선택합니다.
  • 쿼리 매개변수에서 속성 이름을 변경하려면 속성 이름 텍스트 필드를 편집합니다. 이렇게 하면 GET 요청의 속성 이름만 업데이트되며, HubSpot의 속성 이름이나 내부 이름은 업데이트되지 않습니다.
  • 다른 속성을 추가하려면 쿼리 매개변수 추가를 클릭합니다.
  • 속성을 제거하려면 delete 휴지통 아이콘을 클릭합니다.
  • 저장을 클릭합니다.


이 문서가 도움이 되었나요?
이 양식은 문서 피드백에만 사용됩니다. HubSpot으로 도움을 받는 방법 알아보기.