베타웹훅 사용자 지정(베타)
마지막 업데이트 날짜: 2월 12, 2025
명시된 경우를 제외하고 다음 구독 중 어느 것에서나 사용할 수 있습니다.
|
워크플로에서 웹훅을 사용하여 워크플로에서 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 키를 사용할 때 사용되는 API 키 이름과 API 키 위치는 웹훅이 구성된 방식에 따라 달라집니다. 보안상의 이유로 API 키는 테스트 요청에 표시되지 않습니다. API 키를 사용하려면 다음과 같이 하세요:
-
-
- API 키 이름을 입력합니다.
- API 키 위치 드롭다운 메뉴를 클릭합니다. 그런 다음 쿼리 매개변수 또는 요청 헤더를선택합니다. HubSpot에서 API 키를 사용하는 방법에 대해 자세히 알아보세요.
-
POST 요청 사용자 지정
POST 요청을 설정하는 경우 CRM 레코드의 모든 속성을 포함하거나 특정 속성만 보내도록 선택할 수 있습니다:- 모든 속성을 포함하려면 요청 본문 사용자 지정 섹션에서 모든 속성 포함을 선택합니다.
- 특정 속성만 포함하려면 다음과 같이 하세요:
- 요청 본문 사용자 지정 섹션에서 특정 속성 선택을 선택합니다.
- 속성 선택 드롭다운 메뉴를 클릭합니다. 그런 다음 이 워크플로우에서 [개체] 를 클릭하고 속성을 선택합니다.
- 웹훅에서 속성 이름을 변경하려면 속성 이름 텍스트 필드를 편집합니다. 이렇게 하면 POST 요청의 속성 이름만 업데이트되며, HubSpot의 속성 이름이나 내부 이름은 업데이트되지 않습니다.
- 다른 속성을 추가하려면 속성 추가를 클릭합니다.
- 속성을 제거하려면 delete 휴지통 아이콘을 클릭합니다.
GET 요청 사용자 지정하기
GET 요청을 설정하는 경우 속성을 쿼리 매개변수로 사용하여 특정 데이터를 검색할 수 있습니다:- 쿼리 매개변수 섹션에서 속성 선택 드롭다운 메뉴를 클릭합니다. 그런 다음 이 워크플로우에서 [개체] 를 클릭하고 속성을 선택합니다.
- 쿼리 매개변수에서 속성 이름을 변경하려면 속성 이름 텍스트 필드를 편집합니다. 이렇게 하면 GET 요청의 속성 이름만 업데이트되며, HubSpot의 속성 이름이나 내부 이름은 업데이트되지 않습니다.
- 다른 속성을 추가하려면 쿼리 매개변수 추가를 클릭합니다.
- 속성을 제거하려면 delete 휴지통 아이콘을 클릭합니다.
- 저장을 클릭합니다.
Workflows
피드백을 보내 주셔서 감사합니다. 당사에 큰 도움이 될 것입니다.
이 양식은 문서 피드백에만 사용됩니다. HubSpot으로 도움을 받는 방법 알아보기.