베타에이전트에서 웹훅 사용
마지막 업데이트 날짜: 2026년 7월 23일
명시된 경우를 제외하고 다음 구독 중 어느 것에서나 사용할 수 있습니다.
-
마케팅 Hub Professional, Enterprise
-
영업 Hub Professional, Enterprise
-
Service Hub Professional, Enterprise
-
Data Hub Professional, Enterprise
-
콘텐츠 Hub Professional, Enterprise
-
Smart CRM Professional, Enterprise
-
HubSpot 크레딧 필요
에이전트에서 웹훅 액션을 사용하여 외부 시스템과 데이터를 주고받을 수 있습니다. 에이전트 빌더에서 웹훅 액션을 구성하여 HTTP 요청(예: GET 또는 POST)을 보내거나, 외부 프로세스를 트리거하거나, 데이터를 가져올 수 있습니다.
웹훅 액션을 사용하면 별도의 맞춤 통합 없이도 에이전트를 외부 도구와 연결할 수 있습니다. 예를 들어, 거래 데이터를 외부 시스템으로 전송하여 주문 처리 절차를 시작하거나, 다른 플랫폼에서 고객 정보를 가져와 에이전트의 출력 결과에 활용할 수 있습니다.
참고: AI 설정에서 AI 기능 액세스를 관리할 수 있으며, 어떤 데이터를 공유할지 구성할 수 있습니다. AI 보안 제어, 데이터 사용 및 규정 준수에 대한 자세한 내용은 HubSpot의 AI 신뢰 FAQ 및 AI 모델 카드를 검토하세요.
시작하기 전에
에이전트에서 웹훅을 사용하기 전에 요구 사항과 고려 사항을 검토하십시오.
-
슈퍼 관리자가 AI 설정에서 다음 스위치를 켜야 합니다:
-
사용자에게 생성형 AI 도구 및 기능에 대한 액세스 권한 부여
-
CRM 데이터
-
고객 전환 데이터
-
파일 데이터
-
사용자에게 Breeze Assistant에 대한 액세스 권한 부여
-
권한 필요 에이전트 빌더에서 에이전트를 생성하고 사용자 지정하려면 슈퍼 관리자 또는 Breeze Studio 권한이 필요합니다.
권한 필요 에이전트의 목표에 따라 사용자에게 추가 권한이 필요할 수 있습니다. 예를 들어, 랜딩 페이지를 생성하는 에이전트의 경우 랜딩 페이지를 편집하고 게시하려면 '편집' 및 '게시' 권한이 필요합니다.
에이전트에 웹훅 작업 추가
에이전트 빌더에서 웹훅 액션을 추가하여 외부 시스템으로 데이터를 전송하거나 외부 시스템에서 데이터를 가져올 수 있습니다. ‘메서드(Method)’ 드롭다운 메뉴를 사용하여 에이전트가 웹훅 URL과 통신하는 방식을 선택하십시오:
-
GET: 다른 시스템에서 값을 가져옵니다. 에이전트 실행 후반부에 구독 상태, 주문 상태 또는 고객 프로필 필드와 같이 외부 시스템의 정보를 참조해야 할 때 GET 요청을 사용합니다.
- POST: 다른 시스템으로 값을 전송합니다. 에이전트가 HubSpot 외부에서 주문 처리 요청 생성, 알림 전송 또는 외부 레코드 업데이트와 같은 작업을 트리거하거나 업데이트해야 할 때 POST 요청을 사용합니다.
웹훅 작업을 추가하려면:
-
HubSpot 계정에서 ‘더 보기’를 클릭한 다음, ‘에이전트’ > ‘에이전트 허브’로 이동합니다. 계정에 ‘더 보기’가 표시되지 않는 경우, ‘에이전트’ > ‘에이전트 허브 ’로 직접 이동하십시오.
-
'에이전트' 탭을 클릭합니다.
-
기존 상담원의 카드에서 ‘편집’을 클릭하거나 새 상담원을 생성합니다.
-
에이전트 빌더에서 ‘작업’ 섹션의 ‘작업 추가’를 클릭합니다.
-
오른쪽 패널의 ‘검색’ 필드에 ‘웹훅 보내기’를 입력합니다. 그런 다음 ‘웹훅 보내기’ 액션을 클릭합니다.
-
'메서드' 드롭다운 메뉴를 클릭하고 요청 유형 (예: POST 또는 GET)을 선택합니다.
-
'웹훅 URL' 필드에 요청을 보낼 URL 을 입력합니다.
-
'인증 유형 ' 드롭다운 메뉴를 클릭하고 인증 유형을 선택합니다.
-
선택한 메서드(예: GET 또는 POST)에 따라 요청에 포함할 값을 구성합니다.
-
GET 요청의 경우, ‘쿼리 매개변수’ 섹션에서 ‘정적 값 추가’를 클릭하여 웹훅 URL에 추가할 이름과 값을 추가합니다.
-
POST 요청의 경우, '요청 본문' 섹션에서 '정적 값 추가'를 클릭하여 웹훅 요청 본문에 포함할 값을 추가합니다.
-
-
웹훅 동작을 테스트하려면 ‘테스트’를 클릭합니다. 응답을 검토하여 요청이 올바르게 구성되었는지 확인합니다. 테스트에 실패하면 웹훅 URL, 메서드, 인증 유형, 쿼리 매개변수 또는 요청 본문을 검토한 후 동작을 다시 테스트하십시오.
- 완료되면 ‘저장 및 추가’를 클릭합니다.
- 에이전트 사용자 지정을 계속한 다음 게시하십시오.