워크플로우에서 웹후크를 사용하여 HubSpot과 다른 외부 도구 간에 정보를 보내거나 검색할 수 있습니다. 웹후크에는 다양한 용도가 있으며, 웹후크의 인기 있는 사용 사례의 예는 다음과 같습니다:
워크플로를 사용하여 POST 및 GET 요청을 모두 보낼 수 있습니다. HubSpot은 웹훅 트래픽을 다른 워크플로 프로세스와 별도로 규제합니다. 이는 워크플로우 및 웹후크 성능을 간소화하기 위한 것입니다. 웹후크가 느리거나 시간이 초과되면 워크플로 작업이 실행되는 데 예상보다 오래 걸릴 수 있습니다.
참고: HubSpot은 실패한 웹훅을 실패 후 1분부터 최대 3일 동안 재시도합니다. 이후의 실패는 점점 더 긴 간격으로 재시도되며, 최대 8시간의 간격으로 재시도됩니다. 워크플로는 4XX 시리즈 응답 상태 코드를 받은 후에는 다시 시도하지 않습니다.
이 규칙의 한 가지 예외는 429 속도 제한 오류로, 워크플로는 429 응답을 받은 후 자동으로 재시도하며, Retry-After 헤더가 있는 경우 이를 준수합니다. 재시도 후는 밀리초 단위로 기록됩니다. 특정 오류 코드 예외에 대한 자세한 내용은 HubSpot의 개발자 문서에서 확인하세요.
개발자 웹후크 문서에서 웹후크에 대해 자세히 알아보세요. 구체적인 웹후크 구현에 대한 질문이 있는 경우 HubSpot 개발자 포럼에 문의하세요.
POST 요청 설정하기
- HubSpot 계정에서 자동화 > 워크플로로 이동합니다.
- 기존 워크플로를 편집하려면 워크플로의 이름을 클릭합니다. 또는 새 워크플로를 만듭니다.
- 워크플로 편집기에서 + 더하기 아이콘을 클릭하여 작업을 추가합니다.
- 왼쪽 패널의 데이터 작업 섹션에서 웹훅 보내기를 선택합니다.
- 방법 드롭다운 메뉴를 클릭하고 게시를 선택합니다.
- 웹훅 URL을 입력합니다.
- 웹후크 URL은 보안 프로토콜로 제한되며 HTTPS로 시작해야 합니다.
- 특정 정보를 요청하려면 웹후크 URL에
?queryparameter=abc 등의 쿼리 매개변수를 추가할 수 있습니다.
- 쿼리 매개변수를 추가하지 않으면 일반 POST 또는 GET 요청이 전송됩니다.
- 웹훅에 대한 요청을 인증할 인증 유형을 설정합니다. 웹훅 헤더에 요청 서명을 사용하거나 API 키를 사용할 수 있습니다:
- 웹훅 헤더에 요청 서명을 사용하려면 다음과 같이 하세요:
- 인증 유형 드롭다운 메뉴를 클릭합니다. 그런 다음 헤더에 요청 서명 포함을 선택합니다.
- 그런 다음 HubSpot 앱 ID를 입력합니다. 요청 서명을 확인하는 방법을 알아보세요.
-
- API 키 또는 개발자 계정을 통해 만든 공개 앱을 인증에 사용하려면 다음과 같이 하세요:
-
-
- 인증에 API 키를 사용할 때 사용되는 API 키 이름과 API 키 위치는 웹훅이 구성된 방식에 따라 달라집니다. 보안상의 이유로 API 키는 테스트 요청에 표시되지 않습니다. API 키를 사용하려면 다음과 같이 하세요:
- 인증 유형 드롭다운 메뉴를 클릭합니다. 그런 다음 API 키를 선택합니다.
-
-
-
- API 키 이름을 입력합니다.
- API 키 위치 드롭다운 메뉴를 클릭합니다. 그런 다음 쿼리 매개변수 또는 요청 헤더를 선택합니다. HubSpot에서 API 키를 사용하는 방법에 대해 자세히 알아보세요.
- HubSpot API에 요청하는 경우:
- API 키 드롭다운 메뉴를 클릭하고 비밀번호를 선택합니다. 비밀 값은 Bearer [YOUR_TOKEN] 형식이어야 합니다.
- API 키 이름 값을 권한 부여로 설정합니다.
- API 키 위치 값을 요청 헤더로 설정합니다.
- 모든 속성을 포함하려면 모든 [개체] 속성 포함을 선택합니다.
- 특정 속성만 포함하려면:
- 요청 본문 사용자 지정을 선택합니다.
- HubSpot 속성을 사용하여 요청 본문을 사용자 지정하려면 키를 입력하고 속성을 선택합니다. 다른 속성을 추가하려면 속성 추가를 클릭합니다.
- 정적 필드를 사용하여 요청 본문을 사용자 지정하려면 키와 값을 입력합니다. 다른 속성을 추가하려면 정적 값 추가를 클릭합니다.
-
- 속성 또는 정적 값을 제거하려면 delete 휴지통 아이콘을 클릭합니다.
- 저장을 클릭합니다.
참고: 여러 출력을 선택하려면 응답을 JSON 객체로 구조화해야 합니다.
GET 요청 설정하기
- HubSpot 계정에서 자동화 > 워크플로로 이동합니다.
- 기존 워크플로를 편집하려면 워크플로의 이름을 클릭합니다. 또는 새 워크플로를 만듭니다.
- 워크플로 편집기에서 + 더하기 아이콘을 클릭하여 작업을 추가합니다.
- 왼쪽 패널의 데이터 작업 섹션에서 웹훅 보내기를 선택합니다.
- 방법 드롭다운 메뉴를 클릭하고 GET을 선택합니다.
- 웹훅 URL을 입력합니다.
- 웹후크 URL은 보안 프로토콜로 제한되며 HTTPS로 시작해야 합니다.
- 특정 정보를 요청하려면 웹후크 URL에
?queryparameter=abc 등의 쿼리 매개변수를 추가할 수 있습니다.
- 쿼리 매개변수를 추가하지 않으면 일반 POST 또는 GET 요청이 전송됩니다.
- 웹훅에 대한 요청을 인증할 인증 유형을 설정합니다. 웹훅 헤더에 요청 서명을 사용하거나 API 키를 사용할 수 있습니다:
- 웹훅 헤더에 요청 서명을 사용하려면 다음과 같이 하세요:
- 인증 유형 드롭다운 메뉴를 클릭합니다. 그런 다음 헤더에 요청 서명 포함을 선택합니다.
- 그런 다음 HubSpot 앱 ID를 입력합니다. 요청 서명을 확인하는 방법을 알아보세요.
-
- API 키 또는 개발자 계정을 통해 만든 공개 앱을 인증에 사용하려면 다음과 같이 하세요:
-
-
- 인증에 API 키를 사용할 때 사용되는 API 키 이름과 API 키 위치는 웹훅이 구성된 방식에 따라 달라집니다. 보안상의 이유로 API 키는 테스트 요청에 표시되지 않습니다. API 키를 사용하려면 다음과 같이 하세요:
- 인증 유형 드롭다운 메뉴를 클릭합니다. 그런 다음 API 키를 선택합니다.
-
-
-
- API 키 이름을 입력합니다.
- API 키 위치 드롭다운 메뉴를 클릭합니다. 그런 다음 쿼리 매개변수 또는 요청 헤더를 선택합니다. HubSpot에서 API 키를 사용하는 방법에 대해 자세히 알아보세요.
- HubSpot API에 요청하는 경우:
- API 키 드롭다운 메뉴를 클릭하고 비밀번호를 선택합니다. 비밀 값은 Bearer [YOUR_TOKEN] 형식이어야 합니다.
- API 키 이름 값을 권한 부여로 설정합니다.
- API 키 위치 값을 요청 헤더로 설정합니다.
GET 요청을 설정하는 경우 HubSpot 속성을 사용하거나 쿼리 매개변수로 정적 값을 추가할 수 있습니다:
- HubSpot 속성을 쿼리 매개변수로 사용하려면 다음과 같이 하세요:
- 쿼리 매개변수 섹션에서 키를 입력한 다음 속성을 선택합니다.
- 다른 속성을 추가하려면 속성 추가를 클릭합니다.
- 속성을 제거하려면 delete 휴지통 아이콘을 클릭합니다.
- 정적 값을 쿼리 매개변수로 사용하려면 다음과 같이 하세요:
- 쿼리 매개변수 섹션에서 키를 입력한 다음 값을 입력합니다.
- 다른 속성을 추가하려면 정적 값 추가를 클릭합니다.
- 속성을 제거하려면 delete 휴지통 아이콘을 클릭합니다.
- 저장을 클릭합니다.
HubSpot 내에서 웹훅 테스트하기
POST 또는 GET 웹훅을 설정할 때 테스트를 실행하여 웹훅 응답을 확인할 수 있습니다. 테스트하는 동안 데이터가 타사로 전송되고 타사에서 검색되는 동안 HubSpot의 기존 레코드는 영향을 받지 않습니다. 인증에 API 키를 사용하는 경우 API 키는 테스트 요청에 표시되지 않습니다.
웹훅을 테스트한 후에는 나중에 워크플로우에서 입력으로 사용하기 위해 출력할 필드를 선택할 수 있습니다. 모든 응답에서 사용 가능한 출력만 선택합니다. 출력이 나중에 작업에서 사용되지만 응답에서 사용할 수 없는 경우 작업은 실패합니다.
- HubSpot 계정에서 자동화 > 워크플로로 이동합니다.
- 워크플로우의 이름을 클릭합니다.
- 워크플로 편집기에서 웹훅 보내기 작업을 클릭합니다.
- 왼쪽 패널에서 작업 테스트를 클릭하여 섹션을 펼칩니다.
- POST 요청을 테스트하는 경우 [개체] 드롭다운 메뉴를 클릭한 다음 테스트할 레코드를 선택합니다.
- 테스트를 클릭합니다.
- 웹훅 세부 정보를 확인하려면 응답 또는 요청 탭을 선택합니다. 각 탭에서 모두 열기를 클릭하여 모든 섹션을 확장하거나 모두 접기를 클릭하여 모든 섹션을 축소할 수 있습니다.
- 응답 탭에서 헤더: 또는 본문: 을 클릭하여 각 섹션을 펼칩니다.
- 요청 탭에서 httpHeaders: 를 클릭하여 섹션을 펼칩니다.
외부에서 웹훅 테스트하기
웹훅 액션으로 워크플로를 만든 후에는 더미 웹훅 URL을 사용하여 빠른 테스트를 실행할 수 있습니다:
- 외부에서 웹후크를 테스트하는 경우:
- POST 요청이 있는 웹후크 작업이 트리거되면 양식 제출, 목록 멤버십 및 모든 연락처 속성 값을 포함하여 연락처에 대한 모든 정보가 포함된 JSON 응답 본문이 웹후크로 전송됩니다. 그러면 수신 시스템에서 JSON 데이터를 파싱하여 자체 애플리케이션에 사용할 수 있습니다.
- GET 요청이 포함된 웹훅 작업이 트리거되면 추가 쿼리 매개변수가 적용되지 않는 한 일반 GET 요청이 전송됩니다.
참고: 기록 속성 값은 연락처 기반 워크플로우에서만 반환됩니다. 다른 모든 워크플로우 유형에서 사용되는 웹후크는 가장 최근 값만 반환합니다.
워크플로 웹후크에서 요청 서명 확인하기
웹후크 트리거 동작의 인증 섹션에서 요청 서명을 선택한 경우, HubSpot은 애플리케이션의 앱 비밀, HTTP 메서드, URI 및 파싱되지 않은 본문이 연결된 SHA-256 해시가 포함된 X-HubSpot-Signature 헤더를 웹후크에 채웁니다. 이에 대한 자세한 내용은 개발자 문서에서 확인하세요.
URL에서 수신된 요청이 HubSpot에서 온 것인지 확인합니다:
웹훅에서 워크플로 트리거하기
웹후크를 사용하여 워크플로를 트리거할 수 있습니다. 타사 앱에서 데이터가 변경되면 워크플로가 트리거될 수 있습니다. 웹후크에서 워크플로를 트리거하는 방법에 대해 자세히 알아보세요.
데이터 패널에서 웹후크 데이터 사용
계정에 연결된 웹후크의 데이터를 데이터 패널의 특정 작업에 사용할 수 있습니다.
연결된 웹후크의 데이터를 사용하려면 다음과 같이 하세요:
- HubSpot 계정에서 자동화 > 워크플로로 이동합니다.
- 워크플로우의 이름을 클릭합니다.
- 더하기 아이콘을 클릭하여 작업을 추가합니다.
- 왼쪽 패널에서 데이터 패널을 사용하는 작업을 선택합니다.
- 데이터 패널에서 속성 또는 작업 출력 보기 드롭다운 메뉴를 클릭하고 웹훅 트리거를 선택합니다. 그러면 연결된 웹훅의 속성을 사용할 수 있습니다.
Workflows
Operations Hub
Professional
,
Enterprise
