Как добавить ИИ-чат на сайт Tilda

Почему на Tilda нужен HTML, а не «магазин виджетов»

AiMaxChat подключается к сайту на Tilda как внешний script, а не как отдельное приложение из каталога Tilda. Вы вставляете публичный код виджета в HTML-блок страницы или в поле «код перед закрывающим body» в настройках сайта. Посетителю не нужно логиниться ни в Tilda, ни в AiMaxChat, чтобы открыть чат. Не устанавливайте выдуманные плагины с названиями вроде «AiMaxChat для Tilda 3.2» — такого официального модуля в этой инструкции нет.

Сначала посмотрите, как выглядит диалог, на публичном демо. Затем создайте своего бота, загрузите прайс и FAQ, проверьте тест-чат. Только после этого копируйте embed-код. Пустой виджет на опубликованной Tilda-странице создаёт впечатление, что «чат не работает», хотя не загружена база.

Tilda кеширует и собирает страницу при публикации. После вставки кода нажмите публикацию и проверьте уже опубликованный URL в инкогнито, а не только превью редактора. Превью иногда ведёт себя иначе, чем боевая страница. Если используете Zero Block, убедитесь, что HTML-элемент не обрезан по высоте так, что script не попадает в сборку — для виджета надёжнее код на весь сайт в настройках, чем блок на одном экране.

Куда вставить код: HTML-блок или настройки сайта

Вариант для всего сайта: настройки сайта → дополнительные поля для HTML / код перед body. Туда вставляют script с CDN виджета и вызов инициализации с botId, publicToken и apiUrl. Тогда чат появится на всех опубликованных страницах, включая каталог и контакты. Это удобно, если база знаний общая.

Вариант для одной посадочной: блок HTML на нужной странице. Так можно не показывать чат на блоге или оферте. Минус — легко забыть блок при новой странице услуг. Если услуги плодятся каждую неделю, лучше код на весь сайт. Не вставляйте один и тот же бот дважды на страницу: будут два хоста или конфликт инициализации.

Код копируйте из кабинета AiMaxChat после регистрации, а не из случайных сниппетов в интернете. В сниппете должны быть ваш идентификатор бота и публичный токен. Секретные ключи backend в Tilda не кладут. После вставки опубликуйте страницу. Если сайт закрыт паролем Tilda, гостевая проверка виджета не покажет реальную картину — снимите пароль на тестовой странице или проверьте после открытия.

Как проверить, что виджет виден гостю

Откройте опубликованный адрес с телефона и с компьютера, не входя в редактор Tilda. Кнопка чата обычно в правом нижнем углу. Напишите вопрос из вашей базы и вопрос вне базы. Второй должен дать честный отказ. Отправьте тестовый контакт и найдите лид в кабинете. Если лида нет, проверьте, что в инициализации указан рабочий apiUrl, а не пустой demo-режим.

Если кнопки нет, проверьте публикацию, кеш, блокировщик рекламы и то, что HTML не экранирован как текст. Иногда Tilda показывает script как видимый код на странице — значит, блок вставлен как обычный текст, а не как HTML. Пересоздайте блок типа HTML. Ещё конфликт: другой чат-виджет уже висит на шаблоне. Оставьте один.

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

Ограничения, о которых лучше знать заранее

Tilda не заменяет кабинет AiMaxChat. Менять приветствие, базу и лиды нужно в сервисе, а не в Zero Block. Если вы правите только текст на лендинге, бот об этом не узнает, пока тот же факт не попадёт в базу знаний. Держите прайс в двух местах согласованным: витрина Tilda и файл в кабинете.

Не вставляйте виджет в скрытый попап, который не попадает в опубликованный HTML. Не используйте «код на страницу» и «код на сайт» одновременно с одним и тем же ботом. Не обещайте синхронизацию с корзиной Tilda Stores, если вы не выгрузили ассортимент в базу. Чат отвечает по документам, не по скрытым полям конструктора.

После стабильной вставки оставьте в команде короткую памятку: где лежит HTML, кто публикует Tilda, кто обновляет базу. Смена оффера на лендинге без правки базы даст расхождение в чате. Когда будете готовы получить свой код, регистрация в сервисе нужна вам как владельцу бота, а не посетителю опубликованной страницы. Сам опубликованный лендинг при этом остаётся открытым без пароля и без входа в редактор. Это и есть публичная установка без логина гостя.

Типичные ограничения Tilda и что делать дальше

Tilda хорошо подходит для лендингов услуг. Если у вас многостраничный каталог с корзиной, всё равно виджет остаётся внешним script: он не заменяет корзину и не читает заказы Tilda. Не обещайте, что чат «подтянет наличие из Tilda-магазина», если вы это не загрузили в базу знаний файлом. Источник правды — ваши документы в кабинете AiMaxChat.

После изменения базы знаний в кабинете переустанавливать код на Tilda не нужно. Меняется содержимое ответов, не snippet. Перепубликация Tilda нужна только если вы правили сам HTML-блок. Если сменили бота, замените botId и токен в том же месте, где вставляли код, и опубликуйте сайт снова.

Когда вставка стабильна, добавьте чат на ключевые посадочные и настройте уведомления о лидах. Чтобы получить свой embed-код, пройдите регистрацию, создайте бота, загрузите прайс и откройте установку в кабинете. Публичная страница Tilda при этом остаётся доступной без логина.

Перед рекламой лендинга прогоните в тест-чате вопрос из базы и вопрос вне базы. Если отказ честный, а тестовый контакт появился в журнале, вставку можно считать рабочей. Если лида нет — проверьте Zero Block, публикацию и то, что на странице один виджет, а не два.