Merge pull request #256403 from paolamvhz/pstnRooms

Adding Rooms PSTN capabilities to conceptual documents

Author: prmerger-automator[bot]

articles/communication-services/concepts/analytics/logs/rooms-logs.md

@@ -59,6 +59,7 @@ Communication Services offers the following types of logs that you can enable:
 | `UpsertedRoomParticipantsCount` | The count of participants upserted in a Room. |
 | `RemovedRoomParticipantsCount` | The count of participants removed from a Room. |
 | `TimeGenerated` | The timestamp (UTC) of when the log was generated. |
+| `PstnDialOutEnabled` | Indicates whether a room has the ability to make PSTN calls to invite people to a meeting. |
 
 
 #### Example CreateRoom log
@@ -69,13 +70,14 @@ Communication Services offers the following types of logs that you can enable:
       "CorrelationId": "Y4x6ZabFE0+E8ERwMpd68w",
       "Level": "Informational",
       "OperationName": "CreateRoom",
-      "OperationVersion": "2022-03-31-preview",
+      "OperationVersion": "2023-10-30-preview",
       "ResultType": "Succeeded",
       "ResultSignature": 201,
       "RoomId": "99466898241024408",
       "RoomLifespan": 61,
       "AddedRoomParticipantsCount": 4,
       "TimeGenerated": "5/25/2023, 4:32:49.469 AM",
+      "PstnDialOutEnabled": false,
       }
     ]
 ```
@@ -88,7 +90,7 @@ Communication Services offers the following types of logs that you can enable:
       "CorrelationId": "CNiZIX7fvkumtBSpFq7fxg",
       "Level": "Informational",
       "OperationName": "GetRoom",
-      "OperationVersion": "2022-03-31-preview",
+      "OperationVersion": "2023-10-30-preview",
       "ResultType": "Succeeded",
       "ResultSignature": "200",
       "RoomId": "99466387192310000",
@@ -106,12 +108,13 @@ Communication Services offers the following types of logs that you can enable:
       "CorrelationId": "Bwqzh0pdnkGPDwNcMnBkng",
       "Level": "Informational",
       "OperationName": "UpdateRoom",
-      "OperationVersion": "2022-03-31-preview",
+      "OperationVersion": "2023-10-30-preview",
       "ResultType": "Succeeded",
       "ResultSignature": "200",
       "RoomId": "99466387192310000",
       "RoomLifespan": 121,
       "TimeGenerated": "2022-08-19T17:07:30.3543160Z",
+      "PstnDialOutEnabled": false,
       },
     ]
 ```
@@ -124,7 +127,7 @@ Communication Services offers the following types of logs that you can enable:
       "CorrelationId": "x7rMXmihYEe3GFho9T/H2w",
       "Level": "Informational",
       "OperationName": "DeleteRoom",
-      "OperationVersion": "2022-02-01",
+      "OperationVersion": "2023-10-30-preview",
       "ResultType": "Succeeded",
       "ResultSignature": "204",
       "RoomId": "99466387192310000",
@@ -142,7 +145,7 @@ Communication Services offers the following types of logs that you can enable:
 	  "CorrelationId": "KibM39CaXkK+HTInfsiY2w",
 	  "Level": "Informational",
 	  "OperationName": "ListRooms",
-	  "OperationVersion": "2022-03-31-preview",
+	  "OperationVersion": "2023-10-30-preview",
 	  "ResultType": "Succeeded",
 	  "ResultSignature": "200",
 	  "TimeGenerated": "2022-08-19T17:07:30.5393800Z",
@@ -158,7 +161,7 @@ Communication Services offers the following types of logs that you can enable:
       "CorrelationId": "zHT8snnUMkaXCRDFfjQDJw",
       "Level": "Informational",
       "OperationName": "UpdateParticipants",
-      "OperationVersion": "2022-03-31-preview",
+      "OperationVersion": "2023-10-30-preview",
       "ResultType": "Succeeded",
       "ResultSignature": "200",
       "RoomId": "99466387192310000",

articles/communication-services/concepts/rooms/room-concept.md

@@ -20,6 +20,7 @@ Here are the main scenarios where rooms are useful:
 - **Rooms enable scheduled communication experience.** Rooms help service platforms deliver meeting-style experiences while still being suitably generic for a wide variety of industry applications. Services can schedule and manage rooms for patients seeking medical advice, financial planners working with clients, and lawyers providing legal services.
 - **Rooms enable an invite-only experience.** Rooms allow your services to control which users can join the room for a virtual appointment with doctors or financial consultants. This will allow only a subset of users with assigned Communication Services identities to join a room call.
 - **Rooms enable structured communications through roles and permissions.** Rooms allow developers to assign predefined roles to users to exercise a higher degree of control and structure in communication. Ensure only presenters can speak and share content in a large meeting or in a virtual conference.
+- **Rooms enable to perform calls using PSTN.** Rooms enable users to invite participants to a meeting by making phone calls through the public switched telephone network (PSTN).
 
 ## When to use rooms
 
@@ -115,6 +116,8 @@ The tables below provide detailed capabilities mapped to the roles. At a high le
 | - Render a video in multiple places (local camera or remote stream) | ✔️ | ✔️ | ✔️ <br>(Only Remote)</br> |
 | - Set/Update video scaling mode | ✔️ | ✔️ | ✔️ <br>(Only Remote)</br> |
 | - Render remote video stream | ✔️ | ✔️ | ✔️ |
+| **PSTN calls** | | |
+| - Call participants using phone calls | ✔️ | ❌ | ❌ |
 
 *) Only available on the web calling SDK. Not available on iOS and Android calling SDKs