KeyScope
AI-консультант Тарифи Оферта Увійти
Довідка для користувачів

Як отримувати корисні відповіді від KeyScope

Пишіть запитання звичайною мовою. Для точнішого результату називайте показник, період і, за потреби, товар, категорію, джерело замовлень або UTM-мітку.

Хороший запит містить три речі Що порахувати · за який період · як показати або з чим порівняти.

Початок роботи

Оберіть компанію, створіть діалог і сформулюйте бізнес-питання. Розрахунки виконує backend за даними підключеного KeyCRM або Хорошоп, а AI пояснює результат.

Назвіть показникЗамовлення, виручка, оплата, середній чек, товари, клієнти, міста, джерела або UTM.
Вкажіть періодНаприклад: учора, цей місяць, липень 2026 або точні дати.
Уточнюйте даліПопросіть деталізацію в тому самому діалозі або почніть новий для іншої теми.
Якщо період або критерій незрозумілий, аналітик поставить коротке уточнювальне запитання. Це нормальна частина діалогу.

Як обирається джерело даних

Якщо підключена одна платформа, KeyScope використовує її автоматично. Якщо активні KeyCRM і Хорошоп, platform-admin задає джерело за замовчуванням, а користувач може явно назвати потрібну платформу в запитанні.

  • «Покажи продажі в Хорошоп за серпень» — звіт лише з Хорошоп.
  • «Покажи продажі в KeyCRM за серпень» — звіт лише з KeyCRM.
  • Коротке продовження в тому самому діалозі успадковує останню явно названу платформу.
  • KeyScope не складає дані двох платформ автоматично: замовлення з Хорошоп може вже бути синхронізоване в KeyCRM, тому просте додавання створить дублікати.
Щоб змінити платформу, прямо напишіть «у Хорошоп» або «у KeyCRM». Для зведеної аналітики спочатку потрібне окреме правило дедуплікації замовлень.

Приклади запитів

Ці формулювання можна копіювати й змінювати під свої дати, товари та задачі.

Продажі та замовлення

Скільки замовлень і яка виручка були цього місяця?Покажи середній чек за липень 2026 року.Які статуси мали замовлення за минулий тиждень?Яка сума знижок і витрат була вчора?

Порівняння періодів

Порівняй продажі за серпень із липнем.Як змінилися топ товарів у серпні проти липня?Порівняй міста за виручкою за два останні місяці.Які UTM-кампанії зросли або впали порівняно з попереднім місяцем?

Оплати

Скільки замовлень повністю оплачено за серпень?Яка валова та повністю оплачена виручка за цей місяць?Яку частку замовлень ще не позначено як оплачені?

Товари й категорії

Які товари продавалися найкраще в липні?Покажи топ товарів за виручкою за цей місяць.Скільки одиниць товару з SKU ABC-123 продано за тиждень?Які категорії принесли найбільше виручки?

Джерела замовлень

Які джерела принесли найбільше замовлень цього місяця?Покажи частку виручки за каналами продажів у липні.У якого джерела найбільший середній чек?Порівняй джерела за кількістю повністю оплачених замовлень.

UTM-мітки та кампанії

Які utm_source принесли найбільше замовлень цього місяця?Покажи топ-5 UTM-кампаній за виручкою у липні.Який utm_medium має найбільше повністю оплаченої виручки?Яка частка замовлень за період містить UTM-мітки?

Міста доставки

З яких міст було найбільше замовлень цього місяця?Покажи топ-10 міст за виручкою у серпні.У якого міста найбільший середній чек?Яка частка замовлень за період має заповнене місто доставки?

Клієнти — якщо дозволено

Хто купив найбільше пилососів у липні?Покажи ім’я та телефон клієнта з найбільшою сумою покупок.Знайди покупки клієнта за фрагментом телефону.

Продовження відповіді

А тепер покажи це за попередній місяць.Відсортуй за виручкою.А які джерела цих замовлень?Уточни тільки для товару з SKU ABC-123.

Діалог і уточнення

KeyScope зберігає контекст повідомлень усередині одного діалогу. Тому коротке уточнення «а за червень?» буде пов’язане з попереднім питанням.

  • Кнопка «+ Новий діалог» починає чисту тему без попереднього контексту.
  • Діалоги вебкабінету й Telegram відображаються в загальній історії компанії з урахуванням доступу користувача.
  • Не змішуйте в одному короткому уточненні кілька нових задач — краще сформулюйте повне запитання.
  • Оцініть відповідь 👍 або 👎: це допомагає команді побачити прогалини та покращити продукт.

Як рахуються показники

До звітів застосовуються правила саме вашої компанії: включені та виключені статуси, спосіб визнання оплати, валюта й часовий пояс.

Валова виручкаСума `grand_total` включених замовлень. Це не обов’язково вже отримані гроші.
Повністю оплачена виручкаСума замовлень, що відповідають налаштованим правилам повної оплати.
Середній чекВалова виручка, поділена на кількість включених замовлень.
Товарна виручкаЦіна продажу × кількість за товарними рядками; одиниці виміру не змішуються.
ДжерелоКанал або джерело замовлення, яке повертає обрана платформа.
UTM-атрибуціяМітки `utm_source`, `utm_medium`, `utm_campaign`, `utm_term` і `utm_content`, збережені в замовленні. Це не те саме, що системне джерело замовлення.
МістоМісто доставки з обраної платформи. Порожні міста не входять до рейтингу, але показуються в покритті звіту.
ПеріодЛокальні календарні дні у часовому поясі компанії, коректно перетворені у формат API джерела.

Дані клієнтів

За замовчуванням імена, телефони та email покупців не використовуються. Owner або admin компанії може окремо дозволити мінімально необхідні контактні дані після підтвердження законних підстав.

  • Після дозволу аналітик повертає не більше 5 релевантних клієнтів.
  • Доступні лише buyer ID, ім’я, телефон, email та потрібні агреговані показники.
  • Адреси, дати народження, нотатки, довільні поля, сирі замовлення й масовий експорт не підтримуються.
  • API-ключ KeyCRM ніколи не передається OpenAI.

Telegram

Прив’яжіть приватний чат до свого облікового запису кнопкою в кабінеті. Після прив’язки надсилайте аналітичні запитання текстом або голосовим повідомленням до 2 хвилин. Бот покаже розпізнане запитання та відповість текстом.

КомандаДія
/startПочати роботу або завершити прив’язку за одноразовим посиланням.
/helpПоказати коротку довідку та приклади.
/companyОбрати компанію, якщо доступно декілька.
/statusПоказати поточну компанію та роль.
/usageПереглянути використання та місячні ліміти.
/newПочати діалог без попереднього контексту.
/unlinkБезпечно від’єднати Telegram.

Ролі та ліміти

Доступ визначається роллю в кожній компанії окремо. Ліміти пілоту задає platform-admin і вони можуть відрізнятися від стандартних.

OwnerКерує компанією, приймає юридичні документи та може змінювати доступ до контактних даних.
AdminКерує дозволеними налаштуваннями компанії та може працювати з аналітикою.
AnalystСтавить запитання, продовжує діалоги та оцінює відповіді.
ViewerПереглядає доступну історію без створення нових аналітичних запитів.
Для стандартного тесту передбачено до 100 запитів і 250 000 токенів на компанію за місяць, а також персональні та денні обмеження. Фактичне використання видно через `/usage` у Telegram та в інтерфейсі.

Що поки не підтримується

KeyScope чесно повідомить, якщо для відповіді ще немає безпечного аналітичного інструмента.

  • Автоматичне складання KeyCRM і Хорошоп без правила дедуплікації.
  • Залишки складу, закупівлі, повернення та логістика.
  • Ефективність менеджерів.
  • Рекламні витрати, кліки, покази, ROAS і конверсія відвідувачів: UTM-звіт містить лише замовлення та виручку.
  • Прогнози майбутніх продажів та автоматичне доведення причин падіння або зростання.
  • Масові вивантаження сирих замовлень або персональних даних.
  • Дуже великі періоди, що перевищують установлені безпечні межі читання API.
Якщо відповідь здається неточною, перевірте період і критерій, поставте уточнення та позначте відповідь 👎 із причиною. Це найкорисніший сигнал для розвитку сервісу.