Call Connection - Transfer To Participant

Riferimento

Servizio:: Communication

Versione API:: 2024-09-15

Trasferire la chiamata a un partecipante.

POST {endpoint}/calling/callConnections/{callConnectionId}:transferToParticipant?api-version=2024-09-15

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
callConnectionId	path	True	string	ID connessione di chiamata.
endpoint	path	True	string url	Endpoint della risorsa di comunicazione di Azure.
api-version	query	True	string	Versione dell'API da richiamare.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
Authorization	True	string	Token di accesso utente di Servizi di comunicazione di Azure.
Repeatability-Request-ID		string uuid	Se specificato, il client indirizza che la richiesta è ripetibile; ovvero, che il client può effettuare la richiesta più volte con la stessa ripetibilità-Request-Id e ottenere una risposta appropriata senza che il server eseeseguono la richiesta più volte. Il valore di Repeatability-Request-Id è una stringa opaca che rappresenta un identificatore univoco generato dal client per la richiesta. Si tratta di un UUID versione 4 (casuale).
Repeatability-First-Sent		string date-time-rfc1123	Se viene specificata l'intestazione Repeatability-Request-ID, è necessario specificare anche l'intestazione Repeatability-First-Sent. Il valore deve essere la data e l'ora in cui la richiesta è stata creata per la prima volta, espressa utilizzando il formato IMF-fixdate di HTTP-date. Esempio: Sun, 06 Novembre 1994 08:49:37 GMT.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
targetParticipant	True	CommunicationIdentifierModel
customCallingContext		CustomCallingContext	Usato dal cliente per inviare il contesto di chiamata personalizzato alle destinazioni
operationCallbackUri		string	Impostare un URI di callback che esegue l'override dell'URI di callback predefinito impostato da CreateCall/AnswerCall per questa operazione. Questa configurazione è per azione. Se non è impostato, verrà usato l'URI di callback predefinito impostato da CreateCall/AnswerCall.
operationContext		string	Usato dai clienti quando si chiamano azioni di chiamata mid-call per correlare la richiesta all'evento di risposta.
sourceCallerIdNumber		PhoneNumberIdentifierModel
transferee		CommunicationIdentifierModel

Risposte

Nome	Tipo	Descrizione
202 Accepted	TransferCallResponse	Il servizio ha accettato la richiesta di trasferimento e inizierà l'elaborazione. Riceverai l'evento CallTransferAccepted o CallTransferFailed all'URI di callback specificato per aggiornarti sullo stato della richiesta.
Other Status Codes	CommunicationErrorResponse	Errore

Sicurezza

Authorization

Token di accesso utente di Servizi di comunicazione di Azure.

Tipo: apiKey
In: header

Esempio

CallConnection_TransferToParticipant

Esempio di richiesta

HTTP

POST https://contoso.communications.azure.com/calling/callConnections/18dea47f-b081-4107-9a5c-4300819d2c6c:transferToParticipant?api-version=2024-09-15

{
  "targetParticipant": {
    "kind": "communicationUser",
    "communicationUser": {
      "id": "8:acs:b9614373-fd0b-480c-8fd2-cb58b70eab9f_da7be3a9-8788-42a6-85c6-56b2cf784fce"
    }
  },
  "transferee": {
    "kind": "communicationUser",
    "communicationUser": {
      "id": "8:acs:b9614373-fd0b-480c-8fd2-cb58b70eab9f_ae9e3307-f56e-44be-8934-80a63f080538"
    }
  },
  "operationCallbackUri": "https://app.contoso.com/callback",
  "operationContext": "trasferring call"
}

Risposta di esempio

Codice di stato:: 202

{
  "operationContext": "trasferring call"
}

Definizioni

Nome	Descrizione
CustomCallingContext	Contesto di chiamata personalizzato che verrà inviato alla destinazione
TransferCallResponse	Payload della risposta per il trasferimento della chiamata.
TransferToParticipantRequest	Payload della richiesta per il trasferimento di una chiamata a un partecipante.

CustomCallingContext

Contesto di chiamata personalizzato che verrà inviato alla destinazione

Nome	Tipo	Descrizione
sipHeaders	object	Intestazioni SIP del contesto di chiamata personalizzate
voipHeaders	object	Intestazioni VoiP del contesto di chiamata personalizzate

TransferCallResponse

Payload della risposta per il trasferimento della chiamata.

Nome	Tipo	Descrizione
operationContext	string	Contesto dell'operazione fornito dal client.

TransferToParticipantRequest

Payload della richiesta per il trasferimento di una chiamata a un partecipante.

Nome	Tipo	Descrizione
customCallingContext	CustomCallingContext	Usato dal cliente per inviare il contesto di chiamata personalizzato alle destinazioni
operationCallbackUri	string	Impostare un URI di callback che esegue l'override dell'URI di callback predefinito impostato da CreateCall/AnswerCall per questa operazione. Questa configurazione è per azione. Se non è impostato, verrà usato l'URI di callback predefinito impostato da CreateCall/AnswerCall.
operationContext	string	Usato dai clienti quando si chiamano azioni di chiamata mid-call per correlare la richiesta all'evento di risposta.
sourceCallerIdNumber	PhoneNumberIdentifierModel
targetParticipant	CommunicationIdentifierModel
transferee	CommunicationIdentifierModel

Condividi tramite