Skip to content

Platform Concepts¶

Azure Communication Services (ACS) provides a comprehensive set of cloud-based APIs and SDKs to integrate communication into your applications. This section explores the underlying platform architecture, identity models, and infrastructure that power these services.

Platform Documentation¶

Document	Description
How ACS Works	High-level architecture, resource models, and core service components.
Resource Types	Detailed breakdown of communication resources, phone numbers, and email domains.
Messaging Channels	Comparison and technical overview of SMS, Email, and Chat channels.
Authentication and Identity	Security models including connection strings, Entra ID, and user access tokens.
Networking	Network requirements, firewall configurations, and TURN/STUN infrastructure.
SDKs and REST APIs	Language support matrix and comparison between SDK and REST API approaches.
Event Handling	Real-time event integration via Azure Event Grid and event-driven patterns.
Security Architecture	Encryption, compliance, and data residency considerations.

Concept Relationships¶

The following diagram illustrates how the various platform components interact to provide a cohesive communication experience.

graph TD
    Resource[Azure Communication Resource] --> Auth[Authentication & Identity]
    Resource --> Channels[Messaging Channels]
    Resource --> Events[Event Grid Integration]

    Auth --> Tokens[User Access Tokens]
    Auth --> ManagedIdentity[Managed Identity / Entra ID]

    Channels --> Chat[Chat]
    Channels --> SMS[SMS]
    Channels --> Email[Email]
    Channels --> Calling[Voice & Video Calling]

    Channels --> SDKs[SDKs & REST APIs]
    SDKs --> Network[Networking / Infrastructure]

    Events --> Webhooks[Webhooks / Automation]

    Security[Security Architecture] -.-> Resource
    Security -.-> Auth
    Security -.-> Network

Recommended Reading Order¶

If you are new to Azure Communication Services, it's recommended to follow this order to build a solid foundation:

How ACS Works: Understand the big picture and basic architecture.
Authentication and Identity: Learn how to secure your resources and manage users.
SDKs and REST APIs: Identify the right tools for your development environment.
Networking: Ensure your environment is ready for real-time traffic.

See Also¶

Sources¶