Menambahkan pihak ketiga ke panggilan

Dokumen ini menjelaskan cara menggunakan endpoint /calls/CALL_ID/dial dari API aplikasi untuk menghubungi pihak ketiga, lalu menambahkannya ke panggilan yang sedang berlangsung. Saat Anda membuat permintaan ke endpoint ini, sistem akan otomatis menghubungi nomor telepon pihak ketiga, dan adaptor panggilan agen akan menampilkan layar Calling. Menambahkan pihak ketiga ke panggilan dengan cara ini akan berfungsi, terlepas dari apakah adaptor panggilan berjalan di desktop agen, di CRM, atau di portal CCAI Platform. Agen harus berada dalam panggilan aktif agar endpoint ini berfungsi.

Memanggil endpoint

Untuk menambahkan pihak ketiga ke panggilan, buat permintaan POST ke endpoint berikut:

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

Ganti CALL_ID dengan ID panggilan.

Isi permintaan

Berikut adalah contoh isi permintaan:

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

Ganti kode berikut:

  • AGENT_EMAIL: Alamat email agen dalam panggilan.
  • PHONE_NUMBER: Nomor telepon pihak ketiga yang akan ditambahkan ke panggilan.

Respons

Outputnya mirip dengan yang berikut ini.

Respons berhasil

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

Respons error

  • 400 Bad Request - phone_number atau agent_email tidak ada atau kosong. Isi: {"message": "param is missing or the value is empty: <name>"}.
  • 400 Bad Request - agent_email tidak cocok dengan pengguna yang diketahui. Isi: {"message": "Invalid agent_email"}.
  • 401 Unauthorized - autentikasi gagal. Isi: {"message": "Not Authorized"}.
  • 404 Not Found - tidak ada panggilan dengan call_id yang diberikan. Isi: {"message": "Not Found"}.
  • 422 Unprocessable Entity - agen yang diidentifikasi oleh agent_email tidak terhubung ke panggilan. Isi: {"message": "Agent is not connected to the call"}.
  • 422 Unprocessable Entity - panggilan tidak dapat dimulai; mencakup kegagalan normalisasi nomor telepon dan error inisialisasi panggilan penyedia. Isi: {"message": "Error dialing third party"}.
  • 500 Internal Server Error - kegagalan tidak terduga selama panggilan. Isi: {"message": "Unexpected error dialing third party"}.