cleaned up

Author: sloanster

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

@@ -31,14 +31,6 @@ It’s important to note that all custom context data remains transparent to the
 > [!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
-
-- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F). 
-- A deployed Communication Services resource. [Create a Communication Services resource](../../quickstarts/create-communication-resource.md).
-- A user access token to enable the calling client. For more information, see [Create and manage access tokens](../../quickstarts/identity/access-tokens.md).
-- Optional: Complete the quickstart to [add voice calling to your application](../../quickstarts/voice-video-calling/getting-started-with-calling.md)
-
-
 [!INCLUDE [Passing Contextual Data - Client-side JavaScript](./includes/call-context/call-context-web.md)]
 
 ## Next steps

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

@@ -5,7 +5,6 @@ ms.topic: include
 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.
@@ -18,75 +17,51 @@ The maximum length of a VOIP header key is 64 chars. The maximum length of VOIP
 
 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
-// Set up customContext
-this.callOptions.customContext = {
-    userToUser: <USER_TO_USER_VALUE>,
-    xHeaders: [
-        { key: <CUSTOM_HEADER_KEY>, value: <CUSTOM_HEADER_VALUE> },
-    ]
-};
-```
-For a "1:1" call to a user, use the following code:
-
-```js
-const userId = { communicationUserId: 'ACS_USER_ID' };
-this.currentCall = this.callAgent.startCall([userId], this.callOptions);
-```
+> [!NOTE]
+> Currently, adding custom User-to-User Information headers is only supported when initiating a 1:1 call. Passing User-to-User Information headers in group calls is not currently supported. To work around this after starting the 1:1 call, you can include additional participants while maintaining the User-to-User Information within the calls. 
 
-To place a call to a public switched telephone network (PSTN), use the `startCall` method on `callAgent` and pass the recipient's `PhoneNumberIdentifier`. Your Communication Services resource must be configured to allow PSTN calling.
 
-When you call a PSTN number, specify your alternate caller ID. An alternate caller ID is a phone number (based on the E.164 standard) that identifies the caller in a PSTN call. It's the phone number the call recipient sees for an incoming call.
+## Place a call with User-to-User Information (UUI) data
 
-For a 1:1 call to a PSTN number, use the following code:
 ```js
-const phoneNumber = { phoneNumber: <ACS_PHONE_NUMBER> };
-this.callOptions.alternateCallerId = { phoneNumber: <ALTERNATE_CALLER_ID>}
-this.currentCall = this.callAgent.startCall([phoneNumber], this.callOptions);
+// Setting custom context UUI Headers
+const callOptions = {
+    customContext: {
+        voipHeaders: [
+            {key: 'voip-key-1', value: 'voip-value-1'},
+            {key: 'voip-key-2', value: 'voip-value-2'}
+        ],
+
+        sipHeaders: [
+            {key: 'sip-key-1', value: 'sip-value-1'},
+            {key: 'sip-key-2', value: 'sip-value-2'}
+        ],
+        userToUser: 'userToUserHeader',
+    },
+};
+});
 ```
 
-> [!NOTE]
-> Passing contextual information in group call and add participant scenarios are not supported
 
-## Receive an incoming call
+## Read and parse User-to-User Information headers in a call
 
 The `callAgent` instance emits an `incomingCall` event when the logged-in identity receives an incoming call. To listen to this event and extract contextual info, subscribe by using one of these options:
 
 ```js
-const incomingCallHandler = async (args: { incomingCall: IncomingCall }) => {
+let info = '';
+ 
+callAgent.on("incomingCall", (args) => {
     const incomingCall = args.incomingCall;
-
-    // receiving customContext
-    const customContext = args.incomingCall.customContext;
-
-    // Get incoming call ID
-    var incomingCallId = incomingCall.id
-
-    // Get information about this Call. This API is provided as a preview for developers
-    // and may change based on feedback that we receive. Do not use this API in a production environment.
-    // To use this api please use 'beta' release of Azure Communication Services Calling Web SDK
-    var callInfo = incomingCall.info;
-
-    // Get information about caller
-    var callerInfo = incomingCall.callerInfo
-
-    // Accept the call
-    var call = await incomingCall.accept();
-
-    // Reject the call
-    incomingCall.reject();
-
-    // Subscribe to callEnded event and get the call end reason
-     incomingCall.on('callEnded', args => {
-        console.log(args.callEndReason);
-    });
-
-    // callEndReason is also a property of IncomingCall
-    var callEndReason = incomingCall.callEndReason;
-};
-callAgentInstance.on('incomingCall', incomingCallHandler);
-```
+    if (incomingCall.customContext) {
+        if (incomingCall.customContext.userToUser) {
+            info += `userToUser: '${incomingCall.customContext.userToUser}'\n`;
+        }
+        if (incomingCall.customContext.sipHeaders) {
+            incomingCall.customContext.sipHeaders.forEach(header => info += `sip: ${header.key}: '${header.value}'\n`);
+        }
+        if (incomingCall.customContext.voipHeaders) {
+            incomingCall.customContext.voipHeaders.forEach(header => info += `voip: ${header.key}: '${header.value}'\n`);
+        }
+    }
+});
+```