Widget

На странице Widget вы настраиваете, как выглядит и как ведёт себя экран чата, когда гости общаются с Mira. Здесь вы управляете ссылкой, которую даёте гостям, кодом для вашего сайта и приветственным экраном чата. Информация, которую сообщает Mira (время, правила и так далее), находится не на этой странице, а на странице Business Info.

Что вы видите на экране#

Когда вы нажимаете Widget в левом меню, вверху вы видите подпись WIDGET & CHAT SETTINGS, заголовок Widget и краткое описание. Ниже идут раскрывающиеся блоки (разделы). Каждый блок можно открыть или закрыть, щёлкнув по его заголовку. На компьютере слева находится меню On this page; при нажатии на название блока страница прокручивается к нему и блок раскрывается (Обзор панели).

В блоках только для Pro (5, 6, 7, 8) на тарифе Basic отображается следующее: значок PRO в заголовке блока, жёлтое предупреждение внутри блока (например, «Changing the assistant's name/photo is a Pro feature.») и ссылка Upgrade to Pro. Поля выглядят блёклыми и недоступны для нажатия, а кнопка Save Changes скрыта. О тарифах см. Аккаунт и тарифы.

Когда вы сохраняете блок, вверху появляется зелёное подтверждение (его текст — ✓ Business info updated successfully.; страница Widget использует то же сообщение).

Пошагово: подготовка виджета#

Пример: «Blue Bay Hotel», отель на 30 номеров, у которого есть собственный сайт и который хочет добавить на него чат.

1. Откройте Widget и посмотрите на блок Live Preview. Вы увидите своего ассистента внутри имитации сайта, точно такого, каким он будет на вашем собственном сайте. Примерно через 1,5 секунды над значком чата появится маленькое приветственное облачко. Нажмите на значок и попробуйте несколько вопросов.
2. В блоке Website Widget выберите Position (Right (center), Left (center), Bottom right, Bottom left) и нажмите Save.
3. Нажмите Copy Code в том же блоке (две секунды на кнопке написано Copied ✓) и добавьте код на свой сайт. Как это сделать, объясняется в разделе Установка на сайт и Guest Link.
4. (Pro) Дайте ассистенту собственное имя и фото в AI Receptionist Identity.
5. (Pro) Напишите Greeting Bubble и Custom Welcome Message так, чтобы они подходили вашему объекту.
6. Добавьте в Guided Suggestion Chips 3-5 вопросов, которые гости задают чаще всего.
7. Определитесь с настройками Direct Booking Banner и Pricing Visibility.
8. (Необязательно) Когда вы добавили код на сайт и убедились, что он работает, введите домен bluebayhotel.com в блоке Domain Security, отметьте Enable domain security и сохраните. Так другой сайт, скопировавший ваш код, не сможет пользоваться вашим чатом.
9. После каждого изменения страница перезагружается, а Live Preview обновляется автоматически; проверяйте результат там.

Поле за полем#

Live Preview#

Предпросмотр, который работает на вашем настоящем коде виджета и с вашими настоящими настройками: ассистент находится внутри страницы, похожей на «сайт вашего объекта». В строке заголовка показано название вашего объекта (и логотип, если он есть), а справа — выбор языка (🇹🇷 Türkçe, 🇬🇧 English, 🇩🇪 Deutsch, 🇷🇺 Русский) с маленькой кнопкой ➜ рядом. Если выбрать язык и нажать ➜, предпросмотр перезагрузится на этом языке, так что вы можете проверить ассистента на всех четырёх языках. Предпросмотр запускается на вашем Default Language.

Ссылка Open in new tab ↗ справа вверху открывает предпросмотр в более крупной вкладке. Предпросмотр перезагружается со свежими данными каждый раз, когда вы сохраняете блок (при каждой перезагрузке страницы). Во время набора текста он не обновляется.

Guest Link#

Когда гость открывает её впервые, он сначала видит окно Terms & Conditions. Это окно одинаково для всех объектов и не изменяется из панели: справа вверху в нём есть выбор языка (TR / EN / DE / RU), под заголовком Terms and Conditions — четыре пункта (что ответы генерирует ИИ, что разговоры могут записываться, что в чате не следует сообщать конфиденциальные данные, например данные банковской карты, и что продолжение означает согласие с условиями), а также кнопки Decline и Accept & Continue. Гость, нажавший Accept & Continue, больше не видит это окно в том же браузере. Decline тоже закрывает окно, и гость может продолжать общение; но поскольку выбор не запоминается, окно появится снова при следующем открытии чата.

Даже если вы пользуетесь панелью в тёмной теме, экран чата, который видят ваши гости (Guest Link, виджет на сайте и QR-код номера), всегда открывается в светлом оформлении; тема вашей панели никогда не передаётся гостям.

Если добавить к ссылке что-то вроде ?lang=en, чат можно запустить на нужном языке (tr, en, de, ru). Подробности — в разделе Установка на сайт и Guest Link.

Install App on Phone#

Этот блок только информационный; настраивать в нём нечего. Гости, открывающие Guest Link, видят кнопку Install App справа вверху на экране чата (на узком экране — только значок телефона). На Android / Chrome нажатие кнопки сразу устанавливает приложение и добавляет на главный экран телефона ярлык для быстрого доступа к Mira. На iPhone / Safari, поскольку Apple не поддерживает автоматическую установку, кнопка открывает короткую инструкцию с шагами Share → Add to Home Screen.

Website Widget#

Здесь вы видите однострочный код, который добавляете на сайт, и позицию виджета.

Чтобы сменить позицию, копировать код заново не нужно: позиция хранится на сервере, и виджет считывает её при каждом открытии. Изменение доходит до посетителей вашего сайта максимум примерно за 1 минуту (настройки виджета ненадолго кэшируются).

Brand Colors (Pro)#

Окрашивает гостевой экран чата и облачко чата на вашем сайте в фирменные цвета вашего бренда. Вы выбираете только два цвета; светлые оттенки, цвета при наведении и цвета текста вычисляются из них автоматически.

1. Откройте блок Brand Colors.
2. Нажмите на поля Main color и Dark color и выберите цвет в палитре (или введите код цвета).
3. Нажмите Save Changes. Страница перезагрузится, и блок вернётся в раскрытом виде.
4. В Live Preview проверьте новые цвета облачка чата и окна.

• Цвет текста на кнопках (белый или тёмный) выбирается автоматически в зависимости от выбранного цвета; если выбрать очень светлый основной цвет, текст на кнопках будет тёмным.
• Новые цвета сразу появляются в Guest Link, а в облачке на вашем сайте — не позднее чем примерно через 1 минуту. Менять код на сайте не нужно.
• Те же цвета применяются и к самой панели: кнопки, активная ссылка в левом меню, ссылки и фон левого меню отображаются в ваших цветах. Все участники команды видят панель в этих цветах.
• Если тариф вернётся на Basic, сохранённые цвета не удаляются, но не используются; экран чата возвращается к цветам по умолчанию.

AI Receptionist Identity (Pro)#

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

Имя и фото используются в: заголовке экрана чата («Selin · Цифровой администратор»), круглом фото на приветственном экране и фразе «Здравствуйте, добро пожаловать! Я Selin.», ответе Mira, когда гость спрашивает «Кто вы?», плавающем значке-облачке на вашем сайте, а также в названии и значке ярлыка на главном экране, который гость добавляет на свой телефон. Если загрузить файл неверного формата или больше 2 МБ, сохранение завершится ошибкой.

Greeting Bubble (Pro)#

Этот блок относится к вашему сайту: вы настраиваете маленькое облачко, которое появляется над значком чата, когда посетитель заходит на ваш сайт. Это облачко показывается до открытия чата, и оно отличается от приветственного сообщения, показываемого в открытом чате (следующий блок).

Для пустых полей используется облачко по умолчанию («Здравствуйте, я Mira — ваш ИИ-администратор! 👋 / Спрашивайте меня о чём угодно о вашем пребывании.»). Если пуст заголовок, по умолчанию заменяется только заголовок; если пусто описание — только описание. Ваш текст пишется на вашем языке контента и автоматически переводится на английский/немецкий/русский; посетитель видит версию на языке вашего сайта. Облачко появляется примерно через 1,5 секунды после открытия страницы и показывается один раз за загрузку страницы; ✕ закрывает его, а щелчок по облачку открывает чат.

Custom Welcome Message (Pro)#

Вы настраиваете приветственный текст в центре экрана, который гость видит при первом открытии чата. Он появляется и в Guest Link, и в виджете на вашем сайте.

Тексты пишутся на вашем языке контента и автоматически переводятся на другие языки. Если на выбранном языке текста нет, для этого языка показывается фраза по умолчанию. Если оставить оба поля пустыми, это означает «использовать тексты по умолчанию».

Guided Suggestion Chips#

Это нажимаемые примеры вопросов, которые гость видит на приветственном экране, ещё ничего не набрав. Нажатый вопрос отправляется так, будто гость набрал его сам, и Mira отвечает.

При успешном добавлении вы видите «✓ Suggestion chip added and translated into English/German/Russian.» Если для некоторых языков перевод не удался, вы видите «✓ Suggestion chip added, but some translations failed. ...», и на этих языках показывается исходный текст чипа. Когда достигнут лимит, вместо поля добавления появляются предупреждение и ссылка Upgrade to Pro («⚠️ On Basic, you can add up to 3 suggestion chips. Upgrade to Pro for more.»).

Если вы не добавили ни одного чипа (а Show suggestion chips отмечено), показывается общий набор по умолчанию: Pet policy, Breakfast, Airport transfer. Чипы появляются только на первом (пустом) экране чата и исчезают после первого сообщения.

Direct Booking Banner#

Domain Security#

Код, который вы добавляете на сайт, публичен: кто-то может скопировать его из исходного кода вашего сайта, вставить на свой сайт и пользоваться там вашим ассистентом (и вашей месячной квотой ИИ-разговоров). Этот блок гарантирует, что чат открывается только на перечисленных вами доменах. По умолчанию он выключен и работает одинаково на Basic и Pro.

Когда вы заполняете поле и нажимаете Save Changes, введённое очищается и сохраняется по следующим правилам. После сохранения в поле показывается сохранённая версия; если строка исчезла, она была признана недопустимой.

Если ввести один и тот же домен дважды, он сохраняется один раз.

Как это работает? Когда посетитель нажимает на чат-облачко на вашем сайте, чат открывается внутри окна (iframe), и браузер сообщает, какой сайт его открыл. Если этого сайта нет в списке, чат не открывается. На заблокированном сайте посетитель видит следующее: облачко и приветственное облачко по-прежнему появляются, но при нажатии на облачко в открывшейся панели вместо чата показывается тёмный блок с заголовком «Bu site için yetkilendirilmemiş» и фразой «Bu AI asistanı bu alan adında kullanıma açık değil.» («Не авторизовано для этого сайта» / «Этот ИИ-ассистент недоступен на этом домене»). Это сообщение показывается на турецком независимо от языка посетителя.

Эта настройка не влияет на следующее:

• Guest Link и QR-коды номеров всегда работают при прямом открытии, например из WhatsApp, SMS, при сканировании QR-кода или при вводе адреса.
• Live Preview на этой странице и предпросмотр через Open in new tab ↗ работают всегда (потому что открываются с собственного адреса Airoomier).

Pricing Visibility#

Пока эта настройка включена, в обычных текстовых ответах Mira также нет числовых цен; цена остаётся скрытой (метка «Price hidden»), и система не передаёт ИИ значения цен, пока номер не будет указан. После того как номер указан, цены отображаются как обычно — и на карточках, и в письменных ответах.

Airoomier Branding#

Блок только для информации. Строка «Powered by Airoomier · Verified Business Information» внизу экрана чата в настоящее время показывается и на тарифе Basic, и на Pro и не может быть удалена.

Календарь с ценами (сторона гостя)#

В этом блоке нет настроек; он носит справочный характер. Когда гость в чате нажимает на поле заезда или выезда в форме Выберите даты проживания, открывается календарь:

• Под каждым днём указана самая низкая цена за ночь среди типов размещения, свободных в эту ночь (рассчитывается по тарифным планам в Room Types).
• Дни, к которым применяется скидка последней минуты или за раннее бронирование из Ценовых правил, отмечены бирюзовой ценой и маленькой точкой.
• Дни, в которые все типы полностью заняты, зачёркнуты, и их нельзя выбрать датой заезда. Дату выезда нельзя выбрать дальше первой занятой ночи после заезда.
• Гость сначала нажимает на день заезда, затем на день выезда; календарь закрывается, и даты подставляются в форму.
• Если включена Pricing Visibility и гость ещё не поделился номером телефона, календарь не показывает цены, только свободные дни.
• Календарь учитывает выбранное гостем количество человек: типы с недостаточной вместимостью не учитываются.

Что происходит дальше#

• Когда вы сохраняете блок, страница перезагружается, и Live Preview перезагружается с актуальными данными.
• В чате по Guest Link (приветственный экран, имя и фото ассистента, чипы, баннер, скрытие цен) изменения видны сразу.
• В виджете, встроенном в ваш сайт, изменения позиции, облачка и значка ассистента доходят до посетителей максимум примерно за 1 минуту. Если на вашем сайте есть плагин кэширования/CDN, задержка может длиться столько, сколько он хранит код.
• Изменения Domain Security вступают в силу при следующем открытии посетителем панели чата на вашем сайте; менять код на сайте не нужно.
• Если вы перейдёте с Pro на Basic, тексты, которые вы написали в блоках Pro, не удаляются, но гостям не показываются; вместо них появляются тексты по умолчанию. Они вернутся, когда вы вернётесь на Pro.

Советы и частые ошибки#

• Сохраняйте блоки по одному: сохранение блока перезагружает страницу; несохранённый текст в других блоках теряется.
• Пишите на своём языке контента: тексты приветствия, облачка и чипов пишите на Content language, заданном в Business Info; остальные языки переводятся автоматически.
• Не пишите длинные тексты: при превышении лимитов (40, 60, 80, 200, 300 символов) лишнее молча обрезается.
• Облачко и фото ассистента не отображаются на вашем сайте? Нужны тариф Pro, сохранённое содержимое и отсутствие data-position в коде на вашем сайте. См. Установка на сайт и Guest Link.
• Чат не открывается на вашем сайте после включения Domain Security? Проверьте, что домен вашего сайта есть в списке и написан правильно (посмотрите сохранённую версию). Если ваш сайт публикуется и по другому адресу (например, на отдельном домене для бронирования или временном тестовом адресе), добавьте и этот домен. Подробности: Установка на сайт и Guest Link.
• Достигнут лимит чипов? Можно удалить старый и добавить новый или перейти на Pro.
• Использование в номере: чтобы связать чат гостя с конкретным номером, используйте QR-код номера; см. Room Types и Guest Requests.