콜백 호출 API

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

콜백 호출 API 사용

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

전화 상담 예약

통화를 예약하려면 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 배열이 포함된 요청 본문을 포함합니다.

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

{
    "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 Platform을 Salesforce와 통합한 경우 인스턴스에서 종료된 레코드의 예약된 통화를 처리하는 방식을 구성할 수 있습니다. Salesforce 통합의 구성 옵션은 다음과 같습니다.

레코드 상태를 확인하지 않습니다.
레코드 상태를 확인하고 닫힌 레코드를 다시 엽니다.
기록 상태를 확인하고 종료된 기록의 예약된 통화를 취소합니다.

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

예약된 전화를 걸기 전에 녹음 상태를 확인하지 않도록 CCAI Platform을 구성할 수 있습니다. 이 구성에서는 레코드가 열려 있는지 닫혀 있는지와 관계없이 예약된 대로 통화가 걸립니다.

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

CCAI Platform 포털에서 설정 > 운영 관리를 클릭합니다. 설정 메뉴가 표시되지 않으면 메뉴를 클릭합니다.
CRM 레코드 생성 세부정보 > API 예약 통화 시작 시 종료된 레코드 옵션으로 이동합니다.
레코드 상태를 확인하지 않습니다. 항상 API 예약 호출을 시작해야 합니다.
일반 저장을 클릭합니다.

레코드 상태 확인 및 종료된 레코드 다시 열기

예약된 전화를 걸기 전에 기록 상태를 확인하고 닫힌 기록을 다시 열도록 CCAI 플랫폼을 구성할 수 있습니다. 이 구성에서는 레코드 상태가 종료된 경우 다음 작업이 실행됩니다.

통화가 예약된 대로 진행됩니다.
레코드가 다시 열립니다.
다음 댓글이 CRM 기록에 첨부됩니다. The record was reopened at the time of a scheduled call

레코드 상태를 확인하고 종료된 레코드를 다시 열도록 CCAI Platform을 구성하려면 다음 단계를 따르세요.

CCAI Platform 포털에서 설정 > 운영 관리를 클릭합니다. 설정 메뉴가 표시되지 않으면 메뉴를 클릭합니다.
CRM 레코드 생성 세부정보 > API 예약 통화 시작 시 종료된 레코드 옵션으로 이동합니다.
레코드 상태를 확인합니다. 레코드가 닫혀 있으면 > 레코드를 다시 엽니다.
일반 저장을 클릭합니다.

레코드 상태 확인 및 종료된 레코드의 예약된 통화 취소

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

예약된 통화가 취소됩니다.
다음 댓글이 CRM 기록에 첨부됩니다. A scheduled call was canceled because the record is closed

레코드 상태를 확인하고 종료된 레코드의 예약된 통화를 취소하도록 CCAI Platform을 구성하려면 다음 단계를 따르세요.

CCAI Platform 포털에서 설정 > 운영 관리를 클릭합니다. 설정 메뉴가 표시되지 않으면 메뉴를 클릭합니다.
CRM 레코드 생성 세부정보 > API 예약 통화 시작 시 종료된 레코드 옵션으로 이동합니다.
레코드 상태를 확인합니다. 레코드가 닫혀 있으면 > 예약된 통화를 취소해.
일반 저장을 클릭합니다.

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