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

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

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

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

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

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

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

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

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

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

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

Оплати

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Telegram

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

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

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

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

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

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

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

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