Partager via

Type de ressource Call

  • Article

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

La ressource d’appel est créée lorsqu’il y a un appel entrant pour l’application ou que l’application crée un nouvel appel sortant via un POST sur app/calls.

Les appels peuvent être configurés en tant qu'appel de réseau pair à pair ou en tant qu'appel de groupe. Pour créer ou rejoindre un appel de groupe, fournissez le chatInfo et meetingInfo. Si elles ne sont pas fournies, un nouvel appel de groupe est créé automatiquement. Pour un appel entrant, enregistrez ces valeurs dans une mémoire facilement accessible, de sorte que votre application puisse reprendre l'appel en cas de panne de votre application.

Bien que la même identité ne puisse pas être invitée plusieurs fois, il est possible pour une application de rejoindre la même réunion plusieurs fois. Chaque fois que l’application souhaite participer, une identité distincte doit être fournie pour que les clients l’affiche en tant qu’autre participant.

Remarque : vous pouvez obtenir l’URL de participation d’un appel de réunion planifiée avec Microsoft Teams. Extraire les données de l’URL comme indiqué pour compléter chatInfo et 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

Devient :

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

Remarque

Les problèmes connus suivants sont associés à cette ressource :

Méthodes

Méthode Type renvoyé Description
Créer Appel Créer un appel permet à votre bot de créer un nouvel appel d’égal à égal ou de groupe sortant, ou de rejoindre une réunion existante.
Obtenir call Lire les propriétés de l’objet call.
Supprimer/raccrocher Aucun Supprimer ou raccrocher un appel en cours.
Garder en vie Aucun Veillez à ce que l’appel reste actif.
Call Handling
Answer Aucun Répondre à un appel entrant.
Reject Aucun Rejeter un appel entrant.
Redirect Aucun Rediriger un appel entrant.
Transfer Aucun Transférer un appel
Appels de groupe
List Liste de participants Récupérer une collection d’objets participant.
Inviter les participants commsOperation Inviter des participants à l’appel en cours.
Désactiver le son pour tous les participants commsOperation Désactivez le son de tous les participants dans l’appel.
Désactiver le son des Participants muteParticipantOperation Désactiver le son d’un participant lors de l’appel de groupe.
Create audioRoutingGroup Créer un nouveau groupe audioRoutingGroup en postant dans la collection audioRoutingGroups.
Répertorier les groupes de routage audio CollectionaudioRoutingGroup Récupérer une collection d’objet audioRoutingGroup.
Ajouter une vue de galerie volumineuse addLargeGalleryViewOperation Ajoutez la vue de la grande galerie à un appel.
Interactive-Voice-Response
Lire une invitation playPromptOperation Lire l’invite dans l’appel.
Enregistrer la réponse recordOperation Enregistre une courte réponse audio de l’appelant.
Annuler le traitement multimédia commsOperation Annuler le traitement du média.
S’abonner à la tonalité commsOperation Abonnement aux tonalités DTMF.
Envoyer la tonalité DTMF commsOperation Envoyer des tonalités DTMF dans un appel.
Self Participant Operations
Désactiver le son de l’application muteParticipantOperation Désactivez le son pour soi-même dans l’appel.
Activer l’application unmuteParticipantOperation Réactivez le son pour soi-même dans l’appel.
Changer de rôle partage écran Aucun Démarrer et arrêter le partage d’écran dans l’appel.
Opérations d’enregistrement
Mettre à jour les status d’enregistrement updateRecordingStatusOperation Met à jour le statut de l’enregistrement.
Démarrer l’enregistrement startRecordingOperation Démarre l’enregistrement d’un appel.
Arrêter l’enregistrement stopRecordingOperation Arrête l’enregistrement d’un appel.
Démarrer la transcription startTranscriptionOperation Démarre la transcription d’un appel.
Arrêter la transcription stopTranscriptionOperation Arrête la transcription d’un appel.
Opérations de journalisation
Journaliser les données de qualité des appareils de téléconférence teleconferenceDeviceQuality Enregistrez les données de qualité d’un appareil de téléconférence vidéo.

Propriétés

Propriété Type Description
activeModalities collection de modalités Liste des modalités actives. Les valeurs possibles sont les suivantes : unknown, audio, video, videoBasedScreenSharing, data. En lecture seule.
answeredBy participantInfo Le participant qui répond à l’appel. En lecture seule.
callRoutes callRoute collection de sites Les informations de routage sur la manière dont l’appel a été reciblé. En lecture seule.
callbackUri String L’URL de rappel vers laquelle les rappels seront remis. Doit être https.
callChainId Chaîne Identificateur unique de tous les appels de participants dans une conférence ou un identificateur unique pour deux appels de participants dans un appel P2P. Il doit être copié depuis Microsoft.Graph.Call.CallChainId.
callOptions outgoingCallOptions Contient les fonctionnalités facultatives de l’appel.
chatInfo chatInfo Informations de chat. Informations requises pour les scénarios de réunion.
direction callDirection Direction de l’appel. Les valeurs possibles sont incoming ou outgoing. En lecture seule.
id String ID de l’appel. En lecture seule.
incomingContext incomingContext Le contexte associé à un appel entrant. Lecture seule. Généré par le server.
mediaConfig appHostedMediaConfig ou serviceHostedMediaConfig Configuration du média. Informations requises pour la création d’appels d’égal à égal ou pour la participation à des réunions.
mediaState callMediaState En lecture seule. État du support d’appel.
meetingCapability meetingCapability Contient les fonctionnalités d’une réunion. En lecture seule.
meetingInfo organizerMeetingInfo, tokenMeetingInfo, ou joinMeetingIdMeetingInfo Informations de réunion. Informations requises pour les scénarios de réunion.
transcription callTranscriptionInfo Informations de la transcription pour l’appel. En lecture seule.
myParticipantId Chaîne En lecture seule.
requestedModalities collection de modalités Liste des modalités demandées. Les valeurs possibles sont les suivantes : unknown, audio, video, videoBasedScreenSharing, data.
resultInfo resultInfo Informations résultat. Par exemple, le résultat peut contenir la raison de l’arrêt. En lecture seule.
ringingTimeoutInSeconds Int32 Délai d’expiration en attente en secondes pour les appels d’égal à égal sortants. La valeur maximale pour cet attribut est de 115 secondes.
routingPolicies collection routingPolicy Cette propriété est applicable pour les appels d’égal à égal uniquement. Les valeurs possibles sont : none, noMissedCall, disableForwardingExceptPhone, disableForwarding, preferSkypeForBusiness, unknownFutureValue.
source participantInfo L’émetteur de l’appel.
état callState État de l'appel. Les valeurs possibles sont les suivantes : incoming, establishing, ringing, established, hold, transferring, transferAccepted, redirecting, terminating et terminated. En lecture seule.
subject Chaîne Objet de la conversation.
cibles Collection invitationParticipantInfo Cibles de l’appel. Informations requises pour la création d’appels d’égal à égal.
tenantId String En lecture seule. tenantIddans Microsoft Entra ID.
terminationReason Chaîne En lecture seule.
toneInfo toneInfo En lecture seule.

Relations

Relation Type Description
audioRoutingGroups CollectionaudioRoutingGroup En lecture seule. Peut avoir la valeur Null.
operations Collecte commsOperation En lecture seule. Pouvant accepter la valeur Null.
participants Liste de participants En lecture seule. Pouvant accepter la valeur Null.
contentSharingSessions collection contentSharingSession En lecture seule. Pouvant accepter la valeur Null.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "activeModalities": ["String"],
  "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": "String",
  "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",
  "requestedModalities": ["String"],
  "resultInfo": {"@odata.type": "#microsoft.graph.resultInfo"},
  "ringingTimeoutInSeconds": 99,
  "routingPolicies": ["String"],
  "source": {"@odata.type": "#microsoft.graph.participantInfo"},
  "state": "String",
  "subject": "String",
  "targets": [{"@odata.type": "#microsoft.graph.invitationParticipantInfo"}],
  "tenantId": "String",
  "terminationReason": "String",
  "toneInfo": {"@odata.type": "#microsoft.graph.toneInfo"}
}