# Як додати агента Copilot Studio на сайт (без програмування)

> Агент Copilot Studio як чат на сайті компанії: код вбудовування з кількох рядків HTML, адреса токена з каналів, вигляд вікна, привітання. Коли це працює, а коли потрібен повний WebChat.

Джерело: https://przejmijai.pl/uk/artykuly/copilot-studio-agent-na-stronie-www
Оновлено: 13 листопада 2026 р.
Автор: PrzejmijAI (przejmijai.pl)

Агент із Copilot Studio не мусить жити лише в Teams. Його можна вставити на сайт компанії як віконце чату в кутку екрана, напр. щоб відповідати клієнтам на запитання про години роботи, ціни чи статус замовлення. Найпростіший спосіб не вимагає писати JavaScript: досить кількох рядків HTML.

Опис ґрунтується на [дописі команди Microsoft CAT](https://microsoft.github.io/mcscatblog/posts/webchat-embed-zero-javascript/), який показує бібліотеку `botframework-webchat-embed`.

## Умова: агент без входу

Цей спосіб працює лише для агентів **без автентифікації**, тобто таких, якими може користуватися кожен відвідувач. Якщо агент вимагає входу корпоративним обліковим записом (Entra ID), потрібен повний WebChat і робота програміста.

Пам’ятайте: агент без входу **не повинен мати доступу до внутрішніх даних**. Кожен відвідувач сайту може поставити йому будь-яке запитання. Знання такого агента це виключно публічна інформація.

## Крок 1: адреса токена

У Copilot Studio перейдіть у **Settings → Channels**, виберіть канал **Email** і скопіюйте **Token Endpoint**. Це адреса, через яку сайт з’єднується з агентом.

## Крок 2: код на сайті

Вставте в код сторінки елемент з адресою токена й скрипт бібліотеки:

```html
<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>
```

(«TU-WKLEJ-TOKEN-ENDPOINT» означає «сюди вставте Token Endpoint», «Pomoc» це «Допомога», «Napisz do nas» це «Напишіть нам».) Скрипт сам знайде елемент і покаже в кутку бульбашку, яка після натискання відкриває вікно чату. Положення й розмір ви налаштуєте в CSS, напр. прикріпивши віконце до правого нижнього кута.

У системах на кшталт WordPress такий код зазвичай вставляють у блок «Власний HTML» або в налаштуваннях теми.

## Крок 3: вигляд і поведінка

- `data-webchat-title`: заголовок вікна, `data-webchat-bubble-text`: напис на бульбашці,
- кольори: віконце використовує змінні CSS сторінки, а точніше їх можна налаштувати атрибутами `data-webchat-style-*`,
- `data-webchat-minimized`: чи чат стартує як бульбашка (за замовчуванням так),
- `data-webchat-send-start-event`: запускає привітання агента (тема Conversation Start),
- `data-webchat-mock-welcome`: показує привітання в браузері без з’єднання з агентом, тобто швидше й без витрат при самому вході на сайт.

## На що зважати

- **Витрати.** Кожна розмова з агентом витрачає кредити Copilot. На публічному сайті розмов може бути багато. Встановіть ліміти: ми пишемо про це в статті [про кредити в Copilot Studio](https://przejmijai.pl/uk/artykuly/copilot-studio-kredyty-limity-koszty).
- **Версія `@latest`** завжди завантажує найновішу версію бібліотеки. У продуктивному середовищі безпечніше вписати конкретний номер версії.
- **Бібліотека не підтримує** секретів Direct Line чи власних розширень WebChat.
- **RODO (польська назва GDPR):** якщо чат зберігає розмови, згадайте про це в політиці конфіденційності сайту.

Для обслуговування клієнтів варто також знати harness Customer Conversation, призначений для чату на сайті й телефону з передачею консультантові. Огляд harness-ів ви знайдете в статті [Microsoft Copilot harness чи стандарт](https://przejmijai.pl/uk/artykuly/copilot-studio-microsoft-copilot-harness-czy-standard).
