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

콜백 호출 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를 지정합니다.

요청에 성공하면 업데이트된 통화 객체와 함께 200 OK가 반환됩니다. 통화 객체의 status는 통화가 예약된 시간을 기다리거나 대기열에 들어가거나 대기 중일 때 cancelled이고, 이미 첫 번째 다이얼 시도를 한 활성 가상 에이전트 콜백을 취소할 때 completed입니다. 통화가 이미 취소된 경우 요청은 빈 본문과 함께 204 No Content를 반환합니다. 취소 이외의 이유로 이미 실패했거나 취소할 수 없는 상태인 호출 요청은 400를 반환합니다.

예약된 통화 여러 개 취소하기

예약된 호출을 여러 개 취소하려면 PATCH https://<subdomain>.<domain>/apps/api/v1/calls/scheduled/cancel를 호출합니다. 취소할 호출의 호출 ID가 포함된 call_ids 배열이 포함된 요청 본문을 포함합니다.

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

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

요청에 성공하면 완료를 위해 폴링할 수 있는 작업 리소스를 가리키는 Location 응답 헤더와 함께 202 Accepted가 반환됩니다. 202 Accepted 응답은 아직 모든 호출이 취소되었음을 의미하지 않습니다. Location 헤더를 따라 완료를 확인하고 부분 실패를 검사합니다.

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 예약 통화를 시작할 때 종료된 레코드 옵션으로 이동합니다.
Don't check the record status. 항상 API 예약 통화를 시작합니다.
일반 저장을 클릭하세요.

기록 상태 확인 및 종료된 기록 다시 열기

예약된 통화를 걸기 전에 레코드 상태를 확인하고 종료된 레코드를 다시 열도록 CCAI Platform을 구성할 수 있습니다. 이 구성에서 레코드 상태가 종료되면 다음 작업이 수행됩니다.

예정된 시간에 통화가 진행됩니다.
레코드가 다시 열립니다.
CRM 레코드에 The record was reopened at the time of a scheduled call 댓글이 첨부되어 있습니다.

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

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

기록 상태를 확인하고 종료된 기록의 예약된 통화를 취소합니다.

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

예약된 통화가 취소됩니다.
CRM 레코드에 A scheduled call was canceled because the record is closed 댓글이 첨부되어 있습니다.

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

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