Azure Communication Services are cloud-based services with REST APIs and client library SDKs to help you integrate communication into your applications. You can add communication features to your applications without being an expert in communication technologies such as media encoding and real-time networking.
Find here:
- SDKs - Links to client libraries
- Release Notes - Collated release notes for the service and SDKs
- Roadmap - Priorities for current and future service development
This repo is not open to contributions, though many of the linked SDKs are open-source and allow contributions.
Conceptual Documentation, Quickstarts, Samples, and Help
Conceptual docs and quickstarts are at docs.microsoft.com. Samples are listed on a dedicated samples page. To ask questions or get help, please check out these resources.
Azure Communication Services capabilities are conceptually organized into eight areas. Most areas have fully open-sourced SDKs programmed against published REST APIs that you can use directly over the Internet. Development of Web-based Calling and Chat applications can be accelerated by Azure Communication Services UI libraries. The UI library provides production-ready UI components that you can drop into your applications.
Communication Services APIs are documented alongside other Azure REST APIs in docs.microsoft.com. This documentation will tell you how to structure your HTTP messages and offers guidance for using Postman. REST interface documentation is also offered in Swagger format on GitHub.
| Assembly | Capabilities |
|---|---|
| Azure Resource Manager | Provision and manage Communication Services resources |
| Common | Provides base types for other SDKs |
| Identity | Manage users, access tokens |
| Phone numbers | Acquire and manage phone numbers |
| SMS | Send and receive SMS messages |
| Chat | Add real-time text based chat to your applications |
| Calling | Voice, video, screen-sharing, and other real-time communication |
| Calling Server | Make and manage calls, play audio, and configure recording |
| Network Traversal | Access TURN servers for low-level data transport |
| UI Library | Production-ready UI components for chat and calling apps |
Publishing locations for individual SDK packages are detailed below.
| Area | JavaScript | .NET | Python | Java SE | iOS | Android | Other |
|---|---|---|---|---|---|---|---|
| Azure Resource Manager | npm | NuGet | PyPi | Maven | - | - | Go via GitHub |
| Common | npm | NuGet | N/A | Maven | GitHub | Maven | - |
| Identity | npm | NuGet | PyPi | Maven | - | - | - |
| Phone Numbers | npm | NuGet | PyPi | Maven | - | - | - |
| Chat | npm | NuGet | PyPi | Maven | GitHub | Maven | - |
| SMS | npm | NuGet | PyPi | Maven | - | - | - |
| Calling | npm | NuGet | - | - | GitHub | Maven | - |
| Call Automation | nuget | Maven | |||||
| Network Traversal | npm | nuget | |||||
| UI Library | npm | - | - | - | - | - | GitHub, Storybook |
| Reference Documentation | docs | docs | - | docs | docs | docs | - |
Release notes are available directly in the publishing location (e.g. nuget) for SDKs. However every two weeks we aggregate release notes including services changes (e.g. new Azure Portal pages) in this repo.
- 3/22/2021 - 4/4/2021 - General availability of the service. Most SDKs have updated 1.0.0 versions with breaking changes.
- 4/4/2021 - 4/18/2021 - Calling iOS and Android SDKs updated with bug fixes and a small number of breaking changes. Calling JavaScript updated with bug fixes. Chat Python SDK GA version released.
- 4/18/2021 - 5/2/2021 - Calling iOS and Android SDKs are generally available and stable. Phone Numbers is also generally availability with stable SDKs for .NET, JS, Java, and Python.
- 5/2/2021 - 5/16/2021 - Initial release of Azure Communication Services Windows Calling SDK in public preview (v1.0.0-beta.1). Chat (.NET) and SMS (Java) version 1.0.1 has been published with minor bug fixes.
- 5/16/2021 - 5/31/2021 - Calling JS & Windows SDK libraries updated with minor bug fixes and Common Library Java package small fixes.
- 6/1/2021 - 6/14/2021 - Calling Android & iOS libraries updated with version V1.1.0 beta-1 version with CallKit support (iOS) and minor bug fixes.
- 6/15/2021 - 6/28/2021 - Azure Portal supports the ability to move resources to different subscriptions and resource groups. Updated Android Chat & Common libraries, and Calling JS library.
- 6/28/2021 - 7/12/2021 - Calling Android v1.1.0 SDK release with the ability to dispose of
CallAgentandCallAgentoptimizing the memory. - 7/12/2021 - 7/26/2021 - The Chat SDK for iOS is now Generally Available. Recording and Transcription features were added to allow call recording and transcription. Azure Portal adds UI updates into the Direct Routing (preview) blade and configuration, also incorporate the ability to quickly create identities and tokens to use in samples and troubleshooting scenarios.
- 7/27/2021 - 8/9/2021 - The Chat SDK release improvements into the Android, Java, JS & Python packages. Azure Portal UI enhancements into the Direct Routing blade. Calling Android SDK optimize memory consumption.
- 8/10/2021 - 8/23/2021 - The JS Calling SDK releases improvements: TURN releases beta version for Python and Java libraries. Azure Portal incorporates enhancements over Direct Routing blade and minor UI changes.
In many cases we maintain a perpetual changelog at a library level which is linked below.
| Area | JavaScript | .NET | Python | Java SE | iOS | Android | Other |
|---|---|---|---|---|---|---|---|
| Azure Resource Manager | [link] | [link] | |||||
| Common | [link] | [link] | [link] | [link] | [link] | ||
| Identity | [link] | [link] | [link] | [link] | |||
| Phone Numbers | [link] | [link] | [link] | ||||
| Chat | [link] | [link] | [link] | [link] | [link] | [link] | |
| SMS | [link] | [link] | [link] | [link] | |||
| Calling | [link] | [link] | [link] | [link] | |||
| TURN (Network Traversal) | [link] | [link] |
Our roadmap communicates features currently in development (private preview) and on-going priorities for extending the scope of Azure Communication Services. It will continue to evolve based on market changes and customer feedback, so please note that the plans outlined here are not exhaustive or guaranteed. We welcome your feedback on the roadmap.
A project view of the roadmap is also available here. Major updates to Azure Communication Services and other Azure services are available at https://azure.microsoft.com/updates/.
We appreciate your feedback and energy helping us improve our services. If you've tried the service, please give us feedback through this survey.
If you'd like to submit feature requests please submit them to our board on Azure UserVoice.