Partager via


Supprimer l’appel

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

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 /app/calls/{id}
DELETE /communications/calls/{id}

Remarque : le chemin d’accès /app est obsolète. À l’avenir, utilisez le chemin d’accès /communications.

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.

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

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-inscrits 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.