Skip to content

Commit 7021954

Browse files
authored
Updates
1 parent 35369c2 commit 7021954

File tree

1 file changed

+7
-7
lines changed

1 file changed

+7
-7
lines changed

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

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -12,13 +12,13 @@ services: azure-communication-services
1212

1313
# Using the ACS calling SDK to pass contextual User-to-User Information (UUI) data between calls
1414

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 informaiton, 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 This UUI data is opaque to SIP and its
15+
The Azure Communication Services (ACS) WebJS SDK provides developers to include custom contextual data (included as a header on the callling 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.
1616

1717
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 can also also transmitted to to SIP endpoints 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.
19+
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.
2020

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 adding custom context headers when using the WebJS SDK.
21+
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.
2222

2323

2424
> [!IMPORTANT]
@@ -27,15 +27,15 @@ It’s important to note that all custom context data remains transparent to the
2727
## Technical parameters
2828
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.
2929

30-
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 ‘X-MS-Custom-’ prefix (which can be seeing if you insspect the SIP header with packet inspector).
30+
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).
3131

3232
The SIP header key may consist of alphanumeric characters and a few selected symbols which includes `.`, `!`, `%`, `*`, `_`, `+`, `~`, `-`. 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 includes `=`, `;`, `.`, `!`, `%`, `*`, `_`, `+`, `~`, `-`.
3333

3434
The maximum length of a VOIP header key is 64 chars. The maximum length of VOIP header value is 1024 chars.
3535

3636
When adding these custom headers as a developer you can choose to add only SIP headers, only VoIP headers or both can be included.
3737

38-
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. To support adding these headers, you must begin with a 1:1 call where the additional headers are available at the start of the initiation process.
38+
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.
3939

4040
## Adding custom context when inviting a participant
4141

@@ -84,8 +84,8 @@ Currently, adding custom User-to-User Information headers is only supported when
8484

8585
```
8686

87-
## Additional resources
87+
## More resources
8888

89-
- For more details on how to pass contextual data using ACS Call automation see this [guide](../../../how-tos/call-automation/custom-context.md).
89+
- For more details on how to pass contextual data using Azure Communication Services Call automation, see this [guide](../../../how-tos/call-automation/custom-context.md).
9090

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

0 commit comments

Comments
 (0)