Режим без кнопки: ваша власна кнопка

Headless-віджет нічого не малює, поки закритий. Ваша сторінка малює власну кнопку і відкриває віджет через JavaScript API; відкритий компаньйон усе одно з’являється в кутку зі своїм персонажем, бо розмові треба десь бути.

У панелі: Віджет → Лаунчер → Тип лаунчера → Немає (headless) (налаштування віджета); кнопка, що його відкриває, — код вашої сторінки, нижче.

Налаштування

Власник обирає Нічого (headless) як тип кнопки запуску на вкладці «Кнопка запуску» віджета, або це задає сторінка:

<script>
  window.ShukaiConfig = { launcher: { type: "none" } };
</script>
<button id="ask" type="button">Спитати помічника</button>
<script>
  document.getElementById("ask").addEventListener("click", () => Shukai.open());
</script>

Shukai.open() — єдиний вхід. Він працює ще до монтування віджета — виклики ставляться в чергу, — тож кнопка може існувати з першого кадру. Shukai.toggle() і Shukai.isOpen() дозволяють одній кнопці відкривати й закривати. Задання launcher: { type: "none" } зі сторінки замінює весь об’єкт кнопки власника разом із підписом і контейнером (злиття неглибоке).

Що компаньйон малює все одно

Поки відкрито, персонаж показується в кутку — і ховається знову при закритті, — щоб док, бульбашки, картка і поле вводу мали опору; його можна перетягувати, як будь-яку кнопку запуску. Скін і кольори — власника (voiceCharacter, voiceOrbColor, orbColours). При закритті віджет повертає фокус елементу, що його відкрив, тож користувач клавіатури знову опиняється на вашій кнопці.

Від чого ви відмовляєтеся

• Немає привітального тизера й анімації привернення уваги: немає закритої кнопки, на якій їх показати.
• Немає підпису кнопки: headless-кнопка ніколи його не показує.
• Жодних проактивних знахідок: без кнопки запуску тік, що питає про них, не вмикається.

Усе інше без змін: дії на сторінці, голос, передача людині, історія, події.

Стилізація власної кнопки

Кнопка ваша; віджет її не стилізує. Якщо хочете, щоб вона пасувала до персонажа, токени теми віджета читаються з CSS вашої сторінки так само, як ви їх задаєте, — але сам орб недоступний як окремий компонент поза віджетом.

Коли це доречно

Сторінка з власним помітним закликом «Спитати»; додаток, у верхній панелі якого вже є кнопка допомоги; дизайн, у якому плаваючий орб конфліктував би з розкладкою. Для публічного сайту звичайна кнопка запуску зазвичай краща: персонаж у кутку — те, що запрошує відвідувача, який не шукав допомоги.