You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: api-reference/v1.0/api/application-post-calls.md
+10-40Lines changed: 10 additions & 40 deletions
Original file line number
Diff line number
Diff line change
@@ -11,7 +11,7 @@ doc_type: apiPageType
11
11
12
12
Namespace: microsoft.graph
13
13
14
-
Create [call](../resources/call.md) enables your bot to create a new outgoing peer-to-peer or group call, or join an existing meeting. You will need to [register the calling bot](/microsoftteams/platform/concepts/calls-and-meetings/registering-calling-bot) and go through the list of permissions needed as mentioned below.
14
+
Create [call](../resources/call.md) enables your bot to create a new outgoing peer-to-peer or group call, or join an existing meeting. You need to [register the calling bot](/microsoftteams/platform/concepts/calls-and-meetings/registering-calling-bot) and go through the list of permissions needed.
15
15
16
16
This API supports the following PSTN scenarios:
17
17
@@ -62,15 +62,13 @@ If successful, this method returns a `201 Created` response code and a [call](..
62
62
63
63
## Examples
64
64
65
-
### Example 1: Create peer-to-peer VoIP call with servicehosted media
65
+
### Example 1: Create a peer-to-peer VoIP call with service-hosted media
66
66
67
67
> **Note:** This call needs the Calls.Initiate.All permission.
68
68
69
69
#### Request
70
-
The following example shows a request that makes a peer-to-peer call between the bot and the specified user. In this example, the media is hosted by the service. The values of authorization token, callback URL, application ID, application name, user ID, user name, and tenant ID must be replaced with actual values to make the example work.
70
+
The following example shows a request that makes a peer-to-peer call between the bot and the specified user. In this example, the service hosts the media. The values of authorization token, callback URL, application ID, application name, user ID, user name, and tenant ID must be replaced with actual values to make the example work.
Copy file name to clipboardExpand all lines: api-reference/v1.0/api/call-answer.md
+10-44Lines changed: 10 additions & 44 deletions
Original file line number
Diff line number
Diff line change
@@ -11,9 +11,9 @@ doc_type: apiPageType
11
11
12
12
Namespace: microsoft.graph
13
13
14
-
Enable a bot to answer an incoming [call](../resources/call.md). The incoming call request can be an invitation from a participant in a group call or a peer-to-peer call. If an invitation to a group call is received, the notification will contain the [chatInfo](../resources/chatinfo.md) and [meetingInfo](../resources/meetinginfo.md) parameters.
14
+
Enable a bot to answer an incoming [call](../resources/call.md). The incoming call request can be an invitation from a participant in a group call or a peer-to-peer call. If an invitation to a group call is received, the notification contains the [chatInfo](../resources/chatinfo.md) and [meetingInfo](../resources/meetinginfo.md) parameters.
15
15
16
-
The bot is expected to answer, [reject](./call-reject.md), or [redirect](./call-redirect.md) the call before the call times out. The current timeout value is 15 seconds for regular scenarios, and 5 seconds for policy-based recording scenarios.
16
+
The bot is expected to answer, [reject](./call-reject.md), or [redirect](./call-redirect.md) the call before the call times out. The current timeout value is 15 seconds for regular scenarios and 5 seconds for policy-based recording scenarios.
17
17
18
18
This API supports the following PSTN scenarios:
19
19
@@ -56,11 +56,11 @@ In the request body, provide a JSON object with the following parameters.
| callbackUri |String |Allows bots to provide a specific callback URI for the concurrent call to receive later notifications. If this property has not been set, the bot's global callback URI will be used instead. This must be `https`. |
60
-
|acceptedModalities|String collection |The list of accept modalities. Possible values are: `audio`, `video`, `videoBasedScreenSharing`. Required for answering a call. |
59
+
| callbackUri |String |Allows bots to provide a specific callback URI for the concurrent call to receive later notifications. If this property isn't set, the bot's global callback URI is used instead. I must be `https`. |
60
+
|acceptedModalities|String collection |The list of accepted modalities. Possible values are: `audio`, `video`, `videoBasedScreenSharing`. Required for answering a call. |
61
61
| callOptions |[incomingCallOptions](../resources/incomingcalloptions.md)| The call options. |
62
62
| mediaConfig |[appHostedMediaConfig](../resources/apphostedmediaconfig.md) or [serviceHostedMediaConfig](../resources/servicehostedmediaconfig.md)|The media configuration. (Required) |
63
-
| participantCapacity | Int32 | The number of participant that the application can handle for the call, for [Teams policy-based recording](/microsoftteams/teams-recording-policy) scenario. |
63
+
| participantCapacity | Int32 | The number of participants that the application can handle for the call, for [Teams policy-based recording](/microsoftteams/teams-recording-policy) scenario. |
64
64
65
65
## Response
66
66
This method returns a `202 Accepted` response code.
@@ -71,7 +71,6 @@ The following example shows how to call this API.
### Example 3: Answer a policy-based recording call
567
533
568
-
Under the [Policy-based recording scenario](/microsoftteams/teams-recording-policy), before a participant under policy joins a call, an incoming call notification will be sent to the bot associated with the policy.
534
+
Under the [Policy-based recording scenario](/microsoftteams/teams-recording-policy), before a participant under policy joins a call, an incoming call notification is sent to the bot associated with the policy.
569
535
The join information can be found under the **botData** property. The bot can then choose to answer the call and [update the recording status](call-updaterecordingstatus.md) accordingly.
570
536
571
-
When `participantCapacity` is specified in the `Answer` request for a policy-based recording notification, subsequent participant joining event belonging to the same policy group will be sent out as [participantJoiningNotification](../resources/participantJoiningNotification.md) instead of
572
-
new incoming call notification, until number of participants that current call instance is handling has reached the number specified in `participantCapacity`.
537
+
When `participantCapacity` is specified in the `Answer` request for a policy-based recording notification, subsequent participant joining events belonging to the same policy group is sent out as [participantJoiningNotification](../resources/participantJoiningNotification.md) instead of
538
+
new incoming call notification, until a number of participants that the current call instance is handling has reached the number specified in `participantCapacity`.
573
539
574
540
The following is an example of the incoming call notification that a bot would receive in this case.
| hideBotAfterEscalation | Boolean | Indicates whether to hide the app after the call is escalated. Inherited from [callOptions](calloptions.md). |
23
23
| isContentSharingNotificationEnabled | Boolean | Indicates whether content sharing notifications should be enabled for the call. Inherited from [callOptions](calloptions.md). |
24
+
| isDeltaRosterEnabled | Boolean | Indicates whether delta roster is enabled for the call. Inherited from [callOptions](calloptions.md). |
24
25
25
26
## JSON representation
26
27
@@ -34,6 +35,7 @@ The following JSON representation shows the resource type.
| hideBotAfterEscalation | Boolean | Indicates whether to hide the app after the call is escalated. Inherited from [callOptions](calloptions.md). |
23
23
| isContentSharingNotificationEnabled | Boolean | Indicates whether content sharing notifications should be enabled for the call. Inherited from [callOptions](calloptions.md). |
24
+
| isDeltaRosterEnabled | Boolean | Indicates whether delta roster is enabled for the call. Inherited from [callOptions](calloptions.md). |
24
25
25
26
## JSON representation
26
27
@@ -34,6 +35,7 @@ The following JSON representation shows the resource type.
Copy file name to clipboardExpand all lines: changelog/Microsoft.Skype.Calling.json
+34Lines changed: 34 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,39 @@
1
1
{
2
2
"changelog": [
3
+
{
4
+
"ChangeList": [
5
+
{
6
+
"Id": "a1ffd465-a1bf-4a36-84c5-87gg66c11118",
7
+
"ApiChange": "Property",
8
+
"ChangedApiName": "isDeltaRosterEnabled",
9
+
"ChangeType": "Addition",
10
+
"Description": "Added the **isDeltaRosterEnabled** property to the [callOptions](https://learn.microsoft.com/en-us/graph/api/resources/callOptions?view=graph-rest-1.0) resource.",
11
+
"Target": "callOptions"
12
+
},
13
+
{
14
+
"Id": "a1ffd465-a1bf-4a36-84c5-87gg66c11118",
15
+
"ApiChange": "Property",
16
+
"ChangedApiName": "isDeltaRosterEnabled",
17
+
"ChangeType": "Addition",
18
+
"Description": "Added the **isDeltaRosterEnabled** property to the [incomingCallOptions](https://learn.microsoft.com/en-us/graph/api/resources/incomingCallOptions?view=graph-rest-1.0) resource.",
19
+
"Target": "incomingCallOptions"
20
+
},
21
+
{
22
+
"Id": "a1ffd465-a1bf-4a36-84c5-87gg66c11118",
23
+
"ApiChange": "Property",
24
+
"ChangedApiName": "isDeltaRosterEnabled",
25
+
"ChangeType": "Addition",
26
+
"Description": "Added the **isDeltaRosterEnabled** property to the [outgoingCallOptions](https://learn.microsoft.com/en-us/graph/api/resources/outgoingCallOptions?view=graph-rest-1.0) resource.",
Copy file name to clipboardExpand all lines: concepts/whats-new-overview.md
+4Lines changed: 4 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -40,6 +40,10 @@ Added recommendations to use unified RBAC APIs in [unifiedRoleDefinition](/graph
40
40
41
41
Use the **clientAppId** property on [teamsAppAuthorization](/graph/api/resources/teamsappauthorization) to get the registration ID of the Microsoft Entra app ID associated with an [app](/graph/api/resources/teamsapp) in the Microsoft Teams app catalog.
42
42
43
+
### Teamwork and communications | Calls and online meetings
44
+
45
+
Use the **isDeltaRosterEnabled** property on [incomingCallOptions](/graph/api/resources/incomingcalloptions) and [outgoingCallOptions](/graph/api/resources/outgoingcalloptions) to indicate whether delta roster is enabled for a call.
46
+
43
47
### Teamwork and communications | Messaging
44
48
45
49
Updated the [chatMessage: delta](/graph/api/chatmessage-delta) method to use a new endpoint that gets the list of delta messages from all chats in which a user is a participant, including one-on-one chats, group chats, and meeting chats.
0 commit comments