Comentários Editar

Excluir chamada

  • Artigo
  • 5 minutos para o fim da leitura

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor de versão.

Excluir ou desligar uma chamada ativa. Para chamadas de grupo, isso excluirá apenas sua etapa de chamada e a chamada de grupo subjacente continuará.

Permissões

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante) Sem suporte.
Delegada (conta pessoal da Microsoft) Sem suporte.
Aplicativo Calls.Initiate.All, Calls.AccessMedia.All

Observação: As permissões são verificadas quando a chamada é criada; nenhuma verificação de permissão adicional é feita ao chamar essa API. Calls.AccessMedia.All só é necessário para chamadas que usam mídia hospedada pelo aplicativo.

Solicitação HTTP

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

Observação: o caminho /app foi preterido. Daqui em diante, use o caminho /communications.

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório.

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se bem-sucedido, este método retorna um código de resposta 204 No Content. Não retorna nada no corpo da resposta.

Exemplo

Solicitação

O exemplo a seguir mostra a solicitação.

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

Resposta

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 204 No Content

Notificação - término

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

Notificação - encerrada

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 término da chamada

Esses são alguns dos códigos de erro comuns recebidos por meio de notificação quando a chamada é encerrada.

Código Subcódigo Motivo da terminação
200 4097 Chamada encerrada pelo outro participante na chamada.
200 4521 Chamada encerrada pelo outro participante em chamada ponto a ponto.
200 5000 Removido da conversa por outro participante.
200 5001 A conversa terminou.
200 5002 A conversa terminou como todos os outros participantes deixaram a chamada.
200 5003 A conversa terminou.
200 5007 A conversa terminou como o iniciador da chamada de grupo que saiu da conversa.
200 5010 A conversa terminou como apenas um participante permaneceu na conversa.
200 5012 A conversa terminou porque não há participantes na lista de entrada.
200 5013 A conversa terminou como ninguém mais ingressou na chamada de grupo.
200 5014 A conversa terminou porque não foi possível determinar um host em potencial para a chamada de grupo.
200 5020 A conversa terminou porque não há participantes não ocultos na lista de entrada.
200 5030 A conversa terminou à medida que a duração da sala de saída decorrido.
200 5300 O participante foi removido da conversa por outro participante.
200 5855 O participante que aguardava no lobby foi removido da conversa após o tempo de inatividade do lobby.
200 7000 A conversa terminou por bot.
200 7015 A chamada terminou como a transferência concluída com êxito.
200 10550 A conversa terminou por bot.
200 18503 O outro participante da chamada ponto a ponto deixou a conversa.
200 540000/560000 Chamada encerrada pelo usuário PSTN.
408 8537 Mantenha o tempo de vida, limpe a chamada inativa.
408 1106 Não foi recebido um reconhecimento para a aceitação da chamada no tempo alocado.
408 10057 Tempo de chamada em tempo hábil devido a nenhuma sinalização dos pontos de extremidade do chamador.
410 301005 Falha na conectividade de mídia.
480 10037 Nenhum ponto de extremidade do chamador foi encontrado.
480 10076 Não foi possível alcançar o chamador.
480 10134 Chamada rejeitada devido à incapacidade de rotear a chamada.
480 10199 A chamada rejeitada como chamada privada está desabilitada para o usuário.
500 1005 O servidor encontrou um erro de conectividade com a mídia do Bot. Verifique a conectividade de mídia entre Bot e Microsoft.