<!– –>
Transférer l’appel à un participant.
POST {endpoint}/calling/callConnections/{callConnectionId}:transferToParticipant?api-version=2022-04-07-previewParamètres URI
| Nom | Dans | Obligatoire | Taper | La description |
|---|---|---|---|---|
appelLienIdentifiant | chemin | Vrai | L’ID de connexion d’appel. | |
point final | chemin | Vrai | URL | Point de terminaison de la ressource Azure Communication. |
version API | requête | Vrai | Version de l’API à invoquer. |
En-tête de demande
| Nom | Obligatoire | Taper | La description |
|---|---|---|---|
Répétabilité-Demande-ID | uuid | Si spécifié, le client indique que la demande est répétable ; c’est-à-dire que le client peut faire la demande plusieurs fois avec le même Repeatability-Request-Id et obtenir une réponse appropriée sans que le serveur n’exécute la demande plusieurs fois. La valeur de Repeatability-Request-Id est une chaîne opaque représentant un identifiant unique généré par le client pour la demande. Il s’agit d’un UUID version 4 (aléatoire). | |
Répétabilité-Premier-Envoyé | Si l’en-tête Repeatability-Request-ID est spécifié, l’en-tête Repeatability-First-Sent doit également être spécifié. La valeur doit être la date et l’heure auxquelles la demande a été créée pour la première fois, exprimées à l’aide de la forme IMF-fixdate de HTTP-date. Exemple : Dim 06 novembre 1994 08:49:37 GMT. |
Corps de la requête
| Nom | Obligatoire | Taper | La description |
|---|---|---|---|
cibleParticipant | Vrai | L’identité de la cible vers laquelle l’appel doit être transféré. | |
operationContext | Utilisé par les clients lors de l’appel d’actions en cours d’appel pour corréler la demande à l’événement de réponse. | ||
transfereeCallerId | L’ID de l’appelant du cessionnaire lors du transfert vers le RTPC. | ||
userToUserInformation | L’information d’utilisateur à utilisateur. |
Réponses
Exemples
Transférer l’appel à un participant.
Demande d’échantillon
POST https://contoso.communications.azure.com/calling/callConnections/18dea47f-b081-4107-9a5c-4300819d2c6c:transferToParticipant?api-version=2022-04-07-preview
{
"targetParticipant": {
"kind": "communicationUser",
"communicationUser": {
"id": "8:acs:b9614373-fd0b-480c-8fd2-cb58b70eab9f_da7be3a9-8788-42a6-85c6-56b2cf784fce"
}
},
"transfereeCallerId": {
"value": "+11234567890"
},
"userToUserInformation": "user to user",
"operationContext": "trasferring call"
}
Exemple de réponse
{
"operationContext": "trasferring call"
}Définitions
CommunicationCloudEnvironnementModèle
| Nom | Taper | La description |
|---|---|---|
dod | ||
gcch | ||
Publique |
Erreur de communication
CommunicationErrorResponse
La réponse d’erreur des services de communication
CommunicationIdentifierModelCommunicationIdentifierModel
CommunicationIdentifierModelKindCommunicationIdentifierModelKind
Type de CommunicationIdentifierModel.
| Nom | Taper | La description |
|---|---|---|
communicationUtilisateur | ||
MicrosoftTeamsUser | ||
numéro de téléphone | ||
inconnue |
CommunicationUserIdentifierModelCommunicationUserIdentifierModel
| Nom | Taper | La description |
|---|---|---|
identifiant |
MicrosoftTeamsUserIdentifierModelMicrosoftTeamsUserIdentifierModel
PhoneNumberIdentifierModel
| Nom | Taper | La description |
|---|---|---|
évaluer |
TransfertAppelRéponse
La charge utile de réponse pour le transfert de l’appel.
| Nom | Taper | La description |
|---|---|---|
operationContext | Le contexte d’opération fourni par le client. |
TransferToParticipantRequestTransferToParticipantRequest
La charge utile de la demande de transfert d’appel vers un participant.
| Nom | Taper | La description |
|---|---|---|
operationContext | Utilisé par les clients lors de l’appel d’actions en cours d’appel pour corréler la demande à l’événement de réponse. | |
cibleParticipant | L’identité de la cible vers laquelle l’appel doit être transféré. | |
transfereeCallerId | L’ID de l’appelant du cessionnaire lors du transfert vers le RTPC. | |
userToUserInformation | L’information d’utilisateur à utilisateur. |
