Eliminar llamada

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Eliminar o colgar una llamada activa. En el caso de las llamadas grupales, esto solo eliminará el tramo de la llamada y la llamada grupal subyacente continuará.

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ❌ ❌ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos 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 adicional de permisos al llamar a esta API. Calls.AccessMedia.All solo es necesario para las llamadas que usan medios hospedados en la aplicación.

Solicitud HTTP

DELETE /app/calls/{id}
DELETE /communications/calls/{id}

Nota: la /app ruta de acceso está en desuso. En el futuro, utilice la ruta de acceso /communications.

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y 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.

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

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 - terminada

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 finalización de llamada

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

Código Subcódigo Motivo de finalización
200 4097 Llamada finalizada por el otro participante de la llamada.
200 4521 Llamada finalizada por el otro participante en la llamada punto a punto.
200 5000 Eliminado de la conversación por otro participante.
200 5001 La conversación ha terminado.
200 5002 La conversación ha finalizado cuando todos los demás participantes han abandonado la llamada.
200 5003 La conversación ha terminado.
200 5007 La conversación ha finalizado cuando el iniciador de la llamada grupal ha abandonado la conversación.
200 5010 La conversación finalizó porque solo un participante permaneció en la conversación.
200 5012 La conversación ha terminado porque no hay participantes en la lista entrante.
200 5013 La conversación ha finalizado porque nadie más se ha unido a la llamada grupal.
200 5014 La conversación ha finalizado porque no hemos podido determinar un posible host para la llamada grupal.
200 5020 La conversación ha finalizado porque no hay participantes no ocultos en la lista entrante.
200 5030 La conversación ha finalizado cuando ha transcurrido la duración de la sala para sesión de subgrupo.
200 5300 Otro participante eliminó al participante de la conversación.
200 5855 El participante que espera en la sala de espera se ha eliminado de la conversación después del tiempo de espera de inactividad de la sala de espera.
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 de la llamada punto a punto ha abandonado la conversación.
200 540000/560000 Llamada finalizada por el usuario de RTC.
408 8537 Tiempo de espera de Keep Alive, llamada inactiva limpia.
408 1106 No se recibió un acuse de recibo por la aceptación de la llamada en el tiempo asignado.
408 10057 Se agotó el tiempo de espera de la llamada debido a que no hay señalización de los puntos de conexión del destinatario.
410 301005 Error de conectividad multimedia.
480 10037 No se encontraron extremos de destinatario.
480 10076 No se ha podido contactar con el destinatario.
480 10134 Llamada rechazada debido a la incapacidad de enrutar la llamada.
480 10199 Llamada rechazada como llamada privada está deshabilitada para el usuario.
500 1005 El servidor encontró un error de conectividad con el medio del bot. Compruebe la conectividad multimedia entre Bot y Microsoft.
  • Last updated on