Skip to content

Commit 709bc18

Browse files
authored
Update sample-builder.md
updating for acrolinx
1 parent ddacf54 commit 709bc18

File tree

1 file changed

+23
-22
lines changed

1 file changed

+23
-22
lines changed

articles/communication-services/tutorials/virtual-visits/sample-builder.md

Lines changed: 23 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ ms.subservice: calling
1414

1515
# Sample Builder
1616

17-
The Azure Communication Services Sample Builder is a no-code tool designed to help teams rapidly launch virtual appointment experiences—without needing to write custom code. Whether you're running a healthcare clinic, financial consultation, or support center, the sample builder lets you prototype, customize, and deploy real-time customer interactions that can integrate directly with Microsoft Teams and Bookings.
17+
The Azure Communication Services Sample Builder is a no-code tool designed to help teams rapidly launch virtual appointment experiences—without needing to write custom code. Whether you're running a healthcare clinic, financial consultation, or support center, the sample builder lets you prototype, customize, and deploy. These samples can integrate directly with Microsoft Teams and Bookings.
1818

1919
👉 **Launch the Sample Builder**: [Go to the Sample Builder](https://ms.portal.azure.com/#view/Microsoft_Azure_VirtualVisitsBuilder/SampleBuilder.ReactView)
2020

@@ -36,6 +36,7 @@ The Sample Builder can help:
3636

3737
### How It Works
3838
This sample is built on top of Azure Communication Services UI components and composites, providing a robust, accessible, and consistent user interface out of the box. It serves as both a deployment tool and a reference architecture for best practices in communication-driven experiences.
39+
3940
The Sample Builder creates a hybrid virtual visit solution by integrating:
4041
- Microsoft 365 services such as Bookings and Microsoft Teams (for scheduling and provider-side meetings)
4142
- Azure services such as Azure Communication Services, App Service, and optional Azure Monitor (for web experience, analytics, and real-time communication)
@@ -54,7 +55,7 @@ Virtual Appointment Flow (Using Microsoft Bookings):
5455
This architecture ensures that providers can join virtual appointments using Microsoft Teams. In the same call, consumers can access a fully branded, browser-based experience—no Teams account required.
5556

5657
### What You Get
57-
Once the tutorial and Sample Builder have been completed, the Sample Builder provides:
58+
Upon deployment, the Sample Builder provides:
5859
- A fully deployed Azure web app
5960
- Microsoft Teams meeting integration
6061
- Custom UI implementation powered by Azure Communication Services composites
@@ -70,14 +71,14 @@ The following tutorial goes into more depth on how you can set this up.
7071

7172

7273

73-
## Tutorial: Building a Virtual Appointment Sample
74+
# Tutorial: Building a Virtual Appointment Sample
7475
In this section, we're going to use a Sample Builder tool to deploy a Microsoft 365 + Azure hybrid virtual appointments application to an Azure subscription. This application is a desktop and mobile-friendly browser experience, with code that you can use to explore and make the final product.
7576

76-
### Step 0: Configure Microsoft 365 Bookings (Optional)
77+
## Step 0: Configure Microsoft 365 Bookings (Optional)
7778

78-
The Sample builder provides an option to configure the sample using M365 Bookings. This allows the bookings app to power the consumer scheduling experience and create meetings for providers.
79+
The Sample builder provides an option to configure the sample using Microsoft 365 Bookings. This functionality allows the bookings app to power the consumer scheduling experience and create meetings for providers.
7980

80-
**If you don't want to use bookings, feel free to skip this step**. This is optional when creating a sample as you can select Rooms instead.
81+
**If you don't want to use bookings, feel free to skip this step**. This step is optional when creating a sample as you can select Rooms instead.
8182

8283
If you do want to use Bookings, create a Bookings calendar and get the Booking page URL from https://outlook.office.com/bookings/calendar.
8384

@@ -94,17 +95,17 @@ And then, make sure "Add online meeting" is enabled.
9495

9596

9697

97-
### Step 1: Creating a Sample in the Builder
98+
## Step 1: Creating a Sample in the Builder
9899

99-
#### Prerequisites
100+
### Prerequisites
100101
To use the Sample Builder, you need:
101102
- An active Azure subscription
102103
- Admin permissions to deploy resources in Azure
103104
- Access to Microsoft Bookings (if you plan to enable scheduling integration)
104105

105106
**Launch the Sample Builder**: 👉 [Sample Builder](https://ms.portal.azure.com/#view/Microsoft_Azure_VirtualVisitsBuilder/SampleBuilder.ReactView)
106107

107-
You can also navigate to the page within the Azure Communication Services resource in the Azure Portal. If you’re planning to integrate with Microsoft Bookings, skip ahead to Using with Microsoft Bookings to learn how the app connects with scheduling workflows. Return to this step upon setup.
108+
You can also navigate to the page within the Azure Communication Services resource in the Azure portal. If you’re planning to integrate with Microsoft Bookings, skip ahead to Using with Microsoft Bookings to learn how the app connects with scheduling workflows. Return to this step upon setup.
108109

109110
**Follow the step-by-step wizard.**
110111

@@ -114,15 +115,15 @@ You can also navigate to the page within the Azure Communication Services resou
114115
4. Select and customize the Post-Call experience
115116
5. Preview your configuration live, including your brand colors and features available
116117

117-
As you progress through the wizard, click through different setting to see what functionality is available. Different setups provide different features, experiences, and options.
118+
As you progress through the wizard, select through different setting to see what functionality is available. Different setups provide different features, experiences, and options.
118119

119-
[ ![Screenshot of Sample builder start page.](../media/virtual-visits/sample-builder-themes-4.25.png)](../media/virtual-visits/sample-builder-themes-4.25.png#lightbox)
120+
[![Screenshot of Sample builder start page.](../media/virtual-visits/sample-builder-themes-4.25.png)](../media/virtual-visits/sample-builder-themes-4.25.png#lightbox)
120121

121122

122-
### Step 2: Deploy
123-
At the end of the Sample Builder wizard, you are met with three options. You can deploy to Azure, download the code as a zip, or clone to Github. The sample builder code is publicly available on [GitHub](https://github.com/Azure-Samples/communication-services-virtual-visits-js).
123+
## Step 2: Deploy
124+
At the end of the Sample Builder wizard, you're met with three options. You can deploy to Azure, download the code as a zip, or clone to GitHub. The sample builder code is publicly available on [GitHub](https://github.com/Azure-Samples/communication-services-virtual-visits-js).
124125

125-
[ ![Screenshot of Sample builder deployment page.](../media/virtual-visits/sample-builder-landing-4.25.png)](../media/virtual-visits/sample-builder-landing-4.25.png#lightbox)
126+
[![Screenshot of Sample builder deployment page.](../media/virtual-visits/sample-builder-landing-4.25.png)](../media/virtual-visits/sample-builder-landing-4.25.png#lightbox)
126127

127128
The easiest method to get a working sample is to **Deploy to Azure**. Deployment launches an Azure Resource Manager (ARM) template that deploys the themed application you configured.
128129

@@ -132,7 +133,7 @@ After walking through the ARM template, you can **Go to resource group**.
132133

133134
![Screenshot of a completed Azure Resource Manager Template.](../media/virtual-visits/azure-complete-deployment-4.25.png)
134135

135-
### Step 3: Test
136+
## Step 3: Test
136137
The Sample Builder creates three resources in the selected Azure subscriptions. The **App Service** is the consumer front end, powered by Azure Communication Services.
137138

138139
![Screenshot of produced azure resources in azure portal.](../media/virtual-visits/azure-resources-4.25.png)
@@ -141,27 +142,27 @@ Opening the App Service's URL and navigating to `https://<YOUR URL>/VISIT` allow
141142

142143
![Screenshot of final view of azure app service.](../media/virtual-visits/azure-resource-final-4.25.png)
143144

144-
### Step 4: Set deployed app URL in Bookings
145+
## Step 4: Set deployed app URL in Bookings
145146

146147
If using Bookings, enter the application URL followed by "/visit" in the "Deployed App URL" field at https://outlook.office.com/bookings/businessinformation. Otherwise, ignore this step.
147148

148-
## Going to production
149-
Congrats! You've deployed a custom sample. As you transition to production, consider the following
149+
# Further Actions
150+
Congrats! You deployed a custom sample. As you try it out, consider the following
150151

151152
### Launching patterns
152-
Consumers often want to join their virtual appointment directly from the reminders sent by Bookings. To support this, Bookings lets you specify a URL prefix that will be included in those reminders. For example, if your prefix is `https://<YOUR URL>/visit`, the reminders will direct users to `https://<YOUR URL>/visit?MEETINGURL=<MEETING URL>`.
153+
Consumers often want to join their virtual appointment directly from the reminders sent by Bookings. To support this functionality, Bookings allows to you specify a URL prefix that is included in those reminders. For example, if your prefix is https://<YOUR URL>/visit, the reminders directs users to https://<YOUR URL>/visit?MEETINGURL=<MEETING URL>.
153154

154155
### Integrate into your existing app
155156
The app service generated by the Sample Builder is a standalone experience optimized for desktop and mobile browsers. If you already have an existing website or mobile app, you can adapt the provided code to fit into your current codebase.
156157

157158
For more flexibility and customization, consider using:
158-
- **UI SDKs**[Prebuilt, production-ready web and mobile UI components](../../concepts/ui-library/ui-library-overview.md) that allow you to match your existing look and feel.
159+
- **UI SDKs**[Prebuilt, production-ready web and mobile UI components](../../concepts/ui-library/ui-library-overview.md) that allow you to match your existing look and feel. The sample builder is built on top of our customizable composite. Read here to learn more
159160
- **Core SDKs** – Access the underlying [Calling](../../quickstarts/voice-video-calling/get-started-teams-interop.md) and [Chat](../../quickstarts/chat/meeting-interop.md) services directly to build fully custom experiences.
160161

161162
### Identity & security
162-
The sample app issues ACS access tokens without user authentication. In production, implement secure user auth (e.g., Azure AD B2C). [Azure Communication Services user access tokens](../../quickstarts/identity/access-tokens.md)
163+
The sample app issues ACS access tokens without user authentication. In production, implement secure user auth. [Azure Communication Services user access tokens](../../quickstarts/identity/access-tokens.md)
163164

164-
## Next steps
165+
# Next steps
165166
- [Overview of virtual appointments](../../concepts/interop/virtual-visits/overview.md)
166167
- [Learn about Teams controls](../../concepts/interop/guest/teams-administration.md).
167168
- [Govern user experience in Teams meetings](../../concepts/interop/virtual-visits/govern-meeting-experience.md)

0 commit comments

Comments
 (0)