Де агент відповідає

Один і той самий помічник — ті самі знання, ті самі дії — може відповідати в трьох місцях.

Куди	Кому це потрібно	Чи треба підключати канал
Вікно на вашому сайті	усім, у кого є сайт	ні, працює саме собою
Бот у Telegram	тим, кому пишуть у месенджер	так, потрібен токен
Ваш власний застосунок	тим, у кого є свій застосунок або система	так

Поки писати нікуди, панель праворуч показує «ще ніде не відповідає». Вікно на сайті каналу не потребує — воно вмикається дозволом домену, — але панель рахує і його: дозволений сайт видно в рядку Канали поіменно, і позначка стає «відповідає».

Вікно на сайті

У кутку вашої сторінки з’являється кругла кнопка, за нею — вікно чату.

Вмикається одним рядком у підвал сторінки:

<script
  src="https://app.youselfbot.com/widget.js"
  data-bot-key="pk_ваш_ключ"
  data-api="https://api.youselfbot.com"
></script>

Вставили один раз — і назавжди: заголовок вікна, привітання й колір ви потім міняєте в розмові, код перевставляти не треба.

Якщо на сайті строгий CSP

Сайти з Content-Security-Policy: style-src 'self' блокують стилі вікна, і воно стає не просто нестилізованим, а некликабельним: кнопка є, натиснути не можна. Додайте до тега свій одноразовий nonce — той самий, який ви підставляєте решті стилів:

<script src="…/widget.js" data-bot-key="pk_…" data-nonce="{{ csp_nonce }}"></script>

Що вікно памʼятає в браузері відвідувача

Переписка зберігається в його браузері, щоб оновлення сторінки не починало розмову з нуля, і стирається сама через добу без нових реплік. Це важливо там, де за компʼютером сидять різні люди: у салоні, у бібліотеці, на ресепшені.

Звідки взяти цей рядок

Попросіть конструктора — він видасть готовий рядок із вашим ключем:

Постав помічника на мій сайт example.com

Він зробить дві речі одразу: віддасть код і дозволить вашому сайту звертатись до агента.

Якщо сайт на WordPress

Правити тему не треба — є плагін. Завантажте архів:

youselfbot-chatbot.zip

Далі «Плагіни → Додати новий → Завантажити плагін», активуйте, відкрийте «Налаштування → YouSelfBot Chatbot» і заповніть три поля: хост https://app.youselfbot.com, адресу API https://api.youselfbot.com і свій публічний ключ pk_.

Адреса API — окреме поле, і порожнім його лишати не можна: вікно тоді стукає туди ж, звідки взяло свій код, і чат мовчки не відповідає. Обидві адреси є в готовому рядку, який дає конструктор, — скопіюйте їх звідти. Домен сайту все одно має бути дозволений — див. попередження вище.

Порожнє поле означає «бере з кабінету»

Заголовок, привітання й колір у налаштуваннях плагіна перебивають те, що ви налаштували в розмові: вони йдуть у код сторінки напряму. Лишіть ці поля порожніми — і керуватимете ними з кабінету, як усім іншим.

Без дозволеного домену вікно мовчить

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

Наслідок буває незрозумілим: код вставлено, кнопка є, а на питання ніхто не відповідає — і виглядає це як поламка помічника. Тому називайте адресу сайту одразу, коли просите код. Якщо забули — скажіть пізніше: «дозволь example.com».

Ключ можна показувати

pk_… — публічний ключ: він лежить у HTML вашої сторінки, його бачить кожен відвідувач, і це нормально. Захищає не таємність ключа, а перелік дозволених доменів.

Як міняти вигляд

Усе — однією фразою в розмові:

Назви вікно «Помічник Смаку», зроби акцент кавовим #6f4e37 і постав його ліворуч унизу

Що вміє мінятись:

Що	Значення
заголовок вікна	будь-який текст
привітання	перше повідомлення у вікні
підказки-питання	2–4 фрази під привітанням
акцентний колір	у форматі #12a150
позиція	правий або лівий нижній кут
тема	світла, темна або під сайт
форма «залишити контакт»	показувати чи ні (типово показується)

Куди дінуться зібрані контакти

Спитайте про них у розмові:

Покажи контакти, які лишили

Конструктор перекаже імена, телефони й пошту з повідомленнями та датами, найновіші вгорі. Якщо перелік порожній, а ви чекали на нього — він скаже й ймовірну причину: форма контактів вимкнена.

Окремо можна попросити сповіщати про кожен новий контакт одразу — тоді вони приходитимуть у Telegram, а не чекатимуть, поки ви зайдете.

Якщо на сайті є особистий кабінет

Бот може впізнавати ваших клієнтів — вітати постійного на імʼя, показувати ЙОГО замовлення, виконувати дії від його імені. Для цього сторінка має сказати вікну, хто прийшов; це кілька рядків у коді сайту, і вони описані окремо: Вікно на сайті: код і підпис.

Там само — як відкривати чат своєю кнопкою й що робити на SPA, де адреса сторінки не міняється.

Бот бачить сторінку, на якій відкрито вікно

Працює одразу, вмикати нічого не треба. З кожним питанням до бота їде коротка довідка про сторінку: адреса (без рядка запиту — усе після ? не збирається навмисно), заголовок, а на картці товару ще й назва, ціна з валютою, наявність, артикул і бренд — усе з розмітки, яку ваш магазин уже має (schema.org або OpenGraph).

Саме тому «а є 42 розмір?» і «скільки коштує?» отримують відповідь про той товар, що відкритий, а не з бази знань, де ціна може бути позавчорашня.

Якщо на ваших сторінках є те, чого ботові бачити не варто:

Не читай сторінки мого сайту

Кольори краще не чіпати

Типово вікно саме переймає палітру вашого сайту. Задані вручну кольори цю здатність вимикають — просіть їх лише тоді, коли автоматичний підбір справді не влучив.

Бот у Telegram

Клієнт пише туди, де в нього листування з друзями, — і отримує відповідь із ваших матеріалів.

Токен беруть так:

1. Напишіть у Telegram боту @BotFather.
2. Надішліть /newbot і дайте боту ім’я.
3. У відповідь прийде рядок виду 123456789:AA… — це й є токен.
4. Вставте його в розмову з конструктором.

Хай відповідає в Telegram, ось токен: 123456789:AA…

Конструктор підключить одразу, не перепитуючи. Надісланий токен і є згодою: сильнішої не буває — ви віддали доступ до свого бота саме для цього.

Надсилайте токен одним повідомленням разом із проханням

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

Приховування впізнає найпоширеніші ключі: токен Telegram, заголовок авторизації, ключі виду sk-, ghp_, AIza, AKIA. Рідший секрет — пароль поштової скриньки, токен Viber чи ключ вашої внутрішньої системи — може лишитись у розмові текстом. Надсилайте такі ключі окремим повідомленням і, якщо він більше не потрібен у переписці, видаляйте розмову.

Далі про Telegram варто знати:

• Голосові повідомлення він не розбере — помічник працює з текстом.
• Токен ніде більше не показується, зокрема й вам. Якщо він утік, зробіть у @BotFather /revoke і підключіть канал заново.
• Перепідключення видає нову вхідну адресу, тому конструктор і питає перед тим, як чіпати канал.

Ваш власний застосунок

Мобільний застосунок, внутрішній чат, каса — будь-яка ваша система шле повідомлення й одразу читає відповідь. Це той канал, який робить перелік відкритим.

Ця частина посібника адресована не вам, а тому, хто робив вам застосунок: Для розробника. Якщо такої людини немає — вам сюди не треба, вікна на сайті й бота в Telegram цілком досить.

Коли клієнт просить живу людину

У вікні на сайті та у власному застосунку відвідувач може натиснути «Покликати людину». Тоді помічник замовкає — двоє одночасно не відповідають, — звернення чекає на людину, і поки говорить людина, кредити не витрачаються.

У Telegram такої кнопки немає

У месенджері помічник відповідає сам, зі знань, які ви йому дали. Шляху «покликати людину» там поки не існує. Якщо жива відповідь потрібна вам щодня — ставте вікно на сайт.

Відповідають на такі звернення в розділі «Розмови» — про нього окрема сторінка: Коли клієнт просить людину. Там-таки стирають дані відвідувача на його вимогу.

Вимкнути на час — не те саме, що відключити

Вимкни телеграм на тиждень

Вимкнений канал лишається собою: та сама вхідна адреса, той самий токен. Повідомлення не приймаються, а вмикається він тим самим проханням.

Відключи телеграм зовсім

Відключення — незворотне: канал зникає, месенджер відписується від нашої адреси, і перепідключення видасть нову вхідну адресу. Конструктор спитає згоди й назве саме це.

Відписка — наша робота, а не ваша

Підписку на месенджер ставимо ми, тож і знімаємо теж ми. Якщо відписати не вдалося (месенджер недоступний), конструктор скаже про це прямо: доки підписка жива, бот шле повідомлення на адресу, якої вже немає.

Що зараз підключено

Рядок Канали в панелі праворуч. Або спитайте:

Де мій агент може відповідати людям?

Конструктор перелічить і канали, і дозволені сайти, а окремо назве ті канали, що не налаштовані: канал є, а працювати не може — це найгірший стан, бо виглядає зробленим.

Далі

• Коли клієнт просить людину — як відповідати на звернення самому.
• Щоб працював без вас — коли агент має працювати сам, а не відповідати.
• Коли щось зламалось — чому агент міг замовкнути.

Viber

Підключи Viber, ось токен публічного акаунта: …

Токен видає панель публічного акаунта Viber. Далі все як у Telegram: агент відповідає в тій самій розмові, бачить фото, памʼятає людину між розмовами. Оператора в цьому каналі немає — відповідь із кабінету в месенджер не доходить, тож агент сповістить вас, а відповісте ви з самого Viber.

WhatsApp

Підключи WhatsApp: ось постійний токен і Phone number ID

Обидва — з кабінету Meta for Developers (WhatsApp → API Setup). Конструктор відповість адресою зворотного виклику і кодом перевірки — їх треба вписати в кабінеті Meta (WhatsApp → Configuration → Webhooks) і підписатись на поле messages. Meta спершу перевірить адресу сама і лише потім почне слати повідомлення. Адреса й код показуються один раз.

Далі як у Telegram: агент відповідає в тій самій розмові, бачить фото, памʼятає людину. Оператора в цьому каналі немає.

Правило 24 годин

WhatsApp дозволяє вільно відповідати лише протягом доби після повідомлення людини. Пізніше — тільки затвердженим шаблоном. Агент про це знати не може: якщо він відповідає через два дні, сервіс відмовить, і ви побачите це поламкою.

Пошта

Агент читає скриньку й відповідає на листи — заявки, скарги, замовлення — з вашої адреси.

Хай відповідає на листи в shop@gmail.com, пароль застосунку …

Досить адреси й пароля. Для Gmail, Outlook, ukr.net, i.ua, meta.ua, Yahoo та iCloud сервери платформа знає сама: агент читає скриньку раз на хвилину й відповідає з неї ж. Нічого перенаправляти не треба.

Пароль застосунку

Gmail, iCloud і Yahoo не пускають програми зі звичайним паролем. У налаштуваннях безпеки акаунта є «паролі застосунків» — створіть один для агента. Конструктор підкаже, де саме.

Адреса на власному домені: назвіть конструктору сервери вихідної (SMTP) і вхідної (IMAP) пошти — вони є в налаштуваннях вашої поштової програми. Якщо вхідний сервер невідомий, агент лише відповідатиме, а вхідні листи доведеться перенаправляти на вхідну адресу каналу сирим листом (raw MIME) — це для тих, у кого є поштовий сервер.

Агент бере лише непрочитані листи, що зʼявились після підключення. Те, що ви вже прочитали, він не чіпає — і не відповість на всю скриньку за минулий рік.

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

Як це поводиться:

• та сама скринька — та сама розмова. Людина, що пише з однієї адреси, веде одну нитку, як у месенджері;
• тема — частина репліки. «Замовлення №418» у темі й «коли доставите?» в тілі агент читає разом;
• цитату попереднього листа агент не читає — відповідає на те, що написали зараз;
• автовідповіді й розсилки — не розмова. На «я у відпустці» агент не відповість;
• фото з листа він бачить, документи — знає, що вони є (прочитати їх може дія);
• відповідь іде з вашої адреси, темою «Re: …».

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