Ссылка на чат
Самый быстрый способ дать покупателю пообщаться с ассистентом — не писать интеграцию вообще, а поделиться ссылкой на готовую страницу чата.
Если вы создаёте ассистента через мастер («Создать ассистента» → пошаговый визард), ссылка формируется автоматически на последнем шаге — можно сразу скопировать её и не выполнять шаги ниже вручную.
Есть два способа поделиться ссылкой:
Способ 1 — красивый адрес со своим slug (рекомендуется)
- Откройте ассистента в личном кабинете и перейдите на вкладку «Ссылки».
- Нажмите «Создать ссылку», придумайте короткий адрес (
my-support-chat) — занятость проверяется сразу, по мере ввода. - Выберите режим доступа (см. ниже) и создайте ссылку — она будет доступна по адресу:
https://<ваш-домен>/c/<ваш-slug>Ссылок можно создать сколько угодно на одного ассистента — например, отдельную для каждого канала (сайт, соцсети, рассылка), каждую со своим режимом доступа. Отзыв ссылки не ломает остальные и освобождает slug для повторного использования.
Режимы доступа
| Режим | Кто может открыть чат |
|---|---|
| Открытая | Все, у кого есть ссылка — как обычная публичная ссылка. |
| По ключу в ссылке | Ссылка содержит дополнительный секрет (?key=...), сгенерированный автоматически и показанный один раз при создании — без него открыть чат нельзя, даже зная сам slug. |
| Только для зарегистрированных | Посетитель должен зарегистрироваться или войти в аккаунт на платформе NextAi прямо на странице ссылки — это отдельный от вашего личного кабинета вид аккаунта, специально для посетителей чата. |
| По паролю | Перед чатом посетитель вводит пароль, который вы задали при создании ссылки. |
| С подтверждением через ваш сервер | Перед каждым новым обращением наш сервер отправляет POST-запрос на указанный вами URL с IP, User-Agent и query-параметрами запроса; ваш сервер должен ответить 200 и телом {"allow": true} — иначе (в том числе если ваш сервер недоступен) доступ будет заблокирован. Это самый строгий режим — доступность вашего сервера подтверждения становится частью пути к чату. |
Способ 2 — сырой ключ ассистента (для встраивания/совместимости)
- Откройте ассистента в личном кабинете и перейдите на вкладку «Ключи».
- Создайте публичный ключ (
pk_) без ограничений поOrigin— специально для шаринга, отдельно от ключа встроенного на сайте виджета (см. «Публичные и приватные ключи»). - Ссылка формируется как:
https://<ваш-домен>/chat/<полный_публичный_ключ>Например:
https://app.nextai.example/chat/pk_KJs6FkQupwWY3SsUME110BvOmBSfvipe7B0-ubOpPLgЭтот способ не поддерживает slug и режимы доступа — используйте его, только если вам нужен сырой ключ (например, для собственного встраивания). Для обычного шаринга удобнее Способ 1.
Продолжение разговора
Страница сама добавляет в адресную строку параметр ?c=, привязанный к конкретному чату —
если покупатель закроет вкладку и вернётся по той же ссылке, разговор продолжится с того же места.
Кнопка «Новый чат» сбрасывает эту привязку и начинает разговор заново.
Ограничения
- Страница работает только для гостевых чатов — она не подходит, если вам нужно связать разговор с конкретным зарегистрированным пользователем вашей системы (для этого нужна собственная интеграция, см. «Интеграция по API»).
- Если у ассистента отключены гостевые чаты (настройка
allowGuestChats), страница покажет сообщение об ошибке при первой отправке.