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

HubSpot 연락처 기반 워크플로우에서 웹훅을 트리거하는 방법

마지막 업데이트 날짜: 2025년 11월 26일

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

워크플로우에서 웹훅을 사용하여 HubSpot과 다른 외부 도구 간에 정보를 전송하거나 가져올 수 있습니다. 웹훅에는 다양한 용도가 있습니다. 웹훅의 대표적인 사용 사례는 다음과 같습니다:

  • 사이트에서 특정 양식을 작성한 연락처 데이터를 CRM과 같은 다른 시스템에 게시합니다.

  • 구매 주문을 생성하기 위해 거래 데이터를 외부 배송 처리 시스템으로 전송합니다.

  • 다른 시스템에서 데이터를 가져와 HubSpot 레코드를 업데이트합니다.

워크플로를 통해 POST 및 GET 요청을 모두 보낼 수 있습니다. HubSpot은 웹훅 트래픽을 다른 워크플로 프로세스와 별도로 관리합니다. 이는 워크플로와 웹훅 성능을 최적화하기 위함입니다. 웹훅이 느리거나 시간 초과될 경우 워크플로 작업 실행에 예상보다 오래 걸릴 수 있습니다.

참고: HubSpot은 실패한 웹훅을 실패 후 1분부터 최대 3일간 재시도합니다. 이후 실패 시 재시도 간격은 점차 증가하며, 최대 8시간 간격을 두고 재시도됩니다. 워크플로는 4XX 시리즈 응답 상태 코드를 수신한 후에는 재시도하지 않습니다.
이 규칙의 예외는 429 속도 제한 오류입니다. 워크플로는 429 응답을 수신한 후 자동으로 재시도하며, Retry-After 헤더가 존재할 경우 이를 준수합니다. Retry-After는 밀리초 단위로 기록됩니다. 특정 오류 코드 예외에 대해서는 HubSpot 개발자 문서에서

자세히

알아보세요.

웹훅에 대한 자세한 내용은 개발자 웹훅 문서에서 확인하세요. HubSpot을 사용한 웹훅 구현과 관련된 질문이 있으시면 HubSpot 개발자 포럼에 문의하세요.

POST 요청 설정

  1. HubSpot 계정에서 자동화 > 워크플로로 이동합니다.
  2. 기존 워크플로를 편집하려면 워크플로 이름을 클릭하세요. 또는 새 워크플로를 생성하세요.
  3. 워크플로 편집기에서 + 더하기 아이콘을 클릭하여 작업을 추가하세요.
  4. 왼쪽 패널의 데이터 작업 섹션에서 웹훅 보내기를 선택하세요.
     

  1. '메서드' 드롭다운 메뉴를 클릭하고 'POST'를 선택합니다.
  2. 웹훅 URL을 입력하세요.
    • 웹훅 URL은 보안 프로토콜로 제한되며 HTTPS로 시작해야 합니다.
    • 특정 정보를 요청하려면 웹훅 URL에 ?queryparameter=abc 와 같은 쿼리 매개 변수를 추가할 수 있습니다 .
    • 쿼리 매개변수가 추가되지 않은 경우 일반적인 POST 또는 GET 요청이 전송됩니다.
  3. 웹훅 요청 인증을 위해 인증 유형을 설정하세요. 웹훅 헤더에 요청 서명을 사용하거나 API 키를 사용할 수 있습니다:
    • 웹훅 헤더에 요청 서명을 사용하려면:
      • 인증 유형 드롭다운 메뉴를 클릭합니다. 그런 다음 헤더에 요청 서명 포함을 선택합니다.
      • 그런 다음 HubSpot 앱 ID를 입력하세요. 요청 서명 확인 방법을 알아보세요.
    • 개발자 계정을 통해 생성된 API 키 또는 공개 앱을 인증에 사용하려면:
      • 인증에 API 키를 사용할 경우, 사용되는 API 키 이름과 API 키 위치는 웹훅 구성 방식에 따라 달라집니다. 보안상의 이유로 API 키는 테스트 요청에 표시되지 않습니다. API 키 사용 방법:
        • 인증 유형 드롭다운 메뉴를 클릭하세요. 그런 다음 API 키를 선택하세요.
        • API 키 이름을 입력하세요.
        • API 키 위치 드롭다운 메뉴를 클릭합니다. 그런 다음 쿼리 매개변수 또는 요청 헤더 중 하나를 선택합니다. HubSpot에서 API 키 사용에 대해 자세히 알아보세요.
      • HubSpot API에 요청을 보내는 경우:
        • API 키 드롭다운 메뉴를 클릭하고 시크릿을 선택하세요. 시크릿 값은 Bearer [YOUR_TOKEN] 형식이어야 합니다.
        • API 키 이름 값을 'Authorization'으로 설정하세요.
        • API 키 위치 값을 요청 헤더 로 설정하세요.
  4. 모든 속성을 포함하려면 [객체] 속성 모두 포함을 선택하십시오.
  5. 특정 속성만 포함하려면:
    • 요청 본문을 사용자 지정하기를 선택하세요.
    • HubSpot 속성을 사용하여 요청 본문을 사용자 지정하려면 키를 입력하고 속성을 선택하십시오. 다른 속성을 추가하려면 속성 추가를 클릭하십시오.
    • 정적 필드를 사용하여 요청 본문을 사용자 지정하려면 키와 값을 입력하세요. 다른 속성을 추가하려면 정적 값 추가를 클릭하세요.
    • 속성 또는 정적 값을 제거하려면 휴지통 아이콘을 클릭하세요.
  6. 저장을 클릭하세요.

참고: 여러 출력을 선택하려면 응답이 JSON 객체 구조로 구성되어야 합니다.


 


GET 요청 설정

  1. HubSpot 계정에서 자동화 > 워크플로로 이동합니다.
  2. 기존 워크플로를 편집하려면 워크플로 이름을 클릭하세요. 또는 새 워크플로를 생성하세요.
  3. 워크플로 편집기에서 + 더하기 아이콘을 클릭하여 작업을 추가합니다.
  4. 왼쪽 패널의 데이터 작업 섹션에서 웹훅 보내기를 선택합니다.
     

  1. 메서드 드롭다운 메뉴를 클릭하고 GET을 선택합니다.
  2. 웹훅 URL을 입력하세요.
    • 웹훅 URL은 보안 프로토콜로 제한되며 HTTPS로 시작해야 합니다.
    • 특정 정보를 요청하려면 웹훅 URL에 ?queryparameter=abc 와 같은 쿼리 매개 변수를 추가할 수 있습니다 .
    • 쿼리 매개변수가 추가되지 않은 경우 일반적인 POST 또는 GET 요청이 전송됩니다.
  3. 웹훅 요청 인증을 위해 인증 유형을 설정하세요. 웹훅 헤더에 요청 서명을 사용하거나 API 키를 사용할 수 있습니다:
    • 웹훅 헤더에 요청 서명을 사용하려면:
      • 인증 유형 드롭다운 메뉴를 클릭합니다. 그런 다음 헤더에 요청 서명 포함을 선택합니다.
      • 그런 다음 HubSpot 앱 ID를 입력하세요. 요청 서명 확인 방법을 알아보세요.
    • 개발자 계정을 통해 생성된 API 키 또는 공개 앱을 인증에 사용하려면:
      • 인증에 API 키를 사용할 경우, 사용되는 API 키 이름과 API 키 위치는 웹훅 구성 방식에 따라 달라집니다. 보안상의 이유로 API 키는 테스트 요청에 표시되지 않습니다. API 키 사용 방법:
        • 인증 유형 드롭다운 메뉴를 클릭하세요. 그런 다음 API 키를 선택하세요.
        • API 키 이름을 입력하세요.
        • API 키 위치 드롭다운 메뉴를 클릭합니다. 그런 다음 쿼리 매개변수 또는 요청 헤더 중 하나를 선택합니다. HubSpot에서 API 키 사용에 대해 자세히 알아보세요.
      • HubSpot API에 요청을 보내는 경우:
        • API 키 드롭다운 메뉴를 클릭하고 시크릿을 선택하세요. 시크릿 값은 Bearer [YOUR_TOKEN] 형식이어야 합니다.
        • API 키 이름 값을 'Authorization'으로 설정하세요.
        • API 키 위치 값을 요청 헤더 로 설정하세요.
  4. GET 요청을 설정하는 경우 HubSpot 속성을 사용하거나 정적 값을 쿼리 매개변수로 추가할 수 있습니다: 
  1. 쿼리 매개변수로 HubSpot 속성을 사용하려면:
    • 쿼리 매개변수 섹션에서 키를 입력한 후 속성을 선택하세요.
    • 다른 속성을 추가하려면 '속성 추가'를 클릭하세요.
    • 속성을 제거하려면 삭제 아이콘을 클릭하세요.
  2. 쿼리 매개변수로 정적 값 사용하기:
    • 쿼리 매개변수 섹션 에서 키를 입력한 후 값을 입력하세요.
    • 다른 속성을 추가하려면 정적 값 추가를 클릭하세요.
    • 속성을 제거하려면 삭제 아이콘을 클릭하세요.
  3. 저장을 클릭합니다.


웹훅에 대한 속도 제한 설정

웹훅 작업이 실행되는 속도를 결정하기 위해 속도 제한을 설정하세요. 속도 제한은 워크플로우의 모든 후속 작업에도 영향을 미칩니다.

  1. HubSpot 계정에서 자동화 > 워크플로로 이동합니다.
  2. 워크플로 이름을 클릭하세요.
  3. 워크플로 편집기에서 '웹훅 보내기' 작업을 클릭하세요.
  4. 왼쪽 패널에서 속도 제한 구성을클릭하여 섹션을 확장하세요.
  5. 속도 제한 켜기 스위치를 클릭하여 켭니다. 기본적으로 이 설정은 꺼져 있습니다. 
  6. 속도 제한 설정: 
    • 작업 실행: 시간당 최대 실행 횟수를설정합니다 . 
    • 시간 범위: 속도 제한의 시간 범위를 설정합니다. 이 시간 범위는 초, 분 또는 시간으로 설정할 수 있습니다. 
속도 제한으로 인해 작업이 일시 중지된 경우, 작업이 실행되지 않으며워크플로의 작업 로그에 다음과 같은 오류가 표시됩니다: 이 작업은 구성된 속도 제한을 준수하기 위해 일시 중지되었습니다. [날짜 및 시간]에 재개될 예정입니다.


workflows-configure-rate-limit

 

HubSpot 내에서 웹훅 테스트하기

POST 또는 GET 웹훅 설정 시 테스트를 실행하여 웹훅 응답을 확인할 수 있습니다. 테스트 중에는 제3자에게 데이터가 전송되고 수신되지만, HubSpot의 기존 레코드에는 영향을 미치지 않습니다. 인증에 API 키를 사용하는 경우, 테스트 요청에는 API 키가 표시되지 않습니다.

웹훅 테스트 후 워크플로 후반부에 입력값으로 사용할 출력 필드를 선택할 수 있습니다. 모든 응답에서 제공되는 출력만 선택하세요. 후속 작업에서 사용된 출력이 응답에 포함되지 않으면 작업이 실패합니다.

  1. HubSpot 계정에서 자동화 > 워크플로로 이동합니다.
  2. 워크플로 이름을 클릭하세요.
  3. 워크플로 편집기에서 '웹훅 보내기' 작업을 클릭하세요.
  4. 왼쪽 패널에서 작업 테스트를 클릭하여 섹션을 확장하세요.
  5. POST 요청을 테스트하는 경우, 웹훅 테스트 설정은 요청 본문을 사용자 지정할지 또는 웹훅 작업에 모든 [객체] 속성을 포함할지 선택한 여부에 따라 달라집니다.
    • 요청 본문을 사용자 지정하도록 선택한 경우 테스트에 사용할 속성 테스트 값을 입력하세요.
    • [객체] 속성 모두 포함을 선택한 경우 [객체] 드롭다운 메뉴를 클릭한 다음 테스트할 레코드를 선택하십시오.
  6. 테스트를 클릭합니다.
  7. 웹훅 세부 정보를 확인하려면 응답 또는 요청 탭을 선택하십시오. 각 탭에서 모두 열기를 클릭하여 모든 섹션을 확장하거나 모두 접기를 클릭하여 모든 섹션을 접을 수 있습니다.
    • 응답 탭에서 헤더: 또는 본문:을 클릭하여 각 섹션을 확장합니다 .
    • 요청 탭에서 섹션을 확장하려면 httpHeaders:를 클릭하십시오.


웹훅을 외부에서 테스트하기

웹훅 액션으로 워크플로를 생성한 후, 더미 웹훅 URL로 빠르게 테스트할 수 있습니다:

  1. 브라우저에서 https://webhook.site 로 이동하여 고유 URL을 복사합니다.
  2. 웹훅 액션의 '웹훅 URL' 필드에 해당 URL을 붙여넣으세요.
  3. 워크플로가 활성화된 후에는 테스트용 연락처를 수동으로 등록할 수 있습니다.

  1. 외부에서 웹훅 테스트 시:
    • POST 요청이 포함된 웹훅 액션이 트리거되면, 양식 제출 내용, 리스트 멤버십, 모든 연락처 속성 값을 포함한 연락처에 대한 모든 정보가 담긴 JSON 응답 본문이 웹훅으로 전송됩니다. 수신 시스템은 JSON 데이터를 파싱하여 자체 애플리케이션에 활용할 수 있습니다.
    • 추가 쿼리 매개변수가 적용되지 않은 경우, GET 요청을 사용하는 웹훅 액션이 트리거되면 일반적인 GET 요청이 전송됩니다.

참고: 과거 속성 값은 연락처 기반 워크플로에서만 반환됩니다. 다른 모든 워크플로 유형에서 사용되는 웹훅은 최신 값만 반환합니다.

워크플로 웹훅에서 요청 서명 확인하기

웹훅 트리거 작업의 인증 섹션에서 요청 서명을 선택한 경우, HubSpot은 애플리케이션의 앱 시크릿, HTTP 메서드, URI 및 파싱되지 않은 본문을 연결한 SHA-256 해시를 X-HubSpot-Signature 헤더로 웹훅에 채웁니다. 자세한 내용은 개발자 문서를 참조하세요 .

URL로 수신된 요청이 HubSpot에서 온 것인지 확인하려면:

웹훅으로 워크플로 트리거하기

웹훅을 사용하여 워크플로를 트리거할 수 있습니다. 타사 앱에서 데이터가 변경되면 워크플로가 트리거될 수 있습니다. 웹훅으로 워크플로 트리거하기에 대해 자세히 알아보세요.

데이터 패널에서 웹훅 데이터 사용하기

계정에 연결된 웹훅의 데이터를 데이터 패널의 특정 작업에 사용할 수 있습니다.

연결된 웹훅의 데이터를 사용하려면:

  1. HubSpot 계정에서 자동화 > 워크플로로 이동합니다.
  2. 워크플로 이름을 클릭하세요.
  3. 작업 추가를 위해 + 더하기 아이콘 을 클릭하세요.
  4. 왼쪽 패널에서 데이터 패널을 사용하는 작업을 선택하세요.
  5. 데이터 패널에서 [ 속성 또는 작업 출력 보기] 드롭다운 메뉴를 클릭하고 [ 웹훅 트리거]를 선택하세요. 연결된 웹훅의 속성을 사용할 수 있습니다.
     

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

관련 콘텐츠

New call-to-action