Eliminar llamada

Espacio de nombres: microsoft.graph

Elimine o cuelgue una llamada activa. En el caso de las llamadas de grupo, esto solo eliminará el tramo de llamada y la llamada de grupo subyacente continuará.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global	Gobierno de EE. UU. L4	Us Government L5 (DOD)	China operada por 21Vianet
✅	✅	✅	❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso	Permisos con privilegios mínimos	Permisos con privilegios más altos
Delegado (cuenta profesional o educativa)	No admitida.	No admitida.
Delegado (cuenta personal de Microsoft)	No admitida.	No admitida.
Aplicación	Calls.Initiate.All	Calls.AccessMedia.All

Nota: Los permisos se comprueban cuando se crea la llamada; no se realiza ninguna comprobación de permisos adicional al llamar a esta API. Calls.AccessMedia.All solo es necesario para las llamadas que usan medios hospedados por la aplicación.

Solicitud HTTP

DELETE /communications/calls/{id}

Encabezados de solicitud

Nombre	Descripción
Authorization	{token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Respuesta

Si se ejecuta correctamente, este método devuelve el código de respuesta 204 No Content. No devuelve nada en el cuerpo de la respuesta.

Ejemplo

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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();

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

CLI

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

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

Ir

// 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)

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del 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();

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

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

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

PHP

<?php
use Microsoft\Graph\GraphServiceClient;


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


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

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

PowerShell

Import-Module Microsoft.Graph.CloudCommunications

Remove-MgCommunicationCall -CallId $callId

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del 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()

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

Respuesta

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

HTTP/1.1 204 No Content

Notificación: terminación

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"
      }
    }
  ]
}
  

Notificación: finalizada

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."
        }
      }
    }
  ]
}

Códigos de motivo de fin de llamada

Estos son algunos de los códigos de error comunes recibidos a través de una notificación cuando finaliza la llamada.

Código	Sub-código	Motivo de terminación
200	4097	La llamada finalizó por el otro participante en la llamada.
200	4521	Llamada finalizada por el otro participante en la llamada punto a punto.
200	5000	Otro participante ha quitado de la conversación.
200	5001	La conversación ha terminado.
200	5002	La conversación ha finalizado, ya que todos los demás participantes han dejado la llamada.
200	5003	La conversación ha terminado.
200	5007	La conversación ha finalizado cuando el iniciador de la llamada de grupo dejó la conversación.
200	5010	La conversación ha finalizado, ya que solo un participante permaneció en la conversación.
200	5012	La conversación ha finalizado, ya que no hay participantes en la lista entrante.
200	5013	La conversación ha finalizado, ya que nadie más se ha unido a la llamada de grupo.
200	5014	La conversación ha finalizado porque no hemos podido determinar un posible host para la llamada de grupo.
200	5020	La conversación ha finalizado, ya que no hay participantes no ocultos en la lista entrante.
200	5030	La conversación ha finalizado a medida que ha transcurrido la duración de la sala de interrupción.
200	5300	Otro participante quitó al participante de la conversación.
200	5855	El participante que esperaba en la sala de espera se quitó de la conversación después del tiempo de espera de inactividad del lobby.
200	7000	La conversación ha finalizado por bot.
200	7015	La llamada finalizó cuando la transferencia se completó correctamente.
200	10550	La conversación ha finalizado por bot.
200	18503	El otro participante en la llamada punto a punto dejó la conversación.
200	540000/560000	Llamada finalizada por el usuario RTC.
408	8537	Tiempo de espera de mantenimiento activo, limpieza de llamada inactiva.
408	1106	No se recibió una confirmación para la aceptación de llamadas en el tiempo asignado.
408	10057	Se agotó el tiempo de espera de la llamada debido a que no se ha señalizado desde los puntos de conexión de destinatario.
410	301005	Error de conectividad multimedia.
480	10037	No se encontraron puntos de conexión de destinatario.
480	10076	No se pudo acceder al destinatario.
480	10134	Llamada rechazada debido a la incapacidad de enrutar la llamada.
480	10199	Llamada rechazada, ya que la llamada privada está deshabilitada para el usuario.
500	1005	El servidor encontró un error de conectividad con los medios del bot. Compruebe la conectividad multimedia entre Bot y Microsoft.