Updates to SIP pages and TOC

Author: sloanster

articles/communication-services/how-tos/calling-sdk/call-context.md

@@ -2,24 +2,34 @@
 title: How to pass contextual data between calls
 titleSuffix: An Azure Communication Services how-to guide
 description: Use Azure Communication Services SDKs to pass contextual data between calls.
-author: aakanmu
-ms.author: aakanmu
+author: sloanster
+ms.author: micahvivion
 ms.service: azure-communication-services
 ms.subservice: calling
 ms.topic: how-to 
-ms.date: 05/14/2024
+ms.date: 09/13/2024
 ms.custom: template-how-to
 ---
 
-# Passing Contextual Information
+# Using the ACS calling SDK to pass contextual User-to-User Information (UUI) data between calls
 
 In this article, you learn how to pass along custom contextual information when routing calls with Azure Communication Services Calling SDKs. This capability allows users to pass metadata about the call, callee, or any other information that is relevant to their application or business logic.
 
+The Azure Communication Services (ACS) WebJS SDK provides developers to include custom contextual data (included as a header on the calling object) when directing and routing calls from one person to another.  This information, also known as User-to-User Information (UUI) data or call control UUI data, is a small piece of data inserted by an application initiating the call. The UUI data is opaque to end users making a call.
+
 Contextual information supported includes both freeform custom headers and the standard User-to-User Information (UUI) SIP header. Also when you receive an inbound call, the custom headers and UUI are included in the incomingCall payload.
 
 All custom context data is opaque to Calling SDK or SIP protocols and its content is unrelated to any basic functions.
 
-[!INCLUDE [Public Preview Disclaimer](../../includes/public-preview-include-document.md)]
+Developers can pass this context by using custom headers, which consist of optional key-value pairs. These pairs can be included in the 'AddParticipant' or 'Transfer' actions within the calling SDK. Once added, you can read the data payload as the call moves between endpoints. By efficiently looking up this metadata and associating it with the call, developers can avoid external database lookups and have the content information readily available within the call object.
+
+The custom call context can be transmitted to SIP endpoints using the SIP protocol. This transmission includes both the custom headers and the standard User-to-User Information (UUI) SIP header. When an inbound call is routed from your telephony network, the data from your Session Border Controller (SBC) in the custom headers and UUI is also included in the IncomingCall event payload.
+
+It’s important to note that all custom context data remains transparent to the calling SDK and isn't related to any of the SDK’s fundamental functions when used in SIP protocols. Here's a tutorial to assist you in adding custom context headers when using the WebJS SDK.
+
+
+> [!IMPORTANT]
+> To use the ability to pass User-to-User Information (UUI) data using the calling SDK you must use the calling WebJS SDK GA or public preview version `1.29.1` or later.
 
 ## Prerequisites
 

articles/communication-services/how-tos/calling-sdk/includes/call-context/call-context-web.md

@@ -1,12 +1,25 @@
 ---
-author: aakanmu
+author: sloanster
 ms.service: azure-communication-services
 ms.topic: include
-ms.date: 05/14/2024
-ms.author: aakanmu
+ms.date: 09/13/2024
+ms.author: micahvivion
 ---
 [!INCLUDE [Install SDK](../install-sdk/install-sdk-web.md)]
 
+## Technical parameters
+The calling SDK supports adding up to 5 custom SIP headers and 1000 custom VOIP headers. Additionally, developers can include a dedicated User-To-User header as part of SIP headers list.
+
+The maximum length of a SIP header key is 64 chars, including the X-MS-Custom prefix. Due note that when the SIP header is added the calling SDK will automatically add the ‘X-MS-Custom-’ prefix (which can be seeing if you inspect the SIP header with packet inspector).
+
+The SIP header key may consist of alphanumeric characters and a few selected symbols which include `.`, `!`, `%`, `*`, `_`, `+`, `~`, `-`. The maximum length of SIP header value is 256 chars. The same limitations apply when configuring the SIP headers on your SBC. The SIP header value may consist of alphanumeric characters and a few selected symbols which include `=`, `;`, `.`, `!`, `%`, `*`, `_`, `+`, `~`, `-`.
+
+The maximum length of a VOIP header key is 64 chars. The maximum length of VOIP header value is 1024 chars.
+
+When adding these custom headers as a developer you can choose to add only SIP headers, only VoIP headers or both can be included.
+
+Currently, adding custom User-to-User Information headers is only supported when initiating a 1:1 call. After starting the 1:1 call, you can include additional participants while maintaining the User-to-User Information within the calls. 
+
 ## Place a call with contextual Information
 
 ```js

articles/communication-services/toc.yml

@@ -287,17 +287,6 @@ items:
       href: tutorials/building-app-start.md
     - name: Build an authentication service using Azure Functions
       href: tutorials/trusted-service-tutorial.md
-    - name: Add video calling to your Android WebView client app
-      href: quickstarts/voice-video-calling/get-started-android-webview.md
-    - name: Using Event Grid to send calling push notifications
-      href: tutorials/add-voip-push-notifications-event-grid.md
-    - name: Proxy your calling traffic
-      href: tutorials/proxy-calling-support-tutorial.md
-    - name: Survey users
-      href: tutorials/end-of-call-survey-tutorial.md
-      displayName: diagnostics, Survey, feedback, quality, reliability, users, end, call, quick
-    - name: Collecting user feedback with the mobile UI Library
-      href: tutorials/collecting-user-feedback/collecting-user-feedback.md
     - name: Audio quality enhancements
       items:
         - name: Enabling audio effects
@@ -415,6 +404,13 @@ items:
         - name: 3. Microphone and camera setup before a call
           href: tutorials/call-readiness/call-readiness-tutorial-part-3-camera-microphone-setup.md
           displayName: diagnostics, diagnose, feedback, quality, reliability, users, call, quick, satisfaction, improve, issues
+    - name: Add end of call survey
+      items:
+        - name: Using the survey users API
+        - href: tutorials/end-of-call-survey-tutorial.md
+        - displayName: diagnostics, Survey, feedback, quality, reliability, users, end, call, quick
+        - name: Collecting user feedback with the mobile UI Library
+        - href: tutorials/collecting-user-feedback/collecting-user-feedback.md
     - name: Migrating to Azure Communication Services
       items:
         - name: Migrate from Twilio Video to Azure Communication Services
@@ -465,6 +461,8 @@ items:
           href: how-tos/ui-library-sdk/troubleshooting.md
     - name: Events
       items:
+      - name: Using Event Grid to send calling push notifications
+      - href: tutorials/add-voip-push-notifications-event-grid.md
       - name: View calling events
         href: quickstarts/voice-video-calling/handle-calling-events.md
     - name: Analytics
@@ -489,6 +487,12 @@ items:
         href: how-tos/calling-sdk/breakoutrooms.md
       - name: Together Mode
         href: how-tos/calling-sdk/together-mode.md
+    - name: Configuring to proxy traffic
+      - name: Proxy your calling traffic
+        href: tutorials/proxy-calling-support-tutorial.md
+    - name: Build a Webview based client
+      - name: Add video calling to your Android WebView client app
+      - href: quickstarts/voice-video-calling/get-started-android-webview.md
   - name: Chat
     items:
     - name: Build an authentication service using Azure Functions

articles/communication-services/tutorials/calling-sdk/tutorials/pass-contextual-data-header.md

@@ -5,7 +5,7 @@ description: Provide a tutorial on how to pass contextual User-to-User Informati
 author: sloanster
 ms.topic: tutorial
 ms.service: azure-communication-services
-ms.date: 09/12/2024
+ms.date: 09/13/2024
 ms.author: micahvivion
 services: azure-communication-services
 ---