Tipo de recurso de chamada

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.

O recurso call é criado quando há uma chamada recebida para o aplicativo ou quando o aplicativo cria uma nova chamada realizada por meio de um POST em app/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 chatInfo e meetingInfo. Caso não sejam fornecidos, uma nova chamada de grupo é criada automaticamente. Para uma chamada recebida, grave esses valores em um armazenamento altamente disponível para que o aplicativo reingresse na chamada caso enfrente uma falha.

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, uma identidade separada deve ser fornecida para que os clientes possam exibi-las como 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 chatInfo e meetingInfo.

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

Methods

Método	Tipo de retorno	Descrição
Get	call	Leia propriedades do objeto call.
Delete	Nenhum	Exclua ou desligue uma chamada ativa.
KeepAlive	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 participants	participant collection	Obtenha uma coleção do objeto participant.
Convidar participantes	commsOperation	Convide participantes para a chamada ativa.
Ativar mudo para todos os participantes	commsOperation	Ative o mudo para todos os participantes em uma chamada.
Ativar mudo para participante	muteParticipantOperation	Ative o mudo para participante na chamada de grupo.
Configurar o mixer de áudio	commsOperation	Configure áudio na conversa com vários participantes.
Create audioRoutingGroup	audioRoutingGroup	Crie um novo audioRoutingGroup postando na coleção audioRoutingGroups.
List audioRoutingGroups	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.
Interactive-Voice-Response
PlayPrompt	playPromptOperation	Reproduza uma solicitação na chamada.
RecordResponse	recordOperation	Registra uma resposta de áudio curta do chamador.
CancelMediaProcessing	commsOperation	Cancele o processamento de mídia.
SubscribeToTone	commsOperation	Inscreva-se nos tons DTMF.
Operações do próprio participante
Mute	muteParticipantOperation	Ative o mudo para si mesmo na chamada.
Unmute	unmuteParticipantOperation	Desative o mudo automaticamente na chamada.
ChangeScreenSharingRole	Nenhum	Inicie e interrompa a tela de compartilhamento na chamada.
Operações de gravação
UpdateRecordingStatus	updateRecordingStatusOperation	Atualiza o status da gravação.
Operações de Registro
Registrar dados de qualidade do dispositivo	teleconferenceDeviceQuality	Registre dados de qualidade do dispositivo de videoconferência.

Propriedades

Propriedade	Tipo	Descrição
activeModalities	coleção modality	A lista de modalidades ativas. Os valores possíveis são: unknown, audio, video, videoBasedScreenSharing, data. Somente leitura.
answeredBy	participantInfo	O participante que atendeu a chamada. Somente leitura.
callRoutes	callRoute collection	As informações de roteamento sobre como a chamada foi redirecionada. Somente leitura.
callbackUri	String	O URL de retorno de chamada no qual os retornos de chamada serão entregues. Devemos ser https.
callChainId	Cadeia de caracteres	Um identificador exclusivo para todas as chamadas de participantes em conferência ou um identificador exclusivo para duas chamadas de participantes em uma chamada P2P. Isso precisa ser copiado de Microsoft.Graph.Call.CallChainId.
callOptions	outgoingCallOptions	Contém os recursos opcionais para a chamada.
chatInfo	chatInfo	As informações de chat. Informações necessárias para cenários de reunião.
direction	callDirection	A direção da chamada. Os valores possíveis são incoming ou outgoing. Somente leitura.
id	String	A ID de chamada. Somente leitura.
incomingContext	incomingContext	O contexto associado a uma chamada de entrada. Somente leitura. Gerado pelo servidor.
mediaConfig	appHostedMediaConfig ou serviceHostedMediaConfig	A configuração da mídia. Informações necessárias para criar chamadas ponto a ponto ou ingressar em reuniões.
mediaState	callMediaState	Somente leitura. O estado da mídia de chamadas.
meetingCapability	meetingCapability	Contém os recursos de uma reunião. Somente leitura.
meetingInfo	organizerMeetingInfo, tokenMeetingInfo ou joinMeetingIdMeetingInfo	As informações da reunião. Informações necessárias para cenários de reunião.
transcrição	callTranscriptionInfo	As informações da transcrição da chamada. Somente leitura.
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 pode incluir o motivo de término. Somente leitura.
ringingTimeoutInSeconds	Int32	Tempo limite do toque em segundos para chamadas realizadas de ponto a ponto. O valor máximo para esse atributo é de 115 segundos.
routingPolicies	routingPolicy collection collection	Esta propriedade é aplicável apenas para chamadas ponto a ponto. Os valores possíveis são: none, noMissedCall, disableForwardingExceptPhone, disableForwarding, preferSkypeForBusiness, unknownFutureValue.
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.
tenantId	String	Somente leitura. tenantId em Azure Active Directory.
terminationReason	String	Somente leitura.
toneInfo	toneInfo	Somente leitura.

Relações

Relação	Tipo	Descrição
audioRoutingGroups	audioRoutingGroup collection	Somente leitura. Anulável.
operations	commsOperation collection	Somente leitura. Anulável.
participants	participant collection	Somente leitura. Anulável.
contentSharingSessions	coleção contentSharingSession	Somente leitura. Anulável.

Representação JSON

Veja a seguir uma representação JSON do recurso.

{
  "activeModalities": ["unknown | audio | video | videoBasedScreenSharing | data"],
  "answeredBy": {"@odata.type": "#microsoft.graph.participantInfo"},
  "callRoutes": [{"@odata.type": "#microsoft.graph.callRoute"}],
  "callbackUri": "String",
  "callChainId": "String",
  "callOptions": {"@odata.type": "#microsoft.graph.outgoingCallOptions"},
  "chatInfo": {"@odata.type": "#microsoft.graph.chatInfo"},
  "contentSharingSessions": [{ "@odata.type": "microsoft.graph.contentSharingSession" }],
  "direction": "incoming | outgoing",
  "id": "String (identifier)",
  "incomingContext": {"@odata.type": "#microsoft.graph.incomingContext"},
  "mediaConfig": {"@odata.type": "#microsoft.graph.mediaConfig"},
  "mediaState": {"@odata.type": "#microsoft.graph.callMediaState"},
  "meetingCapability": {"@odata.type": "#microsoft.graph.meetingCapability"},
  "meetingInfo": {"@odata.type": "#microsoft.graph.meetingInfo"},
  "transcription": {"@odata.type": "#microsoft.graph.callTranscriptionInfo"},
  "myParticipantId": "String",
  "replacesContext": "String",
  "requestedModalities": ["unknown | audio | video | videoBasedScreenSharing | data"],
  "resultInfo": {"@odata.type": "#microsoft.graph.resultInfo"},
  "ringingTimeoutInSeconds": 99,
  "routingPolicies": ["none | noMissedCall | disableForwardingExceptPhone | disableForwarding | preferSkypeForBusiness"],
  "source": {"@odata.type": "#microsoft.graph.participantInfo"},
  "state": "incoming | establishing | ringing | established | hold | transferring | transferAccepted | redirecting | terminating | terminated",
  "subject": "String",
  "targets": [{"@odata.type": "#microsoft.graph.invitationParticipantInfo"}],
  "tenantId": "String",
  "terminationReason": "String",
  "toneInfo": {"@odata.type": "#microsoft.graph.toneInfo"}
}