CODEWITHSUNDEEP
microsoft-teamsmicrosoft-graph-teams
MHugh
MHugh

Reputation: 465

How to Transfer a Party between two Teams Calls, via the Calls Graph API

We have a scenario with two group calls.

Call 1 has two Participants : Party "A" and a call handling BOT (BOT1)

Call 2 has three Participants : Party "B", Party "C" and a call handling BOT (BOT2)

All parties are normal Teams users.

We want to transfer Party B from Call 2 to Call 1 using BOT2

We are trying to do this with the Transfer() function, using example 5 from this reference https://learn.microsoft.com/en-us/graph/api/call-transfer?view=graph-rest-1.0&tabs=csharp#example-5-call-transfer-from-a-group-call

However there is some confusion over what setting we should apply to the parameters.

  1. I am assuming that the ID and DisplayName of the transferTarget should be those of Party C

  2. What should the ID and Participant ID of the transferee be set to ? Note that it is implicit that the ID is not that of Party C as given in the tranferTarget block, This is because in the example referenced, the two values are different.

I have checked the sample code at https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/bot-calling-meeting/ but this does not demonstrate transferring using the transferee block, just the simple case of transferring an user into a call.

Can anyone shed any light on what to set the transferTarget and transferee values to in order to meet the requirements of the scenario described ?

Upvotes: 0

Views: 215

Answers (1)

Sayali-MSFT
Sayali-MSFT

Reputation: 369

A consultative transfer means that the transferor can inform the person they want to transfer the call to (the transferee), before the transfer is made. This is opposed to transferring the call directly.

Transfer Target: The new party being introduced into a call with the Transferee.

participantId : The ID of the target participant.

So the ID and display name should be target participant.

also please note the below supported scenario in Group call-

If bot wants to invite another PSTN to join, the P2P call will be escalated into a group call. So far we don't support escalation by adding PSTN. We are working on this feature now and it will be ready soon. So, here are some scenarios:

  • P2P call between Bot and another peer (Teams user, PSTN), bot invites another PSTN: Not supported.

  • P2P call between Bot and another peer (Teams user, PSTN), bot invites another Teams user: Supported.

  • P2P call between Bot and another peer (Teams user, PSTN), bot invites another bot: Supported.

Reference Document-https://learn.microsoft.com/en-us/graph/api/call-transfer?view=graph-rest-1.0&tabs=http#request-body

Upvotes: 1

Related Questions