Jak dodać agenta Copilot Studio na stronę internetową (bez programowania)

Agent Copilot Studio jako czat na stronie firmy: kod osadzania z kilku linijek HTML, adres tokena z kanałów, wygląd okienka, powitanie. Kiedy to działa, a kiedy potrzebny jest pełny WebChat.
Agent z Copilot Studio nie musi żyć tylko w Teams. Można go wstawić na stronę firmy jako okienko czatu w rogu ekranu, np. do odpowiadania klientom na pytania o godziny otwarcia, cennik czy status zamówienia. Najprostszy sposób nie wymaga pisania JavaScriptu: wystarczy kilka linijek HTML.
Opis opieramy na wpisie zespołu Microsoft CAT, który pokazuje bibliotekę botframework-webchat-embed.
Warunek: agent bez logowania
Ten sposób działa tylko dla agentów bez uwierzytelniania, czyli takich, z których może korzystać każdy odwiedzający. Jeśli agent wymaga logowania kontem firmowym (Entra ID), potrzebny jest pełny WebChat i praca programisty.
Pamiętaj: agent bez logowania nie powinien mieć dostępu do danych wewnętrznych. Każdy odwiedzający stronę może zadać mu dowolne pytanie. Wiedza takiego agenta to wyłącznie informacje publiczne.
Krok 1: adres tokena
W Copilot Studio wejdź w Settings → Channels, wybierz kanał Email i skopiuj Token Endpoint. To adres, przez który strona łączy się z agentem.
Krok 2: kod na stronie
Wstaw w kodzie strony element z adresem tokena i skrypt biblioteki:
<div class="czat"
data-webchat-token-url="TU-WKLEJ-TOKEN-ENDPOINT"
data-webchat-title="Pomoc"
data-webchat-bubble-text="Napisz do nas"></div>
<script src="https://cdn.jsdelivr.net/npm/botframework-webchat-embed@latest"></script>
Skrypt sam znajdzie element i wyświetli w rogu dymek, który po kliknięciu otwiera okno czatu. Pozycję i rozmiar ustawisz w CSS, np. przyklejając okienko do prawego dolnego rogu.
W systemach typu WordPress taki kod wstawia się zwykle w bloku „Własny HTML” albo w ustawieniach motywu.
Krok 3: wygląd i zachowanie
data-webchat-title: tytuł okna,data-webchat-bubble-text: napis na dymku,- kolory: okienko korzysta ze zmiennych CSS strony, a dokładniej ustawisz je atrybutami
data-webchat-style-*, data-webchat-minimized: czy czat startuje jako dymek (domyślnie tak),data-webchat-send-start-event: uruchamia powitanie agenta (temat Conversation Start),data-webchat-mock-welcome: pokazuje powitanie w przeglądarce bez łączenia się z agentem, czyli szybciej i bez zużycia przy samym wejściu na stronę.
Na co uważać
- Koszty. Każda rozmowa z agentem zużywa kredyty Copilot. Na publicznej stronie rozmów może być dużo. Ustaw limity: piszemy o tym w artykule o kredytach w Copilot Studio.
- Wersja
@latestzawsze ładuje najnowszą wersję biblioteki. W środowisku produkcyjnym bezpieczniej wpisać konkretny numer wersji. - Biblioteka nie obsługuje sekretów Direct Line ani własnych rozszerzeń WebChat.
- RODO: jeśli czat zapisuje rozmowy, wspomnij o tym w polityce prywatności strony.
Przy obsłudze klientów warto też znać harness Customer Conversation, przeznaczony do czatu na stronie i telefonu z przekazaniem do konsultanta. Przegląd harnessów znajdziesz w artykule Microsoft Copilot harness czy standard.
Źródła i data sprawdzenia
Stan na 13 listopada 2026.
- wpisie zespołu Microsoft CAT (microsoft.github.io)
Ceny, funkcje narzędzi i przepisy mogą się zmienić po tej dacie, dlatego przy ważnych decyzjach sprawdź aktualny stan w podlinkowanym źródle. Zauważyłeś błąd? Napisz na kontakt@przejmijai.pl.


