> ## Documentation Index > Fetch the complete documentation index at: https://hobbyist-e43fa225.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Publish and share a voice-based agent > Share a voice-based agent through a preview web app or phone-number channel and understand the available publishing paths. This article explains how the voice-based channels experience differs from standard agent application and Microsoft Teams app publishing. In the Foundry portal, use the voice-based **Channels** tab to share a browser preview or connect a phone number. ## Prerequisites * A saved and tested voice-based agent. * A selected agent version for customer testing. * Permission to view and manage the agent. * Application Insights if you want to monitor the shared experience. ## Understand the available paths The following table summarizes the available publishing paths for voice-based agents. | Path | Use it for | Current voice-based behavior | | --------------------------------------------------- | ---------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | | Playground | Developer testing with microphone, transcript, and avatar. | Available from the build page. | | Preview web app | Browser-based sharing with people who have access. | Shown in the voice-based **Channels** tab when the endpoint supports the Responses protocol. | | Phone numbers | Audio-only inbound calls. | Microsoft Teams Phone Extensibility and Twilio. | | Standard Teams and Microsoft 365 Copilot publishing | A Teams or Microsoft 365 app backed by the agent. | The standard card is intentionally hidden from the current voice-based Channels layout. Don't use these steps as a substitute for Teams Phone integration. | | Agent Application | A stable managed endpoint with a dedicated identity. | General Agent Application guidance might not represent the current native voice media path. Verify support before documenting or releasing this route. | "Publish to Microsoft Teams" and "connect a Microsoft Teams phone number" are different integrations. App publishing distributes a bot or agent app. Teams Phone Extensibility routes a telephone call through Azure Communication Services to the voice agent. ## Open the Channels tab In the Microsoft Foundry portal: 1. Select **Build** > **Agents**. 2. Select the voice-based agent. 3. Open **Channels**. The current voice-based layout contains: * **Phone numbers**. * **Preview web app**. The layout doesn't show the Routines card used by some text agents. ## Share the preview web app The preview web app is available when the agent endpoint supports the Responses protocol. ### Open the web app 1. In **Preview web app**, select **Open web app**. 2. Complete a voice scenario in the new browser tab. 3. Confirm microphone permissions, session startup, transcript, voice output, and avatar behavior. ### Copy the web app link 1. Select **Copy web app link**. 2. Share the link only with the intended audience. 3. Tell recipients which organizational account to use. 4. Confirm they have access. ### Grant access When **Grant access** is available: 1. Open the card's actions menu. 2. Select **Grant access**. 3. Add the approved users or groups. 4. Review the access scope. 5. Ask a recipient to validate the link with their own account. The card identifies the experience as available to people in the organization. Don't treat possession of the link as authorization. ## Connect a phone number channel In **Phone numbers**, select **Add a number** and follow [Integrate telephony channels with a voice agent](/agents/voice-agent-telephony-channels). After you connect a Microsoft Teams number, the **Publish** menu can offer **Call preview agent**. The dialog currently lists active Microsoft Teams phone-number bindings and provides a link back to the **Channels** tab when you need another number. Test Twilio numbers by calling them directly. ## Choose a release version Treat the agent configuration like application code: 1. Save a version after completing configuration. 2. Test that exact version in the playground. 3. Test the preview web app. 4. Test each phone number. 5. Record the version used by the customer channel. 6. Repeat regression tests before changing the active version. Don't point a customer channel at unsaved changes. Avoid automatically adopting every new version unless that change is an explicit release policy. ## Identity and access considerations * Project collaborators can have broader access than preview-web-app users. * Tool authentication can behave differently after a general Agent Application is published because the published application receives a distinct identity. * Permissions assigned to the project identity don't automatically transfer to a separately published application identity. * Phone-number provisioning uses the Foundry project and Azure Communication Services setup described in the telephony article. * Use least-privilege roles for tools, data, Application Insights, ACS, Event Grid, and app registrations. ## Validate a shared experience For each channel, test: * Authentication and authorization. * Microphone and audio behavior. * The greeting and AI disclosure. * Recognition and turn-taking. * Tool and knowledge calls. * Human handoff. * Session end and reconnect behavior. * Monitoring and trace creation. * Behavior when a downstream dependency is unavailable. ## Troubleshoot channels | Symptom | What to check | | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | | Preview web app controls are disabled | Confirm the endpoint supports the Responses protocol and the agent has a valid preview URL. | | A recipient can't open the web app | Confirm organizational sign-in, granted access, tenant, and browser policy. | | The voice-based Channels layout doesn't appear | Confirm the agent was created with Voice interaction mode and the preview is available in the project. | | The expected Teams publishing card isn't shown | This card is intentionally missing in the current voice-based layout. Use the phone-number article for Teams Phone Extensibility. | | **Call preview agent** has no numbers | Add a number in **Channels > Phone numbers**, or verify that the telephony binding is active. | ## Related content * [Integrate a telephony channel](/agents/voice-agent-telephony-channels) * [Voice agent tracing, monitoring, and evaluation](/agents/voice-agent-observability). * [Publish an Agent Application](https://learn.microsoft.com/azure/foundry/agents/how-to/agent-applications) * [Publish agents to Microsoft 365 Copilot and Microsoft Teams](https://learn.microsoft.com/azure/foundry/agents/how-to/publish-copilot)