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

에이전트에서 웹훅 사용

마지막 업데이트 날짜: 2026년 7월 23일

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

에이전트에서 웹훅 액션을 사용하여 외부 시스템과 데이터를 주고받을 수 있습니다. 에이전트 빌더에서 웹훅 액션을 구성하여 HTTP 요청(예: GET 또는 POST)을 보내거나, 외부 프로세스를 트리거하거나, 데이터를 가져올 수 있습니다.

웹훅 액션을 사용하면 별도의 맞춤 통합 없이도 에이전트를 외부 도구와 연결할 수 있습니다. 예를 들어, 거래 데이터를 외부 시스템으로 전송하여 주문 처리 절차를 시작하거나, 다른 플랫폼에서 고객 정보를 가져와 에이전트의 출력 결과에 활용할 수 있습니다.

참고: AI 설정에서 AI 기능 액세스를 관리할 수 있으며, 어떤 데이터를 공유할지 구성할 수 있습니다. AI 보안 제어, 데이터 사용 및 규정 준수에 대한 자세한 내용은 HubSpot의 AI 신뢰 FAQAI 모델 카드를 검토하세요.

시작하기 전에

에이전트에서 웹훅을 사용하기 전에 요구 사항과 고려 사항을 검토하십시오.

  • 슈퍼 관리자가 AI 설정에서 다음 스위치를 켜야 합니다:

    • 사용자에게 생성형 AI 도구 및 기능에 대한 액세스 권한 부여

    • CRM 데이터

    • 고객 전환 데이터

    • 파일 데이터

    • 사용자에게 Breeze Assistant에 대한 액세스 권한 부여

권한 필요 에이전트 빌더에서 에이전트를 생성하고 사용자 지정하려면 슈퍼 관리자 또는 Breeze Studio 권한이 필요합니다.

권한 필요 에이전트의 목표에 따라 사용자에게 추가 권한이 필요할 수 있습니다. 예를 들어, 랜딩 페이지를 생성하는 에이전트의 경우 랜딩 페이지를 편집하고 게시하려면 '편집' 및 '게시' 권한이 필요합니다.

에이전트에 웹훅 작업 추가

에이전트 빌더에서 웹훅 액션을 추가하여 외부 시스템으로 데이터를 전송하거나 외부 시스템에서 데이터를 가져올 수 있습니다. ‘메서드(Method)’ 드롭다운 메뉴를 사용하여 에이전트가 웹훅 URL과 통신하는 방식을 선택하십시오:

  • GET: 다른 시스템에서 값을 가져옵니다. 에이전트 실행 후반부에 구독 상태, 주문 상태 또는 고객 프로필 필드와 같이 외부 시스템의 정보를 참조해야 할 때 GET 요청을 사용합니다.

  • POST: 다른 시스템으로 값을 전송합니다. 에이전트가 HubSpot 외부에서 주문 처리 요청 생성, 알림 전송 또는 외부 레코드 업데이트와 같은 작업을 트리거하거나 업데이트해야 할 때 POST 요청을 사용합니다.

웹훅 작업을 추가하려면:

  1. HubSpot 계정에서 ‘더 보기’를 클릭한 다음, ‘에이전트’ > ‘에이전트 허브’로 이동합니다. 계정에 ‘더 보기’가 표시되지 않는 경우, ‘에이전트’ > ‘에이전트 허브 ’로 직접 이동하십시오.

  2. '에이전트' 탭을 클릭합니다.

  3. 기존 상담원의 카드에서 ‘편집’을 클릭하거나 새 상담원을 생성합니다.

  4. 에이전트 빌더에서 ‘작업’ 섹션의 ‘작업 추가’를 클릭합니다.

  5. 오른쪽 패널의 ‘검색’ 필드에 ‘웹훅 보내기’를 입력합니다. 그런 다음 ‘웹훅 보내기’ 액션을 클릭합니다.

  6. '메서드' 드롭다운 메뉴를 클릭하고 요청 유형 (예: POST 또는 GET)을 선택합니다.

  7. '웹훅 URL' 필드에 요청을 보낼 URL 을 입력합니다.

  8. '인증 유형 ' 드롭다운 메뉴를 클릭하고 인증 유형을 선택합니다.

  9. 선택한 메서드(예: GET 또는 POST)에 따라 요청에 포함할 값을 구성합니다.

    • GET 요청의 경우, ‘쿼리 매개변수’ 섹션에서 ‘정적 값 추가’를 클릭하여 웹훅 URL에 추가할 이름과 값을 추가합니다.

    • POST 요청의 경우, '요청 본문' 섹션에서 '정적 값 추가'를 클릭하여 웹훅 요청 본문에 포함할 값을 추가합니다.

  10. 웹훅 동작을 테스트하려면 ‘테스트’를 클릭합니다. 응답을 검토하여 요청이 올바르게 구성되었는지 확인합니다. 테스트에 실패하면 웹훅 URL, 메서드, 인증 유형, 쿼리 매개변수 또는 요청 본문을 검토한 후 동작을 다시 테스트하십시오.

  11. 완료되면 ‘저장 및 추가’를 클릭합니다.
  12. 에이전트 사용자 지정을 계속한 다음 게시하십시오.

다음 단계

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