> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hubtalk.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Демо-ссылки

> Временная ссылка, по которой любой человек поговорит с вашим агентом в браузере.

# Демо-ссылки

Демо-ссылка — временный адрес, который открывает разговор с одним из ваших агентов прямо в браузере получателя. Он переходит по ссылке и говорит. Ни учётной записи, ни API-ключа, ни настройки на его стороне — поэтому это самый быстрый способ показать агента потенциальному клиенту, коллеге или заказчику.

## Как создать ссылку

Откройте агента и нажмите **Share**. Панель спросит две вещи:

* **Срок жизни ссылки** — 1 час, 24 часа, 7 дней (по умолчанию) или 30 дней.
* **Сколько звонков разрешено** — сколько всего разговоров можно начать по ссылке. Значение платформы по умолчанию — 25, потолок — 200.

Там же можно заранее заполнить переменные агента, чтобы демо говорило о конкретном клиенте, а не отрабатывало общий сценарий. Получатель увидит эти значения на странице и сможет поправить их перед звонком.

<Note>
  **Поделиться можно только опубликованным агентом.** Ссылка на неопубликованного агента не сможет позвонить в принципе, поэтому платформа откажется её создавать — пока вы ещё можете опубликовать агента и повторить.
</Note>

## Что видит получатель

Страница открывается с именем агента, короткой формой с данными звонка и кнопкой **Начать звонок**. Старт звонка запрашивает у браузера микрофон; если микрофона нет или доступ запрещён, посетитель может продолжить в **чате без звука**.

<img src="https://mintcdn.com/hubtalk/cKl-cjuDGhk4sToG/images/v4_demo_link_visitor_page.png?fit=max&auto=format&n=cKl-cjuDGhk4sToG&q=85&s=03a0cc4db1f3a4bef07959e72521e01f" alt="Страница демо-ссылки: имя агента, форма данных звонка, кнопки «Начать звонок» и «Чат без звука»" width="1440" height="900" data-path="images/v4_demo_link_visitor_page.png" />

Если агент не объявляет переменных, форма честно так и пишет — заполнять нечего, можно сразу начинать разговор.

Переменные фильтруются по опубликованной версии агента: принимаются только те имена, которые агент действительно объявляет, всё остальное со страницы отбрасывается. Браузер может заполнить контракт, но не расширить его.

Когда ссылка перестала работать, страница говорит об этом одной нейтральной фразой и предлагает попросить новую ссылку. Истёкшая, отозванная, исчерпанная и выключенная выглядят снаружи одинаково — причину видите только вы, в панели Share.

## Ограничения, которые держат ссылку в рамках

Демо-ссылка — это предъявляемый секрет, отданный человеку вне вашей организации, поэтому радиус утечки ограничен намеренно:

* **Одна ссылка — один агент.** Ни до чего другого в вашей организации она не дотянется.
* **Потолок звонков и срок жизни**, оба атомарные: при одновременном использовании ссылка не перескочит свой потолок.
* **Один разговор одновременно.** Пока идёт звонок, ссылка занята, и следующему посетителю предлагают попробовать через минуту.
* **Отзыв в любой момент.** Отзыв срабатывает сразу и необратим: тот, у кого ссылка на руках, больше не сможет позвонить.

<Warning>
  **Относитесь к самой ссылке как к учётным данным.** Панель Share умеет показать тот же адрес повторно — это сделано специально, чтобы можно было переслать уже выданную ссылку, — и это же означает, что любой, кто открывает панель, читает живую ссылку. По той же причине весь раздел демо-ссылок закрыт роли **участник**, включая чтение. См. [Роли и доступ](/ru/v4/platform/roles).
</Warning>

У каждой ссылки в панели показано её состояние: **активна**, **истекла**, **отозвана** или **звонки исчерпаны**.

<img src="https://mintcdn.com/hubtalk/cKl-cjuDGhk4sToG/images/v4_demo_link_share_panel.png?fit=max&auto=format&n=cKl-cjuDGhk4sToG&q=85&s=9ec3ec30bb0477716f81f0dca4f92996" alt="Панель Share: срок жизни, потолок звонков и список выданных ссылок с их состояниями" width="720" height="420" data-path="images/v4_demo_link_share_panel.png" />

## Демо-звонки в истории

Разговор по демо-ссылке попадает в [Историю](/ru/v4/platform/campaign-history) как обычный звонок — и находится там фильтром **«Все каналы» → «web-звонок»**. Демо идёт из браузера получателя, поэтому платформа записывает его каналом `web`, а не `phone`.

<Note>
  **Канал `web` — это не только демо.** В него же попадают разговоры из виджета на вашем сайте и из вашего кода на [браузерном SDK](#как-встроить-разговор-в-свой-сайт): всё, что идёт из браузера, а не по телефонной линии. Если вы пользуетесь и тем и другим, фильтр канала сузит список до браузерных звонков, но демо от виджета не отделит — тут поможет фильтр по агенту, раз демо-ссылка всегда выдана на одного агента.
</Note>

Во всём остальном это обычные звонки: транскрипт, аналитика, запись и отчёты работают как всегда — неудачное демо можно разобрать так же, как любой другой разговор.

## Как встроить разговор в свой сайт

Демо-ссылка — это готовая страница. Если тот же разговор нужен внутри вашего продукта, используйте браузерный SDK, опубликованный как [`@hubtalk-ai/web-sdk`](https://www.npmjs.com/package/@hubtalk-ai/web-sdk) — тонкую обёртку над эндпоинтом веб-звонка из [Web API](/ru/v4/web-api).
