Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
O recurso de chamada é criado quando há uma chamada de entrada para o aplicativo ou o aplicativo cria uma nova chamada de saída por meio de um POST .communications/calls
As chamadas podem ser configuradas como uma chamada ponto a ponto ou de grupo. Para criar ou ingressar em uma chamada de grupo, forneça o chatInfo e meetingInfo. Se esses valores não forem fornecidos, uma nova chamada de grupo será criada automaticamente. Para uma chamada de entrada, registre esses valores em um armazenamento altamente disponível para que seu aplicativo possa reingressar na chamada se o aplicativo falhar.
Embora a mesma identidade não possa ser convidada várias vezes, é possível que um aplicativo ingresse na mesma reunião várias vezes. Sempre que o aplicativo quiser ingressar em uma chamada, uma identidade separada deve ser fornecida para que os clientes possam exibi-las como participantes diferentes.
Observação: você poderá obter a URL de ingresso em uma reunião agendada com o Microsoft Teams. Extraia os dados da URL conforme mostrado para preencher
chatInfoemeetingInfo.
https://teams.microsoft.com/l/meetup-join/19%3ameeting_NTg0NmQ3NTctZDVkZC00YzRhLThmNmEtOGQ3M2E0ODdmZDZk%40thread.v2/0?context=%7b%22Tid%22%3a%2272f988bf-86f1-41af-91ab-2d7cd011db47%22%2c%22Oid%22%3a%224b444206-207c-42f8-92a6-e332b41c88a2%22%7d
Se tornará:
https://teams.microsoft.com/l/meetup-join/19:meeting_NTg0NmQ3NTctZDVkZC00YzRhLThmNmEtOGQ3M2E0ODdmZDZk@thread.v2/0?context={"Tid":"72f988bf-86f1-41af-91ab-2d7cd011db47","Oid":"4b444206-207c-42f8-92a6-e332b41c88a2"}
Observação
Os seguintes problemas conhecidos estão associados a este recurso:
- Exceção de processamento de mensagens Webhook: System.Security.Cryptography.CryptographicException
- O suporte para caso de uso de vários pontos de extremidade no modo de notificação de lista de participação delta está ausente
- Número de participante registrado inconsistente mostrado no cliente do Teams quando o agrupamento de bots está habilitado
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| Criar | chamada | Criar chamada permite que seu bot crie uma nova chamada de saída ponto a ponto ou em grupo, ou ingresse em uma reunião existente. |
| Get | call | Leia propriedades do objeto call. |
| Excluir/desligar | Nenhum | Exclua ou desligue uma chamada ativa. |
| Mantenha-se vivo | Nenhum | Certifique-se de que a chamada permanece ativa. |
| Tratamento de chamadas | ||
| Resposta | Nenhum | Atenda às chamadas recebidas. |
| Reject | Nenhum | Rejeite as chamadas recebidas. |
| Redirecionar | Nenhum | Redirecione as chamadas recebidas. |
| Transfer | Nenhum | Transferir uma chamada |
| Chamadas em grupo | ||
| List | participant collection | Obtenha uma coleção do objeto participant. |
| Convidar participantes | commsOperation | Convide participantes para a chamada ativa. |
| Ativar mudo para participante | muteParticipantOperation | Ative o mudo para participante na chamada de grupo. |
| Create | audioRoutingGroup | Crie um novo audioRoutingGroup postando na coleção audioRoutingGroups. |
| Listar grupos de roteamento de áudio | audioRoutingGroup collection | Obtenha uma coleção de objetos audioRoutingGroup. |
| Adicionar exibição de galeria grande | addLargeGalleryViewOperation | Adicione o modo de exibição de galeria grande a uma chamada. |
| Resposta de voz interativa | ||
| Reproduzir prompt | playPromptOperation | Reproduza uma solicitação na chamada. |
| Registrar resposta | recordOperation | Registra uma resposta de áudio curta do chamador. |
| Cancelar processamento de mídia | commsOperation | Cancele o processamento de mídia. |
| Assinar ao sinal | commsOperation | Inscreva-se nos tons DTMF. |
| Enviar tom DTMF | commsOperation | Enviar tons DTMF em uma chamada. |
| Operações de auto-participante | ||
| Ativar mudo do aplicativo | muteParticipantOperation | Ative o mudo para si mesmo na chamada. |
| Ativar mudo do aplicativo | unmuteParticipantOperation | Desative o mudo automaticamente na chamada. |
| Alterar função de compartilhamento de tela | Nenhum | Inicie e interrompa a tela de compartilhamento na chamada. |
| Operações de gravação | ||
| Atualizar o status da gravação | updateRecordingStatusOperation | Atualiza o status da gravação. |
| Operações de registro em log | ||
| Registrar dados de qualidade do dispositivo de teleconferência | teleconferenceDeviceQuality | Registre dados de qualidade do dispositivo de videoconferência. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| callbackUri | String | A URL de retorno de chamada na qual os retornos de chamada são entregues. Deve ser uma URL HTTPS. |
| callChainId | Cadeia de caracteres | Um identificador único para todas as chamadas de participantes em uma conferência ou um identificador exclusivo para chamadas com dois participantes em uma chamada P2P. Esse identificador deve ser copiado de Microsoft.Graph.Call.CallChainId. |
| callOptions | outgoingCallOptions | Contém os recursos opcionais para a chamada. |
| callRoutes | callRoute collection | As informações de roteamento sobre como a chamada foi redirecionada. Apenas leitura. |
| chatInfo | chatInfo | As informações de chat. Informações necessárias para ingressar em uma reunião. |
| direction | callDirection | A direção da chamada. Os valores possíveis são incoming ou outgoing. Somente leitura. |
| id | Cadeia de caracteres | O identificador exclusivo da chamada. Apenas leitura. |
| incomingContext | incomingContext | O contexto associado a uma chamada recebida. |
| mediaConfig | appHostedMediaConfig ou serviceHostedMediaConfig | A configuração de mídia. Obrigatório. |
| mediaState | callMediaState | Somente leitura. O estado da mídia de chamadas. |
| meetingInfo | organizerMeetingInfo, tokenMeetingInfo ou joinMeetingIdMeetingInfo | As informações da reunião. Informações necessárias para cenários de reunião. |
| myParticipantId | String | Somente leitura. |
| requestedModalities | coleção modality | A lista de modalidades solicitadas. Os valores possíveis são: unknown, audio, video, videoBasedScreenSharing, data. |
| resultInfo | resultInfo | As informações de resultado. Por exemplo, o resultado pode conter o motivo do término. Somente leitura. |
| source | participantInfo | O remetente da chamada. |
| state | callState | O estado da chamada. Os valores possíveis são incoming, establishing, ringing, established, hold, transferring, transferAccepted, redirecting, terminating, terminated. Somente leitura. |
| assunto | String | O assunto da conversa. |
| targets | conjunto invitationParticipantInfo | O destinatário da chamada. Informações necessárias para criar chamadas ponto a ponto. |
| toneInfo | toneInfo | Somente leitura. |
| transcrição | callTranscriptionInfo | As informações da transcrição da chamada. Somente leitura. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| contentSharingSessions | coleção contentSharingSession | Somente leitura. Anulável. |
| operations | commsOperation collection | Somente leitura. Anulável. |
| participantes | participant collection | Somente leitura. Anulável. |
Representação JSON
A representação JSON a seguir mostra o tipo de recurso.
{
"callbackUri": "String",
"callChainId": "String",
"callOptions": {"@odata.type": "#microsoft.graph.outgoingCallOptions"},
"chatInfo": {"@odata.type": "#microsoft.graph.chatInfo"},
"contentSharingSessions": [{ "@odata.type": "microsoft.graph.contentSharingSession" }],
"direction": "String",
"id": "String (identifier)",
"mediaConfig": {"@odata.type": "#microsoft.graph.mediaConfig"},
"mediaState": {"@odata.type": "#microsoft.graph.callMediaState"},
"meetingInfo": {"@odata.type": "#microsoft.graph.meetingInfo"},
"myParticipantId": "String",
"requestedModalities": ["String"],
"resultInfo": {"@odata.type": "#microsoft.graph.resultInfo"},
"source": {"@odata.type": "#microsoft.graph.participantInfo"},
"state": "String",
"subject": "String",
"targets": [{"@odata.type": "#microsoft.graph.invitationParticipantInfo"}],
"toneInfo": {"@odata.type": "#microsoft.graph.toneInfo"},
"transcription": {"@odata.type": "#microsoft.graph.callTranscriptionInfo"},
}