How to enable the web app channel

(2) Share

Report

Posted on by EB-26052229-0 Microsoft Employee

Hello, I'm trying to call my copilot studio agent from an internal home-grown html-based web app that I created using GitHub Copilot, however, authentication fails because the web app channel is disabled. The agent was built in a personal development environment. Is there a way to enable the web app channel or an alternative method to integrate the agent with a personal app?

Categories:

Calling actions from Copilot Studio

I have the same question (0)

All responses (2)

Answers (0)

Sort by

Suggested answer

11manish 2,467 on at

Like (0)

Report
Copy link

Link copied!
Yes — the issue is not with your HTML app. The limitation comes from the type of environment where the Microsoft Copilot Studio agent was created.

In a personal developer/trial environment, the Web app (Custom website) channel is often unavailable or restricted. Because of that:

Direct Line authentication cannot be generated properly

External embedding fails

Custom HTML applications cannot authenticate against the agent

So this behavior is expected in many personal/dev tenants.

best solution is to move the agent to a Sandbox environment with Dataverse enabled and proper Copilot Studio licensing.

Was this reply helpful? Yes No
Suggested answer

Valantis 5,578 on at

Like (1)

Report
Copy link

Link copied!

Hi @EB-26052229-0,

The authentication failure when embedding in a custom web app is most likely caused by the authentication settings, not the environment type.

Microsoft docs confirm: to use the Embed code for the web app in Copilot Studio, set your security authentication options to No authentication. Go to Settings > Security > Authentication and select No authentication to make it publicly available.

If you need authentication (for an internal app), the correct approach is:

1. Go to Channels > Mobile app in Copilot Studio
2. Copy the Token Endpoint
3. In your HTML app, make a GET request to that token endpoint to get a Direct Line token
4. Use that token to authenticate the webchat control

Also check: Settings > Security > Web channel security. If Require secured access is turned on, your HTML app needs to pass a Direct Line secret or token with every request. The secret is visible in the Custom website channel settings.

The personal development environment limitation 11manish mentioned is real but only applies to Teams-only licenses which can't generate secrets for secure access. If you have a standard Copilot Studio license the web channel should work.

Ref: https://learn.microsoft.com/en-us/microsoft-copilot-studio/configure-web-security

Ref: https://learn.microsoft.com/en-us/microsoft-copilot-studio/publication-connect-bot-to-custom-application

Best regards,

Valantis

✅ If this helped solve your issue, please Accept as Solution so others can find it quickly.

❤️ If it didn’t fully solve it but was still useful, please click “Yes” on “Was this reply helpful?” or leave a Like :).

🏷️ For follow-ups @Valantis.

📝 https://valantisond365.com/

💼 LinkedIn

▶️ YouTube

Was this reply helpful? Yes No