Как работать с Kelvaro

1 Быстрый старт

1. Зарегистрируйтесь по почте или через Google. Администратор проверит аккаунт и активирует доступ — обычно в течение рабочего дня.
2. Подключите рекламный кабинет в разделе «Проекты» кнопкой «Подключить» — площадка сама попросит войти и выбрать кабинеты.
3. Добавьте коннектор в Claude: Settings → Connectors → Add custom connector, вставьте ссылку ниже и подтвердите доступ входом в Kelvaro.

2 Подключение площадок

Все площадки подключаются через их собственный вход (OAuth): вы входите в кабинет площадки и отмечаете, к чему дать доступ. Пароли и ключи вводить не нужно. Один проект в Kelvaro — одна площадка; кабинетов в проекте может быть несколько.

Кабинет можно отключить сам — крестиком у кабинета в «Проектах». Доступ на стороне площадки отзывается в её настройках.

3 Коннектор в Claude

После подключения Claude видит проекты всех ваших площадок сразу и читает статистику любой из них — те же цифры, что в отчётах кабинета. Что ещё он умеет, зависит от площадки:

Новые кампании и объявления создаются выключенными: запуск — отдельной командой после вашего подтверждения.

Примеры вопросов

• «Сколько потратили и сколько лидов получили за неделю — по всем площадкам?»
• «Какая площадка за месяц принесла больше продаж и выручки на вложенный тенге — Google Ads или Яндекс Директ?»
• «Какие кампании в TikTok окупаются, а какие только собирают клики?»
• «Разбей расходы Meta по возрасту и полу за 30 дней.»
• «Подними дневной бюджет кампании „Весна“ на 20%.»
• «Собери кампанию на трафик в WhatsApp, аудитория — Алматы, 25–45.»
• «Куда переложить бюджет за последние 30 дней и что это даст?»
• «Что будет с продажами, если поднять бюджет кампании „Весна“ на 30%?»
• «Какие объявления несут продажи, а какие только тратят бюджет?»
• «Как проект выглядит на фоне других в нише и какой у кабинета индекс здоровья?»

Если проектов несколько, Claude спросит, с каким работать, или найдёт нужный по названию.

Не только Claude

Коннектор подходит и другим ИИ-ассистентам, которые умеют подключать внешние коннекторы (MCP): ChatGPT, Gemini, Cursor и другим. Добавьте в ассистенте ту же ссылку коннектора и войдите в Kelvaro, когда он попросит подтвердить доступ.

4 Отчёты

Раздел «Отчёты» собирает расходы, показы, клики, охват, лиды, продажи и выручку по проекту за выбранный период, считает цену лида и продажи, сравнивает с прошлым периодом и пишет выводы. Отчёт скачивается в PDF и CSV.

При двух и более проектах есть сводный отчёт по всем сразу — с разбивкой по проектам. Суммы в разных валютах не складываются: в этом случае показывается только разбивка.

Кнопка «?» рядом с суммой открывает окошко с пересчётом в любую валюту по официальному курсу Национального банка РК на сегодня — удобно сравнить площадки, которые считают в разных валютах.

5 Сводка и сигналы в Telegram

Подключите бота в «Интеграциях» — и каждое утро получайте сводку по проектам, а новые лиды из лид-форм Meta и Google Ads — сразу, как они приходят.

Сводка начинается с сигналов — того, на что стоит посмотреть:

• Реклама встала — вчера не было показов.
• Перерасход — расход вдвое выше обычного.
• Отдача просела — заявка или продажа обходится в полтора раза дороже обычного: повод проверить, не ушла ли реклама к случайной аудитории.
• Расход без результата — деньги ушли, лидов нет.

Сигналы молчат на малых объёмах, чтобы не шуметь по пустякам.

6 Ссылки с меткой

В разделе «Ссылки» создайте короткую ссылку на свой WhatsApp или Telegram и поставьте её в рекламу Google, Яндекса или TikTok. Каждый переход считается, а первое сообщение несёт метку — так видно, с какого объявления пришёл человек.

• WhatsApp — метка добавляется в текст приветствия.
• Telegram — метка уходит в параметр бота и не видна в переписке.
• Архив выключает ссылку, но сохраняет статистику; удаление убирает её из списка.

7 Продажи из переписки

Продажа в WhatsApp или Instagram для Meta невидима — пикселя там нет. Ваша CRM или сервис переписки сообщает Kelvaro об оплаченной сделке, а мы передаём её в Meta Conversions API. Meta привязывает продажу к объявлению и учится искать тех, кто покупает.

• Нужен API-ключ с правом «передача продаж» (галочка при выпуске).
• Номер WhatsApp — официальный (WhatsApp Business Platform); номер, подключённый по QR-коду, не подходит.
• Если одна и та же сделка придёт дважды, продажа не задвоится.

8 Журнал решений

Каждое изменение бюджета или статуса, сделанное через Claude или кнопкой в Telegram, записывается в журнал — с названием объекта, прежним и новым значением. Журнал виден в разделе «Журнал» («Решения и их эффект») и карточкой «Последнее решение» на главной.

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

Как читать вердикт

• Главная мера — отдача: окупаемость (ROAS), а без выручки — цена продажи. Заявки сравниваются только когда продаж нет совсем, и с оговоркой: сверьте, сколько из них дошло до оплаты.
• Сдвиг меньше 10% — «без заметного эффекта»: это не успех и не провал.

Это не A/B-тест. Сезонность, праздники, другие правки в тот же период и новые креативы влияют на результат не меньше бюджета. Читайте вердикт как подсказку, а не как доказательство.

9 Советник бюджета и прогноз

Два инструмента отвечают на вопросы «куда переложить бюджет» и «что будет, если…». Они только считают — в кабинетах ничего не меняют; изменение вносится отдельной командой после вашего «да».

• Куда переложить бюджет — где деньги работают лучше, а где хуже, и как перераспределить бюджет между кампаниями.
• Что будет, если… — прогноз для вашего сценария: «что будет, если поднять бюджет кампании на 30%».

Расчёт строится на убывающей отдаче: каждая следующая потраченная сумма приносит чуть меньше, чем предыдущая. Расчёт опирается на ежедневную историю проекта. Прогноз всегда даётся диапазоном — от осторожного до оптимистичного — и с уровнем уверенности. Если данных мало (меньше недели с тратами или нет связи расхода с результатом), мы честно говорим «уверенность низкая» и считаем грубее. Результат выбирается по отдаче: выручка, затем продажи, затем лиды; разные валюты не сравниваются.

• «Куда переложить бюджет за последние 30 дней?»
• «Что будет с продажами, если поднять бюджет кампании „Весна“ на 30%?»

10 Креативы

Ассистент собирает статистику по объявлениям (только Meta) — продажи, выручку, окупаемость — а Claude разбирает, какой крючок, формат и оффер работают лучше, и предлагает, что снимать дальше.

• «Какие объявления несут продажи, а какие только тратят бюджет?»
• «Какой тип креатива сработал лучше всего — и что снять следующим?»

11 Готовые сценарии

Пять готовых сценариев лежат в Claude в меню промптов коннектора: в чате нажмите «+» и выберите коннектор Kelvaro. В каждом правило: ничего не менять в рекламе без вашего явного «да», а оценивать по продажам, а не по цене заявки.

• Аудит кабинета — общий разбор: вердикт, слабые и сильные кампании, куда утекает бюджет, 3–5 действий.
• Подготовка к акции — что проверить и подготовить перед стартом распродажи.
• Разбор провала недели — почему отдача просела и что с этим делать.
• Куда переложить бюджет — советник бюджета по вашим кампаниям.
• Что снимать дальше (креативы) — выводы по объявлениям и идеи для следующей съёмки.

12 Кнопки в Telegram

Если кампания три дня подряд тратит бюджет без продаж, утренняя сводка предлагает решение кнопками: «Поставить на паузу» или «Оставить». Нажатие на паузу останавливает кампанию на площадке и записывается в журнал решений; предложение действует 48 часов, повторное нажатие паузу не продублирует.

• Кнопки работают только в личном чате с ботом — в том, который вы привязали в «Интеграциях». Пересланное сообщение чужому ничего не даст.
• Предложение приходит, только если в проекте есть продажи: иначе «ноль продаж» может значить «передача продаж не настроена».
• У TikTok, Google Ads и Яндекс Директа предложение создаётся только если в проекте один кабинет — угадывать, в каком ставить паузу, мы не будем. У Meta пауза идёт по кампании.
• Если площадка не ответила, мы так и скажем и ничего не повторим вслепую — остановите кампанию вручную.

13 Индекс здоровья

Одна цифра от 0 до 100 и список «что поправить». Считается по последним 30 дням и учитывает, в первую очередь, отдачу:

Пункт в норме даёт вес целиком, с замечанием — половину, с проблемой — ноль. Если данных по пункту нет, он пропускается, а остальные пересчитываются. Нет расхода — индекса нет вовсе, а не «ноль».

Индекс виден на главной странице кабинета и обновляется раз в сутки; ассистент посчитает его по запросу: «какой у кабинета индекс здоровья?»

14 Календарь сезонов

Календарь знает главные поводы для рекламы в Казахстане: Новый год, 14 февраля, 8 марта, Наурыз, майские праздники, День столицы, «Снова в школу», 11.11, Чёрная пятница, Курбан айт и День Независимости. Даты Курбан айта — ориентировочные: они зависят от лунного календаря.

За 14 дней до события в утренней сводке приходит блок «Скоро сезон» — один раз на событие. В нём сравнение с теми же днями прошлого года: «тогда ROAS был в 1,6 раза выше обычного». Нет продаж — сравнение по заявкам с оговоркой, нет данных — общий совет. Спросить можно и у Claude: «какие сезоны впереди?»

15 Режим агентства

Агентство отдаёт отчёты своим клиентам под своим именем.

• Лейбл — название и логотип (PNG или JPEG до 512 КБ) в «Настройки → Агентство». В PDF-отчётах и на публичной странице вместо Kelvaro подставляется ваш бренд. Правит только владелец.
• Ссылка для клиента — в разделе «Отчёты». Выпускают владелец и сотрудники с ролью «Управление»; выбираются проект (или все сразу), период и срок действия: 7, 30 или 90 дней. Полный адрес показывается один раз.
• Отзыв — ссылку можно отозвать в любой момент, она перестанет открываться сразу.
• Что видит клиент — страницу с отчётом без входа и без разделов кабинета: расходы, продажи, окупаемость, выводы. Токенов площадок и идентификаторов кабинетов там нет; скачать PDF и CSV он не может.

16 Сравнение с нишей

Укажите нишу проекта в разделе «Проекты» — и в отчёте за месяц у окупаемости и цены продажи появится бейдж вроде «лучше, чем у ~70% кофеен». Спросить можно и у ассистента: «как проект выглядит на фоне других в нише?»

• Бейдж появляется, только когда в группе (ниша, площадка, валюта) не меньше пяти разных клиентов. Меньше — показываем «данных мало», и это нормально.
• Анонимность: хранятся лишь итоговые показатели группы. Чужих проектов, имён и значений никто не видит, а ваши цифры сравниваются на лету и в общую базу не попадают. Несколько проектов одного клиента считаются за одного.
• Это грубая оценка: процент округляется, а группы с разными валютами не смешиваются.

17 API

Ваша CRM или другой сервис может получать статистику ваших проектов по ключу. Выпустите ключ в «Интеграциях» — он показывается один раз — и передайте его вместе со ссылкой на справочник тому, кто настраивает сервис. Отозвать ключ можно в любой момент.

Справочник API для разработчика →

18 Тарифы

Считается подключённый кабинет, а не проект и не запросы. Кабинет попадает в счёт месяца, если был подключён хотя бы день. Отключение в середине месяца текущий счёт не уменьшает, повторное подключение того же кабинета ничего не добавляет. Запросы к Claude, отчёты и пользователи — без ограничений.

Оплата — в разделе «Подписки»: кнопка выставляет счёт на остаток месяца (сумма считается автоматически) и ведёт на оплату картой. Пока онлайн-оплата не подключена, счёт оплачивается через администратора. Все счета и их статусы видны там же.

19 Безопасность

• Доступ к площадкам — только через их официальный вход; пароли от кабинетов мы не видим.
• Токены площадок хранятся зашифрованными, API-ключи — только в виде отпечатка.
• Отключить кабинет, коннектор или ключ можно в любой момент в кабинете Kelvaro.
• Команда: владелец приглашает коллег в «Настройки → Команда» с ролью «Просмотр» или «Управление». Интеграции, подписка и API-ключи остаются только у владельца. Коннектор Claude участник подключает к своему аккаунту, а не к кабинету владельца.
• Подробности — в политике конфиденциальности.

20 Вопросы и ответы