Skip to content

Commit ccab0af

Browse files
authored
cleaned up more
1 parent d4ded7d commit ccab0af

File tree

1 file changed

+8
-10
lines changed

1 file changed

+8
-10
lines changed

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

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Tutorial on how to pass call contextual data information using your Azure Communication Services WebJS SDK
33
titleSuffix: An Azure Communication Services tutorial document
4-
description: Provides a tutorial guide for passing contextual information using
4+
description: Provide a tutorial on how to pass contextual information using calling SDK
55
author: sloanster
66
ms.topic: tutorial
77
ms.service: azure-communication-services
@@ -12,15 +12,13 @@ services: azure-communication-services
1212

1313
# Using the ACS calling SDK to pass contextual data between calls
1414

15-
The Azure Communication Services (ACS) WebJS SDK provides the ability to allow developers to include custom contextual data (included as a header on the calllin object) when directing and routing calls from one person to another. This functionality allows for the inclusion of metadata related to the call, the recipient, or any other pertinent information that aligns with the application’s needs or the company’s operational logic.
15+
The Azure Communication Services (ACS) WebJS SDK provide the ability to allow developers to include custom contextual data (included as a header on the calllin object) when directing and routing calls from one person to another. This functionality allows for the inclusion of metadata related to the call, the recipient, or any other pertinent information that aligns with the application’s needs or the company’s operational logic.
1616

17-
To pass this context, developers can utilize custom headers, which are a set of optional key-value pairs. These pairs can be incorporated into the 'AddParticipant' or 'Transfer' actions within the calling SDK. After this Content has been added you can. access this. payload. through Apis to inspect his context can be accessed as part of the payload for the IncomingCall event. By using the ability to look up metadata quickly and have it be associated with a call developers can eliminate additional external database lookups and instead have content information be available within the call object.
17+
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.
1818

19-
Moreover, the custom call context is also transmitted to 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.
20-
21-
It’s important to note that all custom context data remains transparent to the calling SDK and is not related to any of the SDK’s fundamental functions when used in SIP protocols.
22-
Below are tutorials to assist you in implementing custom context headers with the WebJS SDK.
19+
Moreover, the custom call context can also also transmitted to to SIP endpoings using 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.
2320

21+
It’s important to note that all custom context data remains transparent to the calling SDK and is not related to any of the SDK’s fundamental functions when used in SIP protocols. Here is a tutorial to assist you in implementing custom context headers using the WebJS SDK.
2422

2523
## Technical parameters
2624
The calling SDK support 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.
@@ -31,10 +29,10 @@ The maximum length of a VOIP header key is 64 chars. These headers can be sent w
3129

3230
## Adding custom context when inviting a participant
3331

34-
### Setting custom context headings using the WebJS calling SDK
32+
### Adding custom context headings using the WebJS calling SDK
3533

3634
```js
37-
35+
3836
const callOptions = {
3937
customContext: {
4038
voipHeaders: [
@@ -85,4 +83,4 @@ The maximum length of a VOIP header key is 64 chars. These headers can be sent w
8583

8684
- For more details on how to pass contextual data using ACS Call automation see this [guide](../../../how-tos/call-automation/custom-context.md).
8785

88-
- Learn more about [SIP protocol details for direct routing](../../concepts/telephony/direct-routing-sip-specification.md).
86+
- Learn more about [SIP protocol details for direct routing](../../../concepts/telephony/direct-routing-sip-specification.md).

0 commit comments

Comments
 (0)