통화에 서드 파티 추가하기

이 문서에서는 apps API의 /calls/CALL_ID/dial 엔드포인트를 사용하여 서드 파티에 전화를 걸고 진행 중인 통화에 추가하는 방법을 설명합니다. 이 엔드포인트에 요청하면 시스템이 서드 파티의 전화번호로 자동으로 전화를 걸고 상담사의 통화 어댑터에 통화 중 화면이 표시됩니다. 이러한 방식으로 통화에 서드 파티를 추가하면 통화 어댑터가 에이전트 데스크톱, CRM 또는 CCAI Platform 포털에서 실행되는지 여부에 관계없이 작동합니다. 이 엔드포인트가 작동하려면 상담사가 활성 통화 중이어야 합니다.

엔드포인트 호출

통화에 서드 파티를 추가하려면 다음 엔드포인트에 POST 요청을 실행합니다.

https://YOUR_CCAAS_HOST/apps/api/v1/calls/CALL_ID/dial

CALL_ID를 통화 ID로 바꿉니다.

요청 본문

다음은 요청 본문의 예시입니다.

{
  "agent_email": "AGENT_EMAIL",
  "phone_number": "PHONE_NUMBER"
}

다음을 바꿉니다.

• AGENT_EMAIL: 통화 중인 상담사의 이메일 주소입니다.
• PHONE_NUMBER: 통화에 추가할 서드 파티의 전화번호입니다.

응답

출력은 다음과 비슷합니다.

성공 응답

{
    "message": "Third party dialing initiated",
    "participant": {
        "id": 54321,
        "type": "third_party",
        "status": "connecting"
    }
}

오류 응답

• 400 Bad Request - phone_number 또는 agent_email가 누락되었거나 비어 있습니다. 본문: {"message": "param is missing or the value is empty: <name>"}.
• 400 Bad Request - agent_email이(가) 알려진 사용자와 일치하지 않습니다. 본문: {"message": "Invalid agent_email"}.
• 401 Unauthorized - 인증에 실패했습니다. 본문: {"message": "Not Authorized"}.
• 404 Not Found - 제공된 call_id에 해당하는 통화가 없습니다. 본문: {"message": "Not Found"}.
• 422 Unprocessable Entity - agent_email로 식별된 상담사가 통화에 연결되지 않았습니다. 본문: {"message": "Agent is not connected to the call"}.
• 422 Unprocessable Entity - 다이얼을 시작할 수 없습니다. 전화번호 정규화 실패 및 제공업체 다이얼 시작 오류를 포함합니다. 본문: {"message": "Error dialing third party"}.
• 500 Internal Server Error - 전화 거는 중에 예기치 않은 오류가 발생했습니다. 본문: {"message": "Unexpected error dialing third party"}.