Supprimer l’appel

Espace de noms: microsoft.graph

Supprimer ou raccrocher un appel actif. Pour les appels de groupe, cela supprimera uniquement votre étape d’appel et l’appel de groupe sous-jacent continuera.

Cette API est disponible dans les déploiements de cloud national suivants.

Service global	Gouvernement des États-Unis L4	Us Government L5 (DOD)	Chine gérée par 21Vianet
✅	✅	✅	❌

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation	Autorisations avec privilèges minimum	Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire)	Non prise en charge.	Non prise en charge.
Déléguée (compte Microsoft personnel)	Non prise en charge.	Non prise en charge.
Application	Calls.Initiate.All	Calls.AccessMedia.All

Note: Les autorisations sont vérifiées lors de la création de l’appel ; aucune autorisation supplémentaire case activée n’est effectuée lors de l’appel de cette API. Calls.AccessMedia.All est nécessaire uniquement pour les appels qui utilisent un média hébergé par l’application.

Requête HTTP

DELETE /communications/calls/{id}

En-têtes de demande

Nom	Description
Autorisation	Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.

Corps de la demande

N’indiquez pas le corps de la demande pour cette méthode.

Réponse

Si elle réussit, cette méthode renvoie un code de réponse 204 No Content. Il ne retourne rien dans le corps de la réponse.

Exemple

Demande

L’exemple suivant illustre la demande.

HTTP

DELETE https://graph.microsoft.com/v1.0/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896

C#

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Communications.Calls["{call-id}"].DeleteAsync();

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

CLI

mgc communications calls delete --call-id {call-id}

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Go

// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.Communications().Calls().ByCallId("call-id").Delete(context.Background(), nil)

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Java

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

graphClient.communications().calls().byCallId("{call-id}").delete();

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

await client.api('/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896')
	.delete();

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

PHP

<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$graphServiceClient->communications()->calls()->byCallId('call-id')->delete()->wait();

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

PowerShell

Import-Module Microsoft.Graph.CloudCommunications

Remove-MgCommunicationCall -CallId $callId

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Python

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

await graph_client.communications.calls.by_call_id('call-id').delete()

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Réponse

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 204 No Content

Notification - Fin de la notification

POST https://bot.contoso.com/api/calls
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.commsNotifications",
  "value": [
    {
      "@odata.type": "#microsoft.graph.commsNotification",
      "changeType": "updated",
      "resourceUrl": "/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896",
      "resourceData": {
        "@odata.type": "#microsoft.graph.call",
        "state": "terminating"
      }
    }
  ]
}
  

Notification - terminée

POST https://bot.contoso.com/api/calls
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.commsNotifications",
  "value": [
    {
      "@odata.type": "#microsoft.graph.commsNotification",
      "changeType": "deleted",
      "resourceUrl": "/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896",
      "resourceData": {
        "@odata.type": "#microsoft.graph.call",
        "state": "terminated",
        "resultInfo": {
          "@odata.type": "#microsoft.graph.resultInfo",
          "code": "200",
          "subcode": "5001",
          "message": "The conversation has ended."
        }
      }
    }
  ]
}

Codes de motif de fin d’appel

Il s’agit de quelques-uns des codes d’erreur courants reçus via une notification lorsque l’appel est terminé.

Code	Sous-code	Motif de l’arrêt
200	4097	Appel terminé par l’autre participant à l’appel.
200	4521	Appel terminé par l’autre participant dans l’appel d’égal à égal.
200	5000	Supprimé de la conversation par un autre participant.
200	5001	La conversation est terminée.
200	5002	La conversation s’est terminée, car tous les autres participants ont quitté l’appel.
200	5003	La conversation est terminée.
200	5007	La conversation s’est terminée lorsque l’initiateur de l’appel de groupe a quitté la conversation.
200	5010	La conversation s’est terminée car un seul participant restait dans la conversation.
200	5012	La conversation s’est terminée car il n’y a aucun participant dans la liste entrante.
200	5013	La conversation s’est terminée car personne d’autre n’a rejoint l’appel de groupe.
200	5014	La conversation s’est terminée, car nous n’avons pas pu déterminer un hôte potentiel pour l’appel de groupe.
200	5020	La conversation s’est terminée, car il n’y a pas de participants non masqués dans la liste entrante.
200	5030	La conversation s’est terminée à mesure que la durée de la salle pour petit groupe s’est écoulée.
200	5300	Le participant a été supprimé de la conversation par un autre participant.
200	5855	Le participant qui attendait dans la salle d’attente a été retiré de la conversation après l’expiration du délai d’inactivité de la salle d’attente.
200	7000	La conversation s’est terminée par bot.
200	7015	L’appel s’est terminé car le transfert s’est terminé avec succès.
200	10550	La conversation s’est terminée par bot.
200	18503	L’autre participant à l’appel d’égal à égal a quitté la conversation.
200	540000/560000	Appel terminé par l’utilisateur RTC.
408	8537	Délai d’expiration Keep Alive, appel inactif nettoyé.
408	1106	Aucun accusé de réception n’a été reçu pour l’acceptation de l’appel dans le délai imparti.
408	10057	L’appel a expiré en raison de l’absence de signalisation à partir des points de terminaison appelés.
410	301005	Échec de connectivité du média.
480	10037	Aucun point de terminaison appelé n’a été trouvé.
480	10076	Impossible d’atteindre l’appelé.
480	10134	Appel rejeté en raison de l’impossibilité d’acheminer l’appel.
480	10199	L’appel rejeté en tant qu’appel privé est désactivé pour l’utilisateur.
500	1005	Le serveur a rencontré une erreur de connectivité avec le média du bot. Vérifiez la connectivité multimédia entre Bot et Microsoft.