통합

Webhooks

HTTP 엔드포인트를 호출하는 맞춤형 도구를 리셉셔니스트에 제공합니다.

Webhook Tool 연동은 리셉셔니스트 또는 비즈니스 어시스턴트가 대화 중 호출할 수 있는 도구로 HTTP 엔드포인트를 제공합니다. AI는 대화 내용을 바탕으로 엔드포인트를 호출할 시점을 결정합니다.

webhook 도구 작동 방식

webhook 도구를 만들 때 다음을 정의합니다.

  1. 호출할 HTTP 엔드포인트
  2. AI가 사용 시점을 알 수 있도록 도구의 기능을 설명하는 내용
  3. AI가 대화에서 수집해야 하는 매개변수

통화 중 대화가 도구의 용도와 일치하면, 리셉셔니스트가 매개변수를 수집하고 엔드포인트를 호출한 다음 응답을 사용해 대화를 이어갑니다.

webhook 도구 만들기

Integrations로 이동하여 Add integration을 선택한 다음 Webhook Tool을 고르세요. 아래 필드를 구성하고 Enable을 선택하세요. 여러 webhook 도구를 추가할 수 있습니다.

필드설명
이름AI에 표시되는 도구 이름(예: check_order_status)
설명이 도구를 언제, 왜 사용하는지
메서드GET, POST, PUT, PATCH 또는 DELETE
URLHTTP 엔드포인트
응답 제한 시간(초)서버 응답 대기 시간: 5~120초, 기본값 20초
에이전트에 할당리셉셔니스트, Assistant agent 또는 둘 다
중단 비활성화도구 실행 중 발신자가 중단하지 못하게 설정
요청 헤더API 키처럼 모든 요청과 함께 전송되는 선택적 헤더
본문 매개변수요청 본문으로 전송되는 매개변수
쿼리 매개변수URL 쿼리 문자열로 전송되는 매개변수

매개변수

각 매개변수에는 다음이 포함됩니다.

  • 키: 필드 이름
  • 유형: string, number 또는 boolean
  • 설명: AI가 대화에서 추출해야 하는 값
  • 필수: 호출 전에 AI가 반드시 수집해야 하는지 여부

사용 사례

시나리오설명메서드
CRM 조회시스템에서 고객 정보 조회GET
재고 확인제품 재고를 실시간으로 확인GET
리드 수집발신자 정보를 마케팅 시스템으로 전송POST
티켓 생성통화 중 지원 티켓 생성POST
가격 견적발신자 요구사항을 바탕으로 맞춤형 견적 계산POST

예시

배관 업체에서 webhook 도구를 만듭니다.

  • 이름: check_service_area
  • 설명: “발신자의 우편번호 지역에 서비스를 제공하는지, 다음 예약 가능한 시간이 언제인지 확인합니다.”
  • URL: https://api.mybusiness.com/check-area
  • 메서드: POST
  • 요청 헤더: Authorization을 업체의 API 키로 설정
  • 본문 매개변수: zip_code(string, 필수), service_type(string, 필수)

발신자가 해당 지역의 서비스에 관해 문의하면 리셉셔니스트가 우편번호를 수집하고 webhook을 호출한 뒤 결과를 알려줍니다.

모든 요금제에서 webhook 도구를 사용할 수 있습니다.