Bagikan melalui

Redirect Call - Redirect Call

Layanan:
Communication
Versi API:
2026-03-12

Mengalihkan panggilan.

POST {endpoint}/calling/callConnections:redirect?api-version=2026-03-12

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
endpoint
 path True

string (url)

Titik akhir sumber daya Azure Communication Service.
api-version
 query True

string

Versi API yang akan dipanggil.

Header Permintaan

Nama Diperlukan Jenis Deskripsi
Authorization True

string

Token akses pengguna Azure Communication Services.
Repeatability-Request-ID

string (uuid)

Jika ditentukan, klien mengarahkan bahwa permintaan dapat diulang; yaitu, bahwa klien dapat membuat permintaan beberapa kali denganRequest-Id Pengulangan yang sama dan mendapatkan kembali respons yang sesuai tanpa server mengeksekusi permintaan beberapa kali. NilaiRequest-Id Repeatability- adalah string buram yang mewakili pengidentifikasi unik yang dihasilkan klien untuk permintaan. Ini adalah UUID versi 4 (acak).
Repeatability-First-Sent

string (date-time-rfc1123)

Jika header Repeatability-Request-ID ditentukan, maka header Repeatability-First-Sent juga harus ditentukan. Nilainya harus berupa tanggal dan waktu di mana permintaan pertama kali dibuat, dinyatakan menggunakan bentuk IMF-fixdate dari HTTP-date. Contoh: Sun, 06 Nov 1994 08:49:37 GMT.

Isi Permintaan

Nama Diperlukan Jenis Deskripsi
incomingCallContext True

string

Konteks yang terkait dengan panggilan.
target True

CommunicationIdentifierModel

Respons

Nama Jenis Deskripsi
204 No Content

Layanan telah mengalihkan panggilan ke titik akhir yang ditentukan.
Other Status Codes

CommunicationErrorResponse

Kesalahan

Keamanan

Authorization

Token akses pengguna Azure Communication Services.

Jenis: apiKey
Dalam: header

Contoh

RedirectCall

Permintaan sampel

POST https://contoso.communications.azure.com/calling/callConnections:redirect?api-version=2026-03-12

{
  "target": {
    "kind": "communicationUser",
    "communicationUser": {
      "id": "8:acs:b9614373-fd0b-480c-8fd2-cb58b70eab9f_0f50d091-5bd3-448b-884d-44be7037d9b9"
    }
  },
  "incomingCallContext": "H4sIAAAAAAAEAMVVS2/bOBD+LzrspaElPiSSBoJFNnvYoNi0aHaBtpcFRQ5t1rIokLRTJ8h/X1J2soHRQ4A9lAdZ4ry+mflm/FhpNQy3PjnrtErOj9XysbLBb8uvM9WyEkul49J2ioEiGhlKADHVKiR7oVDXUGo5tkpa8k8zH9yglhuKuLQNkqLpEMZUNSZLNFfVRWVcnAZ1uFVbyP53EQLOtzCaybsx3ZSgnZFKKk4QgLGIybZFfU8oolIZzFrWGk6yzaDG1U6tYLaBMd9MKiSn3aROjjSRoAUHhG1PEDMdIGFlg4yRUmhChWQsm62dMdl+adUQ4aIKEP0u6KPft6RePV1Uyf/PmmmT5VijnlmMpD7VDLg4r9m4G4azgjWng37weD5nBTt6OS8YlcRyBhpJwD1iggFSbccQJVRJANW1gp4XLCc/uHETS/4qJaXX2dE6pSku61pNbgETMrBfxM1hgsUIqVzWe1Lrqda6iBBpmsXx9ZWW1vUe19aHDZja9pqBMRyBpQyxriVIgNBIGa11D9wy2tWE1Q7np6iPOH51lyXtLRinrsZ4D6FwQmdY28LEKfhV7nX8+XCfkZwAB/gGOv18WEccJ1A7M/0V1BgnHwq0/JmBYSoWEi84XTC+pIyLuszCXPBrPyYY0zPTsv57OBSOxJxoXjXzV3WzJs1D/+X22gy/36m762/vhk8PV5eXOWAm5gZKqDZ5/PCdc2L/vvmjbynGh3fhPus8lVIZFzLI7PBj8BNkOsPMRBc/nURXw+DvIbM7hR3MJnmWdNE6Itt7p2Gr3HAHKblxVcyfsp724x5CnPfizbh36WVDvpaUNIMfhplbb+1Xtp87hhfPr687lq/qB4HD9ec1vN98+OzhQ9Rfp26zKq34BS47ygVtBZdNS3AjMCnb0MU/d0NyH/NEH15WmYu/BZ+7q2L6b1oN9LvVS3se5z+B4w6lWIOSHOl5+rmiSJoOI9b0jZZATMPUD7bsm5ZGjrsKfjfNcb+faPH0LyoNW7KCBgAA"
}

Respon sampel

Kode status:
204

Definisi

RedirectCallRequest

Objek

Payload permintaan untuk mengalihkan panggilan.

Nama Jenis Deskripsi
incomingCallContext

string

Konteks yang terkait dengan panggilan.
target

CommunicationIdentifierModel