Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

콜백 호출 API

콜백 호출은 최종 사용자가 요청하는 호출입니다. 콜백 호출 API를 사용하면 콜백 호출을 프로그래매틱 방식으로 예약하고 예약된 호출을 취소할 수 있습니다. 이러한 기능을 사용하면 최종 사용자가 지정한 대기열에서 콜백 호출을 요청할 수 있는 애플리케이션을 만들 수 있습니다. 최종 사용자는 이전에 예약한 호출을 취소할 수도 있습니다. 콜백 호출 API를 사용한 인증에 관한 자세한 내용은 기본 인증을 참고하세요.

콜백 호출 API 사용

콜백 호출 API를 사용하여 콜백 호출을 예약하고 예약된 호출을 취소할 수 있습니다.

호출 예약

인스턴스가 Salesforce와 통합된 경우 설정 > 운영 관리 > CRM 레코드 생성 세부정보 에서 API 예약 호출을 시작할 때 닫힌 레코드 옵션 설정을 확인합니다. 예약 요청이 422로 거부됩니다. 레코드 상태를 확인하지 않음이 선택된 동안 이는 Zendesk 또는 ServiceNow에는 적용되지 않습니다.

호출을 예약하려면 POST https://<subdomain>.<domain>/apps/api/v1/calls 를 호출하고 다음과 유사한 요청 본문을 포함합니다.

{
    "call_type": "ScheduledCall",
    "menu_id": 12345,
    "end_user_number": "+18005550100",
    "scheduled_at": "2025-09-02T14:30:00Z"
}

요청이 성공하면 호출 ID를 포함한 호출 객체가 반환됩니다.

예약된 호출 취소

예약된 호출을 취소하려면 PATCH https://<subdomain>.<domain>/apps/api/v1/calls/scheduled/{id}/cancel을 호출합니다. 취소할 호출의 ID를 지정합니다.

요청이 성공하면 취소된 호출에 관한 정보가 반환됩니다.

예약된 호출 여러 개 취소

예약된 호출을 여러 개 취소하려면 PATCH https://<subdomain>.<domain>/apps/api/v1/calls/scheduled/cancel을 호출합니다. 취소할 호출의 호출 ID가 정수로 포함된 call_ids 배열이 포함된 요청 본문을 포함합니다. 배열이 아니거나 정수가 아닌 항목이 포함된 값은 400으로 거부됩니다.

다음 코드 샘플을 참조하세요.

{
    "call_ids": [123, 456, 789]
}

요청이 성공하면 취소 상태를 확인하기 위한 Location URL이 포함된 응답 헤더가 있는 응답이 반환됩니다.

CRM에서 콜백 호출 사용

Salesforce, Zendesk, ServiceNow CRM 통합과 함께 콜백 호출 API를 사용할 수 있습니다.

일반 콜백 동작

지원되는 CRM (Salesforce, Zendesk 또는 ServiceNow)을 사용하는 경우 다음 조건이 예약된 콜백 동작에 영향을 미칩니다.

레코드가 열려 있고 이미 예약된 호출이 활성 상태임: 티켓 ID 조회를 통해 레코드가 열려 있고 이미 예약된 호출이 활성 상태임을 나타내는 경우 호출이 예약되지 않습니다. 다음 댓글이 CRM 레코드에 첨부됩니다. A scheduled call was not created because the record already has an active scheduled call
CRM에 연결할 수 없음: 티켓 ID 조회를 통해 CRM 에 연결할 수 없음을 나타내는 경우 호출이 취소됩니다. 다음 댓글이 CRM 레코드에 첨부됩니다 . A scheduled call was canceled because the CRM was unreachable

닫힌 레코드의 콜백 동작

닫힌 레코드의 콜백 호출 처리 방식은 사용하는 CRM에 따라 다릅니다.

Zendesk 및 ServiceNow 사용자: 티켓 ID 조회를 통해 레코드가 닫혀 있음을 나타내는 경우 호출이 예약되지 않습니다. 다음 댓글이 CRM 레코드에 첨부됩니다. A scheduled call was not created because the record is closed
Salesforce 사용자: Salesforce를 사용한 콜백 호출을 참고하여 인스턴스가 닫힌 레코드의 예약된 호출을 처리하는 방법을 구성하세요.

Salesforce를 사용한 콜백 호출

CCAI 플랫폼을 Salesforce와 통합한 경우 인스턴스가 닫힌 레코드의 예약된 호출을 처리하는 방법을 구성할 수 있습니다. Salesforce 통합의 구성 옵션은 다음과 같습니다.

레코드 상태를 확인하지 않습니다.
레코드 상태를 확인하고 닫힌 레코드를 다시 엽니다.
레코드 상태를 확인하고 닫힌 레코드의 예약된 호출을 취소합니다.

레코드 상태를 확인하지 않음

예약된 호출을 하기 전에 레코드 상태를 확인하지 않도록 CCAI 플랫폼을 구성할 수 있습니다. 이 옵션을 선택하면 콜백 호출 API를 통해 호출을 예약하는 요청이 422로 거부됩니다.

레코드 상태를 확인하지 않도록 CCAI 플랫폼을 구성하려면 다음 단계를 따르세요.

CCAI 플랫폼 포털에서 설정 > 운영 관리 를 클릭합니다. 설정 메뉴가 표시되지 않으면 메뉴를 클릭합니다.
CRM 레코드 생성 세부정보 > API 예약 호출을 시작할 때 닫힌 레코드 옵션으로 이동합니다.
레코드 상태를 확인하지 않음. 항상 API 예약 호출을 시작함 을 선택합니다.
일반 저장 을 클릭합니다.

레코드 상태를 확인하고 닫힌 레코드를 다시 엽니다.

예약된 호출을 하기 전에 레코드 상태를 확인하고 닫힌 레코드를 다시 열도록 CCAI 플랫폼을 구성할 수 있습니다. 이 구성에서 레코드 상태가 닫혀 있으면 다음 작업이 실행됩니다.

호출이 예약된 대로 이루어집니다.
레코드가 다시 열립니다.
다음 댓글이 CRM 레코드에 첨부됩니다. The record was reopened at the time of a scheduled call

레코드 상태를 확인하고 닫힌 레코드를 다시 열도록 CCAI 플랫폼을 구성하려면 다음 단계를 따르세요.

CCAI 플랫폼 포털에서 설정 > 운영 관리 를 클릭합니다. 설정 메뉴가 표시되지 않으면 메뉴를 클릭합니다.
CRM 레코드 생성 세부정보 > API 예약 호출을 시작할 때 닫힌 레코드 옵션으로 이동합니다.
레코드 상태를 확인합니다. 레코드가 닫혀 있음 > 레코드 다시 열기를 선택합니다.
일반 저장 을 클릭합니다.

레코드 상태를 확인하고 닫힌 레코드의 예약된 호출을 취소합니다.

예약된 호출을 하기 전에 레코드 상태를 확인하고 닫힌 레코드의 예약된 호출을 취소하도록 CCAI 플랫폼을 구성할 수 있습니다. 이 구성에서 레코드 상태가 닫혀 있으면 다음 작업이 실행됩니다.

예약된 호출이 취소됩니다.
다음 댓글이 CRM 레코드에 첨부됩니다. A scheduled call was canceled because the record is closed

레코드 상태를 확인하고 닫힌 레코드의 예약된 호출을 취소하도록 CCAI 플랫폼을 구성하려면 다음 단계를 따르세요.

CCAI 플랫폼 포털에서 설정 > 운영 관리 를 클릭합니다. 설정 메뉴가 표시되지 않으면 메뉴를 클릭합니다.
CRM 레코드 생성 세부정보 > API 예약 호출을 시작할 때 닫힌 레코드 옵션으로 이동합니다.
레코드 상태를 확인합니다. 레코드가 닫혀 있음 > 예약된 호출 취소를 선택합니다.
일반 저장 을 클릭합니다.

콜백 호출 API 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.