Соберите сценарий один раз — он работает и в Telegram, и в виджете на вашем сайте. Те же узлы, те же контакты, та же аналитика. Виджет чата — это не второй продукт, который придётся поддерживать отдельно, а тот же бот в другом канале.
Один сценарий, два канала
Обычно получается две несвязанные вещи: бот в Telegram и отдельный чат на сайте, который про этого бота ничего не знает. В FlowCastle посетитель сайта и пользователь Telegram — это контакты одного вида, и обрабатывает их один и тот же сценарий.
Это не копия сценария. Это тот же самый сценарий. Сообщения, меню, условия, переменные, запросы к вашему API — все узлы, которые вы уже собрали, работают без изменений, когда диалог приходит с сайта, а не из Telegram. Поменяли приветствие один раз — поменялось в обоих каналах.
Токен не нужен
Для бота в Telegram нужен токен от BotFather. Для чата на сайте не нужно ничего. Внутри приложения добавьте бота, выберите Чат на сайте — и он готов. Без аккаунта разработчика, без модерации, без ожидания ключа. Рабочий виджет можно получить раньше, чем вы придумаете боту название.
Три способа поставить виджет на сайт
Кнопка в углу. Один скрипт перед закрывающим тегом `</body>` — и на каждой странице появляется кнопка чата. Этого хватает большинству сайтов.
Встроенный блок. Сниппет с iframe помещает чат в конкретное место конкретной страницы — на страницу поддержки, тарифов или посадочную — нужной вам ширины.
Отдельная страница. У каждого чат-бота есть свой полноэкранный адрес: на него можно вести ссылкой, спрятать за QR-кодом или отправить письмом. Эту страницу можно установить как приложение — посетитель оставит её на домашнем экране телефона и будет получать push-уведомления.
В руководстве по установке разобраны все три способа с готовыми сниппетами.
Что посетитель действительно может делать
Это полноценный чат, а не форма обратной связи в оболочке чата:
- Нажимать кнопки и пункты меню, в том числе с выбором нескольких вариантов и с подтверждением
- Смотреть картинки, открывать документы и скачивать файлы, которые отправляет сценарий
- Присылать свои фото и файлы — до 50 МБ
- Видеть индикатор набора, пока бот думает
- Вернуться завтра и застать переписку на том же месте
Вернувшегося посетителя браузер узнаёт, поэтому диалог, начатый в понедельник, в четверг продолжается, а не начинается заново с приветствия.
Виджет выглядит как часть вашего сайта
Светлая тема, тёмная или по настройкам системы. Акцентный цвет, цвета сообщений, фон чата — включая фоновую картинку. Ваш аватар, ваш favicon, ваша шапка. Ширина панели и радиус скругления. Приветствие, которое отправляется само при первом открытии, и закрываемое уведомление под шапкой — для того, что действительно нужно прочитать.
Есть и отдельная настройка: открывать чат самому, когда бот ответил, или показать значок непрочитанного и подождать.
Когда нужен живой человек
Диалог с ботом становится диалогом во входящих. Если посетитель спрашивает то, подо что сценарий не собирали, сценарий передаёт разговор человеку — и команда отвечает из тех же входящих, где лежат диалоги из Telegram. Посетитель остаётся в том же окне и не замечает никакой границы.
Чат на этом сайте работает на FlowCastle по шаблону, который можно установить и разобрать: Помощник на сайте.
Свой домен
По умолчанию виджет загружается с домена FlowCastle. Если хочется, чтобы он жил на `chat.вашакомпания.ru`, добавьте поддомен, создайте CNAME-запись, которую мы покажем, — сертификат TLS мы выпустим сами. Обычно это происходит быстро, но может занять до 24 часов. Только поддомены: корневой домен вида `вашакомпания.ru` для этого использовать нельзя.
Всё остальное продолжает работать
Посетитель с сайта становится контактом. Значит, остальная часть платформы работает с ним без исключений: рассылки, цепочки писем, цели и отчёты по конверсиям, теги и переменные, воронка в аналитике, которая показывает, где люди останавливаются. Одна аудитория — независимо от того, откуда человек пришёл.
Чего виджет не умеет
Лучше узнать это до того, как вы построите на этом процесс:
- Оплата в чате на сайте не работает. Telegram Payments работает в Telegram. Сценарий с шагом оплаты не примет деньги от посетителя сайта — ведите его в вашу обычную оплату.
- Кнопки Telegram Mini App работают только в Telegram. Виджет их игнорирует.
- Кнопка чата стоит в правом нижнем углу. Пока это положение не настраивается.
Пусть лучше это будет написано здесь, чем обнаружится в бою.
Начните с того канала, который уже есть
Соберите бота для Telegram, в тот же день поставьте виджет на сайт — и пусть один сценарий отвечает в обоих местах. Бесплатный тариф, карта не нужна.