탐색으로 건너뛰기

Webhook

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

Webhook Tool 통합을 사용하면 리셉셔니스트나 비즈니스 어시스턴트가 대화 중 호출할 수 있는 도구로 HTTP 엔드포인트를 노출할 수 있습니다. AI는 대화를 기반으로 엔드포인트를 언제 호출할지 결정합니다.

웹훅 도구 작동 방식

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

  1. 호출할 HTTP 엔드포인트
  2. AI가 언제 사용해야 하는지 알 수 있도록 도구가 수행하는 작업에 대한 설명
  3. AI가 대화에서 수집해야 하는 매개변수

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

웹훅 도구 만들기

Integrations으로 이동해 Add integration을 선택한 다음 Webhook Tool을 선택합니다. 아래 필드를 구성하고 Enable을 선택합니다. 웹훅 도구는 여러 개 추가할 수 있습니다.

필드설명
이름AI에 표시되는 도구 이름입니다. 예: check_order_status
설명이 도구를 언제, 왜 사용하는지
메서드GET, POST, PUT, PATCH 또는 DELETE
URLHTTP 엔드포인트
응답 시간 초과(초)서버를 기다리는 시간입니다. 5~120초이며 기본값은 20초입니다.
에이전트에 할당Receptionist, Assistant agent 또는 둘 다
인터럽트 비활성화도구가 실행되는 동안 발신자가 인터럽트하지 못하게 합니다.
요청 헤더모든 요청과 함께 전송되는 선택적 헤더입니다. Type은 Value 또는 Secret입니다. Secret은 암호화되어 저장되며 다시 표시되지 않습니다. ElevenAgents에서 가져온 헤더에는 에이전트 플랫폼에서 설정되었다는 메모와 함께 Environment variable 또는 Variable이 표시될 수 있습니다.
경로 매개변수URL에 /orders/{order_id}와 같이 중괄호로 묶인 자리 표시자가 포함된 경우 표시됩니다. URL을 수정해 추가하거나 제거할 수 있습니다.
본문 매개변수POST, PUT, PATCH에 표시되는 JSON 요청 본문으로 전송되는 매개변수입니다. 객체와 목록을 사용할 수 있습니다.
쿼리 매개변수URL 쿼리 문자열로 전송되는 매개변수입니다. 각각 단일 값입니다.

매개변수

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

  • 키: 필드 이름입니다. 문자, 숫자, 밑줄, 하이픈, @, 단일 점을 사용할 수 있습니다. 대괄호는 허용되지 않으므로 filter[name]과 같은 키를 예상하는 API는 직접 호출할 수 없습니다.
  • 유형: string, number, integer 또는 boolean입니다. 본문 매개변수는 object 또는 array일 수도 있습니다.
  • 값: AI가 입력하는 대화에서 가져오기 또는 모든 요청과 함께 전송되는 고정 값입니다.
  • 설명: AI가 대화에서 추출해야 하는 값입니다.
  • 필수: 호출 전에 AI가 반드시 수집해야 하는지 여부입니다.

수량, ID, 0/1 플래그와 같은 정수에는 integer를 사용하세요. 고정 number는 소수점과 함께 전송되므로 1은 1.0으로 전달되며, 일부 API에서는 이를 거부합니다.

ElevenAgents에서 변수로부터 값을 가져오도록 설정된 매개변수는 읽기 전용으로 표시되며, 에이전트 플랫폼에서 설정되었다는 메모가 함께 표시됩니다. 해당 플랫폼에서 구성된 대로 전송됩니다.

객체와 목록

많은 API는 전화번호 목록이 있는 연락처처럼 관련 필드를 함께 그룹화하기를 기대합니다. 본문 매개변수로 다음을 전송할 수 있습니다.

  • object는 필드를 그룹화합니다. 각 필드를 추가하려면 Add field를 선택하세요. 모든 필드에는 자체 키, 유형, 값이 있습니다.
  • array는 목록입니다. Each item에서 항목의 유형을 선택하세요. 객체 목록을 사용하면 전화번호별 항목처럼 동일한 구조의 여러 항목을 AI가 전송할 수 있습니다.

필드는 최대 5단계까지 중첩할 수 있습니다. 객체나 목록은 항상 대화에서 가져오지만, 객체 내부 필드에는 변경되지 않는 레이블이나 ID처럼 고정 값을 설정할 수 있습니다.

예를 들어 다음 본문 매개변수는 다음과 같습니다.

  • name: 문자열, 대화에서 가져오기
  • phones: 배열, 각 항목은 두 필드가 있는 객체입니다.
    • number: 문자열, 대화에서 가져오기
    • label: 문자열, mobile로 고정
  • source: 하나의 필드가 있는 객체, channel: 문자열, phone으로 고정

다음과 같은 요청 본문을 전송합니다.

{
"name": "Jane Doe",
"phones": [{ "number": "+15551234567", "label": "mobile" }],
"source": { "channel": "phone" }
}

사용 사례

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

예시

배관 업체에서 다음과 같은 웹훅 도구를 만듭니다.

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

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

웹훅 도구는 모든 요금제에서 사용할 수 있습니다.