Skip to content

Commit aa5e825

Browse files
authored
Update sample-builder.md
Updates to grammar, text
1 parent 6efa1b6 commit aa5e825

File tree

1 file changed

+32
-23
lines changed

1 file changed

+32
-23
lines changed

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

Lines changed: 32 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -14,17 +14,23 @@ 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, it 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 real-time customer interactions that 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

21-
This tutorial describes concepts for virtual appointment applications. After completing this tutorial and using associated Sample Builder, you will understand common use cases that a virtual appointments application delivers, the Microsoft technologies that can help you build those uses cases, and have built a sample application integrating Microsoft 365 and Azure that you can use to demo and explore further. You can learn more concepts about virtual appointments in the [overview](../../concepts/interop/virtual-visits/overview.md).
21+
This tutorial introduces key concepts for building virtual appointment applications. After completing this tutorial and using the Sample Builder, you will:
22+
23+
- Understand common use cases for virtual appointments
24+
- Explore Microsoft technologies that support these scenarios
25+
- Deploy a working sample application that integrates Microsoft 365 and Azure
26+
27+
Learn more foundational concepts in the virtual appointments [overview](../../concepts/interop/virtual-visits/overview.md).
2228

2329
### Capabilities
2430
The Sample Builder can help:
2531
- **Deploy a working virtual visit experience in minute**s—minimal code required
26-
- **Try new features early**—test UI capabilities that haven’t fully entered the Azure Communications Services UI library
27-
- **Customize the consumer experience** with a prebuilt user interface, optional pre-call survey, post-call survey, waiting room, and more
32+
- **Try new features early**—test UI capabilities that ahead of release
33+
- **Customize the consumer experience** with by altering prebuilt user interface, post-call surveys, and more
2834
- **Integrate with Microsoft Bookings** to support scheduling workflows
2935
- **Launch Microsoft Teams meetings** using Azure Communication Services and enable guest access via the web app
3036

@@ -37,17 +43,18 @@ The Sample Builder creates a hybrid virtual visit solution by integrating:
3743
The following diagram shows the user steps for a virtual appointment (using Microsoft Booking):
3844
![High-level architecture of a hybrid virtual appointments solution.](../media/virtual-visits/virtual-visit-arch.svg)
3945

40-
For this Virtual Appointments scenario using Microsoft Bookings, this chart showcases:
41-
1. Consumer schedules the appointment using Microsoft 365 Bookings.
42-
2. Consumer gets an appointment reminder through SMS and Email.
43-
3. Provider joins the appointment using Microsoft Teams.
44-
4. Consumer uses a link from the Bookings reminders to launch the Contoso consumer app and join the underlying Teams meeting.
45-
5. The users communicate with each other using voice, video, and text chat in a meeting.
46+
Virtual Appointment Flow (Using Microsoft Bookings):
4647

47-
This architecture ensures that providers can join virtual appointments using Microsoft Teams and that Consumers can access a fully branded, browser-based experience—no Teams account required.
48+
1. Consumer schedules the appointment using Microsoft 365 Bookings
49+
2. Consumer receives reminders via SMS and email
50+
3. Provider joins via Microsoft Teams
51+
4. Consumer uses a link from the reminder to launch the Contoso app and join the Teams meeting
52+
5. Both users interact via video, voice, and chat
53+
54+
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.
4855

4956
### What You Get
50-
Once the tutorial and Sample Builder have been completed, the Sample Builder will provide:
57+
Once the tutorial and Sample Builder have been completed, the Sample Builder provides:
5158
- A fully deployed Azure web app
5259
- Microsoft Teams meeting integration
5360
- Custom UI implementation powered by Azure Communication Services composites
@@ -59,7 +66,7 @@ After deployment, you can immediately test the deployed sample by visiting these
5966
- `https://your-app-url>/visit` to simulate a consumer joining the appointment
6067
- `https://<your-app-url>/book` to access the embedded booking interface
6168

62-
The following tutorial will go into more depth on how you can set this up.
69+
The following tutorial goes into more depth on how you can set this up.
6370

6471

6572

@@ -90,7 +97,7 @@ And then, make sure "Add online meeting" is enabled.
9097
## Step 1: Creating a Sample in the Builder
9198

9299
### Prerequisites
93-
To use the Sample Builder, you’ll need:
100+
To use the Sample Builder, you need:
94101
- An active Azure subscription
95102
- Admin permissions to deploy resources in Azure
96103
- Access to Microsoft Bookings (if you plan to enable scheduling integration)
@@ -103,17 +110,17 @@ You can also navigate to the page within the Azure Communication Services resou
103110

104111
1. Choose an industry scenario (Template)
105112
2. Choose a scheduling method (Bookings or Rooms)
106-
3. Customize the theme, colors, banners and add any logos
113+
3. Customize the theme, colors, banners, and add any logos
107114
4. Select and customize the Post-Call experience
108115
5. Preview your configuration live, including your brand colors and features available
109116

110-
As you progress through the wizard, click through different setting to see what functionality is available. Different setups will provide different features, experiences, and options.
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.
111118

112119
[ ![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)
113120

114121

115122
## Step 2: Deploy
116-
At the end of the Sample Builder wizard, you are met with 3 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+
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).
117124

118125
[ ![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)
119126

@@ -139,18 +146,20 @@ Opening the App Service's URL and navigating to `https://<YOUR URL>/VISIT` allow
139146
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.
140147

141148
# Going to production
142-
Congrats! You have deplyed the a customer sample! The Sample Builder gives you the basics of a Microsoft 365 and Azure virtual appointment: consumer scheduling via Bookings, consumer joining via a custom app, and the provider joining via Teams. However, several things to consider as you take this scenario to production.
149+
Congrats! You've deployed a custom sample. As you transition to production, consider the following
143150

144151
### Launching patterns
145-
Consumers want to jump directly to the virtual appointment from the scheduling reminders they receive from Bookings. In Bookings, you can provide a URL prefix that is used in reminders. If your prefix is `https://<YOUR URL>/VISIT`, Bookings will point users to `https://<YOUR URL>/VISIT?MEETINGURL=<MEETING URL>.`
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>.
146153

147154
### Integrate into your existing app
148-
The app service generated by the Sample Builder is a stand-alone artifact designed for desktop and mobile browsers. However, you may already have a website or mobile application and need to migrate these experiences to the existing codebase. The code generated by the Sample Builder should help, but you can also use the following:
149-
- **UI SDKs –** [Production Ready Web and Mobile](../../concepts/ui-library/ui-library-overview.md) components to build graphical applications.
150-
- **Core SDKs –** The underlying [Call](../../quickstarts/voice-video-calling/get-started-teams-interop.md) and [Chat](../../quickstarts/chat/meeting-interop.md) services can be accessed, and you can build any kind of user experience.
155+
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.
156+
157+
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+
- **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.
151160

152161
### Identity & security
153-
The Sample Builder's consumer experience doesn't authenticate the end user but provides [Azure Communication Services user access tokens](../../quickstarts/identity/access-tokens.md) to any random visitor. In most scenarios you want to implement an authentication scheme.
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)
154163

155164
# Next steps
156165
- [Overview of virtual appointments](../../concepts/interop/virtual-visits/overview.md)

0 commit comments

Comments
 (0)