ИИ-помощник менеджера

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

Самое нужное для каждой роли. Подробности — по ссылкам под карточками.

ИИ-анализ оплачивается с баланса вашей компании в SpeShu.AI: примерно 0,7–0,9 ₽ за разбор на уровне «Эконом» и 1,4–2,6 ₽ на «Стандарте». Подробнее о стоимости.

Что умеет

Помощник — блок «ИИ-помощник» в правой колонке карточки сделки. Он строит разбор сделки и показывает его блоками. В сообщениях панели и в отчётах разбор называется «рекомендации».

• Саммари

  Где сделка сейчас и что важно — в 2–4 предложениях. Удобно, чтобы быстро войти в контекст или передать сделку коллеге.

• Следующий шаг

  Одно конкретное действие: тип, канал, срок и обоснование. Если шаг — написать в чат или по email, к нему есть черновик сообщения клиенту.

• Вопросы клиенту

  3–5 вопросов, которые закрывают пробелы квалификации. Строятся по технике вопросов вашей компании.

• Возражения

  Что клиент уже сказал и что может сказать. Ответ берётся из библиотеки возражений компании и адаптируется к сделке, а если подходящего нет, его предлагает ИИ.

• Риски

  До 5 рисков с уровнем («риск высокий», «средний», «низкий») и подсказкой, что сделать.

• Расчёт стоимости

  Цена по базе знаний, скидки по их порогам и вывод, укладывается ли клиент в бюджет. Суммы считает сервис, а не ИИ.

• Квалификация и этап

  Проверка по чек-листу компании (SPIN, BANT, MEDDIC или свой) и по критериям выхода с этапа: чего не хватает для перехода.

• Температура

  «горячая», «тёплая», «холодная» или «замороженная», балл из 100 и факторы. Балл считается по эвристике, вероятность закрытия сделки он не показывает.

• Пробелы данных

  Чего не хватило для уверенного вывода: например, неизвестен бюджет или нерасшифрованы звонки.

• Звонки

  Если администратор включил анализ звонков, записи расшифровываются, а разбор ссылается на фрагмент разговора с таймкодом. Расшифровка на реальных записях телефонии ещё проверяется (подробнее).

• Задача и примечание

  Задача по следующему шагу и примечание с саммари создаются по кнопке менеджера, после предпросмотра и правки.

• Отчёты для руководителя

  «Использование», «Расходы на ИИ» и «Радар рисков». Радар считается без ИИ и бесплатен.

• Контроль расходов

  Три уровня моделей, лимиты расходов в день и в месяц, лимит обновлений в час на пользователя.

Чего помощник не делает сам

• Не пишет клиенту. Черновик сообщения можно только скопировать кнопкой Скопировать текст. Вставить его в чат или письмо и отправить менеджер должен сам: вставлять текст в поле чата amoCRM помощник не умеет.
• Не меняет CRM без клика. Задачу или примечание создаёт менеджер кнопкой после предпросмотра. Сменить этап, заполнить поле или записать что-то в сделку автоматически помощник не может.
• Не придумывает условия для клиента. Цены, скидки, сроки и условия он берёт только из базы знаний компании. Чего там нет, он отмечает как пробел данных. Как любая языковая модель, помощник может ошибиться — проверяйте цифры и черновики перед отправкой клиенту.
• Не пересчитывает разбор в фоне. Разбор не пересчитывается по таймеру, а открытая панель не меняется сама, когда приходит новое сообщение. Подробнее — в разделе «Когда пересчитывается разбор». В фоне работает только анализ звонков: если он включён, записи расшифровываются по мере поступления.

Как это работает

1. 1 · amoCRMСобытия сделкиСообщения, звонки, примечания, задачи, смена этапа и полей приходят по вебхукам. Раз в 15 минут интеграция сверяет события с amoCRM и добирает пропущенное.
2. 2 · Сервер интеграцииЛента и память сделкиИстория хранится на сервере интеграции. Перед отправкой в ИИ телефоны и email по умолчанию маскируются.
3. 3 · SpeShu.AIЯзыковая модельЗапрос уходит по API-ключу вашей компании и оплачивается с её баланса.
4. 4 · Карточка сделкиРазбор с источникамиМенеджер видит блоки разбора. Задачи и примечания создаёт сам, по кнопке.

Откуда берутся данные

• Лента сделки. Сразу после установки интеграция подписывает аккаунт на вебхуки amoCRM и начинает собирать события сделок: сообщения, звонки, примечания, задачи, смену этапа, ответственного и полей. Сбор идёт ещё до подключения ключа SpeShu.AI. В ИИ данные уходят только после того, как администратор подключил ключ и принял уведомление о передаче данных.
• Тексты чатов помощник видит только с момента установки и только на тарифе amoCRM «Расширенный» и выше. О более ранних сообщениях он знает лишь сам факт сообщения, без текста. Подробнее — в разделе «Ограничения и тарифы amoCRM».
• Почта — только темы входящих писем.
• Звонки — если администратор включил анализ звонков: запись скачивается по ссылке из примечания о звонке и расшифровывается сразу, по мере поступления.
• Настройки компании — методика, цели этапов, база знаний и библиотека возражений. Они уходят в каждый запрос.

В запрос к модели входят: «память сделки» (сжатая история), карточка сделки (название, воронка и этап, бюджет, ответственный, теги, источник, дополнительные поля), имена контактов и их поля вроде должности, название и поля компании, до 10 открытых задач, сигналы (сколько клиент ждёт ответа, сколько дней сделка на этапе, звонки за 14 дней и т. п.), последние события ленты, саммари звонков и расшифровки двух последних расшифрованных звонков (длинные обрезаются примерно до 6000 символов). Телефоны, email и мессенджеры из карточек контактов в запрос не попадают.

На каких данных основан разбор, видно в строке статуса панели — после слова «покрытие:». Например:

покрытие: тексты чатов с 01.09.2026, 4 сообщ. без текста, звонки 2 из 3 расшифрованы, недоступно записей: 1, почта: только темы писем

Источники

Рядом с утверждениями о сделке стоят кнопки-источники с короткими подписями:

примечание 02.10 звонок 03.10, 06:40 сообщение клиента 29.09 контакт Ольга Ветрова поле «Бюджет» звонки за 14 дн.

• Если подписи совпадают, к ним добавляется время («примечание 02.10 в 14:20»), а если совпадает и время — номер. Подпись длиннее 40 символов обрезается.
• Клик по кнопке раскрывает под утверждением карточку источника: вид события, дату и время, таймкод для фрагмента звонка и выдержку текста до 200 символов. Повторный клик её закрывает. Одновременно открыта одна карточка.
• Кнопка не переходит к событию в ленте amoCRM и не включает запись звонка: всё показывается текстом прямо в панели.
• Для сигнала по сделке карточка показывает «Сигнал по сделке», название сигнала и его значение, например «Дней на текущем этапе» и «12».
• Если источник взят из карточки контакта или компании, к которой у пользователя в amoCRM нет доступа, вместо выдержки написано: Текст скрыт: в amoCRM у вас нет доступа к карточке контакта или компании, откуда взят этот источник. Администратор видит выдержки всегда.

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

• ссылки на источники, которых нет в данных расчёта, удаляются;
• факторы температуры и риски без источника не показываются;
• критерий квалификации без источника получает статус «неизвестно»;
• прозвучавшее возражение без источника показывается как «ожидается»;
• цитата клиента, которой нет в тексте источника, удаляется.

У саммари, вопросов клиенту и блока «Почему так» источников нет. Следующий шаг тоже может быть без них.

Когда пересчитывается разбор

• Первый разбор запускает менеджер. При открытии сделки, по которой разбора ещё нет, панель пишет «Рекомендаций по этой сделке ещё нет.» и показывает кнопку Рассчитать.
• Разбор устаревает, когда: приходит новое сообщение в чате, SMS или письмо; появляется новый звонок или готова его расшифровка; меняется этап или ответственный; меняются задачи; добавлено примечание; меняется сделка (например, бюджет); администратор поменял методику, этапы, базу знаний или возражения. Задачи и примечания, созданные из самой панели, разбор устаревшим не делают. Изменение лимитов, доступа и уровня моделей — тоже.
• Автоматический пересчёт бывает только в одном случае: при открытии карточки, если разбор устарел и пересчёт сейчас разрешён (ключ подключён, уведомление принято, лимиты не исчерпаны, ИИ-сервис доступен). За одно открытие карточки — не больше одного раза. Такой пересчёт платный и засчитывается в лимит обновлений в час.
• Всё остальное время — кнопка Обновить. Таймеров и фонового пересчёта нет. Если клиент написал, пока карточка открыта, панель сама не изменится: переоткройте карточку или нажмите Обновить.
• Долгий расчёт. Сервер ждёт ответа модели до 45 секунд. Если расчёт идёт дольше или эту сделку уже пересчитывает кто-то другой, панель пишет «Рекомендации считаются. Нажмите «Проверить готовность» через минуту.». Сама панель сервер не опрашивает.
• Без изменений. Если в тот же день с прошлого расчёта ничего не изменилось, Обновить вернёт прежний результат без нового запроса к модели. Время «Обновлено …» не изменится, но нажатие засчитается в лимит обновлений в час. На следующий день или когда сигналы сделки перейдут в другой диапазон (например, клиент ждёт ответа больше суток), пересчёт будет платным, даже если новых событий не было.

Разбор один на сделку и общий для всех, кто её открывает.

Установка и первый запуск

1. Установите интеграцию

   Найдите «ИИ-помощник менеджера» в маркетплейсе интеграций amoCRM и установите её от имени администратора. После установки интеграция получает доступ к аккаунту и сама подписывает его на вебхуки amoCRM — с этого момента начинает собираться лента сделок.

   Стоимость самой интеграции: [TODO: стоимость интеграции и условия пробного периода].

2. Откройте страницу настроек помощника

   Перейдите в «Настройки → ИИ-помощник: настройки», вкладка «Подключение SpeShu». В стандартном окне настроек виджета есть только поле «Подключение ИИ (SpeShu.AI)» со статусом ключа и подсказкой, куда идти.

   На вкладке есть мастер «Как подключить» из 5 шагов. Ниже — те же шаги подробнее.

3. Зарегистрируйтесь в SpeShu.AI и пополните баланс

   Регистрация — на speshu.ai. Баланс пополняется в личном кабинете SpeShu.AI: картой (от 100 ₽) или по СБП деньги зачисляются сразу, по счёту для юрлиц — через 1–2 рабочих дня после оплаты.

4. Создайте API-ключ

   В личном кабинете (speshu.ai/profile) создайте отдельный ключ с названием «amoCRM ИИ-помощник» и сроком «Без срока действия». Значение ключа SpeShu.AI показывает один раз — скопируйте его сразу.

5. Вставьте ключ и проверьте его

   Вставьте ключ в поле «API-ключ SpeShu.AI» и нажмите Сохранить и проверить. Интеграция проверяет ключ запросом баланса в SpeShu.AI. Если всё в порядке, появится сообщение «Ключ сохранён и проверен.», а в статусе — «подключён».

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

6. Примите уведомление о передаче данных

   Внизу вкладки прочитайте «Уведомление о передаче данных»: что уходит в SpeShu.AI и дальше провайдеру модели. Поставьте галочку «Я администратор аккаунта, ознакомился с уведомлением и подтверждаю передачу этих данных в SpeShu.AI» и нажмите Принять уведомление. Пока уведомление не принято, ИИ-анализ выключен.

7. Проверьте генерацию (по желанию)

   Проверить запросом отправляет один короткий платный запрос к модели и показывает модель, время ответа, токены и стоимость.

8. Настройте помощника под компанию

   Пройдите вкладки «Методика и критерии», «Этапы», «База знаний», «Возражения», «Модели, лимиты и звонки» и «Доступ» и нажмите Сохранить настройки. Без этого помощник работает с настройками по умолчанию: чек-лист BANT, вопросы по SPIN, уровень «Стандарт», доступ всем пользователям, лимиты расходов не заданы. Чем подробнее база знаний, тем точнее подсказки. Подробно о вкладках — в разделе «Для администратора».

9. Запустите первый разбор

   Откройте любую сохранённую сделку. В правой колонке появится блок «ИИ-помощник» с текстом «Рекомендаций по этой сделке ещё нет.». Нажмите Рассчитать. Первый расчёт собирает историю сделки из amoCRM и строит «память сделки», поэтому может занять больше времени, чем следующие. Если он идёт дольше 45 секунд, нажмите Проверить готовность через минуту.

Для менеджера

Помощник находится в правой колонке карточки сделки, в блоке «ИИ-помощник». В карточках контактов, компаний, покупателей и в списках его нет.

• В новой, ещё не сохранённой сделке помощник просит: «Сохраните сделку, чтобы помощник смог разобрать её историю.»
• Если вы видите «Помощник не включён для вашего пользователя. Обратитесь к администратору аккаунта.», администратор не отметил вас на вкладке «Доступ».
• Если вы видите «У вас нет доступа к этой сделке.», у вас нет прав на эту сделку в amoCRM или ваш пользователь amoCRM бесплатный либо отключён.

Строка статуса

Вверху панели — строка статуса, например:

Обновлено 12 мин назад · этап «Переговоры» · по плану · покрытие: тексты чатов с 01.09.2026, звонки 3 из 3 расшифрованы

• Обновлено … — когда рассчитан разбор: «только что», «N мин назад», «N ч назад», дальше дата. Время считается при отрисовке и само не меняется.
• этап «…» — текущий этап сделки в amoCRM.
• Оценка этапа: «по плану», «застряла», «готова к переходу», «под угрозой» или «не на своём этапе». Если сделку после расчёта перевели на другой этап, старая оценка не показывается. «Застряла» ставится, только если сделка на этапе 7 дней и больше. «Готова к переходу» — только когда подтверждены все критерии выхода с этапа.
• покрытие: — на каких данных основан разбор (подробнее).
• Кнопка в конце строки: Рассчитать, если разбора ещё нет, или Обновить, если он есть. Кнопка видна, только когда пересчёт сейчас возможен. Во время пересчёта вместо неё написано «Обновляем…».

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

Блоки разбора

Кнопки

Если копирование не удалось, появится подсказка «Не удалось скопировать: выделите текст и нажмите Ctrl+C.».

Задача и примечание

Как создать задачу

1. Нажмите Создать задачу под следующим шагом (она же есть в окне «Разбор сделки»).
2. Откроется окно «Задача по сделке» с пояснением «Задача будет создана в этой сделке от вашего имени. Проверьте текст и срок.».
3. Проверьте поля:
   • «Текст задачи» — заполнен действием следующего шага, его можно править (до 1000 символов);
   • «Срок» — дата и время. По умолчанию — по сроку шага: «сегодня» — сегодня, «завтра» — завтра, «на этой неделе» — пятница этой недели (с пятницы по воскресенье — сегодня), «до …» — эта дата; время 18:00. Если 18:00 уже прошло — ближайший следующий час. Время — в часовом поясе вашего браузера. Срок не может быть в прошлом и дальше чем через год;
   • «Тип задачи» — из типов задач вашего аккаунта. По умолчанию для звонка (или шага по телефону) — «Звонок», для встречи — «Встреча», для остального — «Связаться». Если нужного типа нет, выбирается «Связаться», а если нет и его, первый тип аккаунта.
4. Нажмите Создать задачу в окне. Появится «Задача создана.», поля и кнопка заблокируются, чтобы не создать дубль.

Это обычная задача amoCRM в этой сделке. Она создаётся от вашего имени, с вашими правами в amoCRM, ответственный — вы.

Если открытая задача сделки уже покрывает следующий шаг, вместо кнопки будет строка вида «Задача уже поставлена: «Отправить расчёт…» · срок 05.10, 18:00». Задача, которую вы только что создали из панели, появится в этой строке не сразу: после переоткрытия карточки и когда до интеграции дойдёт вебхук amoCRM о новой задаче. Когда задачу выполнят, кнопка Создать задачу вернётся.

Как добавить примечание

1. Нажмите Подробнее, а в окне «Разбор сделки» — Добавить саммари в примечание. В самой панели такой кнопки нет.
2. Откроется окно «Примечание в сделку». Поле «Текст примечания» заполнено саммари, его можно править (до 5000 символов).
3. Нажмите Добавить примечание. Появится «Примечание добавлено.».

Это обычное текстовое примечание в этой сделке от вашего имени.

Оценки «Полезно», «Не полезно», «Выполнено»

• Полезно и Не полезно есть на блоках «Саммари», «Температура», «Следующий шаг», «Вопросы клиенту», «Возражения», «Риски», «Квалификация» и «Почему так». Выбрать можно что-то одно, повторный выбор меняет оценку.
• Выполнено есть у следующего шага и у каждого вопроса клиенту. Это только отметка для отчёта: она не закрывает и не создаёт задачу в amoCRM.
• Оценки сохраняются на сервере, и администратор или РОП видит их в отчёте «Использование». После перезагрузки страницы нажатые кнопки не подсвечены, но оценка сохранена.

Когда нажимать «Обновить»

• Когда видите «Есть новые данные (…): рекомендации устарели.», а автоматический пересчёт не запустился.
• Когда клиент написал или позвонил, пока карточка была открыта.
• Не нажимайте без необходимости: у каждого пользователя есть лимит обновлений в час (по умолчанию 20), и в него входят и автоматические пересчёты при открытии карточки. Кроме того, действует техническое ограничение — не больше 6 пересчётов в минуту.

Для администратора

Все настройки — на странице «Настройки → ИИ-помощник: настройки». В стандартном окне настроек виджета есть только поле «Подключение ИИ (SpeShu.AI)» со статусом ключа.

Вкладки страницы: «Подключение SpeShu», «Методика и критерии», «Этапы», «База знаний», «Возражения», «Модели, лимиты и звонки», «Доступ», «Отчёты».

Роли

Вкладка «Подключение SpeShu»

Вкладка начинается с пояснения: «Помощник обращается к языковым моделям через SpeShu.AI с ключом вашей компании. Запросы оплачиваются с вашего баланса в SpeShu.AI.» Дальше — блок «Статус ключа SpeShu.AI», мастер «Как подключить», поле ключа и уведомление о передаче данных.

Статус ключа

Строка статуса состоит из частей, например: подключён · ключ …a1b2c3 · баланс 1 250,00 ₽ · проверен 05.10.2026, 10:15

• Состояния: «не подключён», «подключён», «ключ не принят», «у ключа нет прав», «недостаточно средств», «не проверен».
• «ключ …» — последние 6 символов ключа. Сам ключ в браузер не возвращается.
• «баланс» виден только администратору. Это сумма на момент последнего нажатия Сохранить и проверить, с тех пор остаток мог измениться. Проверить запросом баланс не обновляет.
• Сразу после Сохранить и проверить в конце может быть «последняя ошибка: …» с техническим кодом, например no_funds. После перезагрузки страницы этой части нет.

Кнопки

• Сохранить и проверить — проверяет ключ запросом баланса в SpeShu.AI и сохраняет его. Ключ, который SpeShu.AI не принял или у которого нет прав, не сохраняется. Поле ключа после нажатия очищается; если запрос не прошёл, ключ возвращается в поле.
• Проверить запросом — один короткий платный запрос к модели. Показывает модель, время в секундах, соответствие ответа JSON-схеме, токены и стоимость. Запрос попадает в отчёт расходов как «Проверка ключа». После успешной проверки ключ переходит в статус «подключён».
• Удалить ключ — нужно нажать дважды: после первого нажатия кнопка пишет «Нажмите ещё раз, чтобы удалить». Ключ удаляется из базы на сервере, функции ИИ отключаются. В ночных резервных копиях базы его зашифрованная копия хранится до 14 дней, поэтому если ключ мог попасть к посторонним, отзовите его и в личном кабинете SpeShu.AI. SpeShu.AI показывает значение ключа один раз, так что для повторного подключения понадобится новый ключ.

Уведомление о передаче данных

Уведомление объясняет, какие данные уходят в SpeShu.AI, что SpeShu.AI передаёт запрос провайдеру модели или распознавания речи (провайдер может находиться за пределами России) и что компания как оператор персональных данных отвечает за правовые основания такой передачи. Ниже — ссылка «Политика конфиденциальности».

Принимает уведомление только администратор: галочка «Я администратор аккаунта, ознакомился с уведомлением и подтверждаю передачу этих данных в SpeShu.AI», затем Принять уведомление. Интеграция запоминает, кто и когда принял уведомление. У уведомления есть версия. Когда выходит новая, ИИ-анализ снова блокируется, пока администратор не примет её.

Вкладка «Методика и критерии»

Методика задаёт, по каким критериям помощник проверяет квалификацию сделки и какие вопросы предлагает задать клиенту.

• «Чек-лист квалификации»: SPIN, BANT, MEDDIC или «Свой чек-лист». По умолчанию — BANT. Выбор готового чек-листа целиком заменяет текущие критерии.
  • SPIN: Ситуация, Проблема, Последствия, Выгода.
  • BANT: Бюджет, Полномочия, Потребность, Сроки.
  • MEDDIC: Метрики, Экономический покупатель, Критерии решения, Процесс решения, Боль, Чемпион.
• «Техника вопросов»: «SPIN: ситуация, проблема, последствия, выгода» (по умолчанию) или «Своя: вопросы по критериям чек-листа». Если выбрали «Своя», опишите технику в поле «Дополнительные указания по методике» — модель будет ориентироваться на него.
• «Критерии квалификации»: у каждого критерия есть код («код budget», у новых — c1, c2…), «Название» (обязательно, до 120 символов) и «Что считается выполнением» (до 1000). Описания готовых критериев можно править. Кнопки Удалить и Добавить критерий, всего не больше 30 критериев.
• «Дополнительные указания по методике» — до 2000 символов. Например: «в первом звонке обязательно выяснить, кто принимает решение».

Если удалить все критерии при выбранном готовом чек-листе, при сохранении вернутся критерии этого чек-листа. При «Своём чек-листе» без критериев сохранение не пройдёт. Новый критерий без названия тоже не даст сохранить настройки.

Вкладка «Этапы»

Для каждого этапа воронки укажите цель и критерии, которые должны быть выполнены для перехода дальше. Помощник покажет, чего не хватает.

• Этапы сгруппированы по воронкам. Этапы закрытия («Успешно реализовано» и «Закрыто и не реализовано») не показываются.
• «Цель этапа» — до 1000 символов. «Критерии выхода с этапа» — галочки из критериев вкладки «Методика и критерии».
• Этапы без цели и без критериев при сохранении отбрасываются. Критерии, удалённые из методики, убираются из этапов.
• В запрос к ИИ попадают этапы только той воронки, в которой находится сделка.
• Новые воронки и этапы amoCRM могут появиться на странице с задержкой до часа.

Вкладка «База знаний»

Помощник опирается на эти сведения. Условия для клиента он берёт только отсюда; чего здесь нет, он отметит как пробел данных.

Методика (критерии и указания), база знаний, возражения и цели этапов самой большой воронки вместе — не больше 60 000 символов: всё это уходит в каждый запрос к ИИ. При превышении сохранение отклоняется с указанием текущего объёма. Загружать файлы или ссылки на сайт нельзя — только текст в полях.

Вкладка «Возражения»

Типовые возражения клиентов и рекомендуемые ответы компании. Помощник выбирает подходящий ответ и адаптирует его к сделке.

• Поля карточки: «Возражение» (обязательно, до 200 символов) и «Рекомендуемый ответ» (до 2000). Кнопки Удалить и Добавить возражение, не больше 50 возражений.
• Пустые карточки при сохранении отбрасываются.
• В окне «Разбор сделки» видно, откуда ответ: из библиотеки компании или предложен ИИ.

Вкладка «Модели, лимиты и звонки»

Уровень моделей

У каждого уровня есть резервная модель на случай сбоя основной. Состав моделей может меняться. Уровень влияет только на расчёт разбора: «память сделки» и саммари звонков всегда считает самая дешёвая модель. Цены — ориентир, фактическая зависит от длины истории сделки (подробнее).

Лимиты расходов

• «Лимит расходов в день, ₽» и «Лимит расходов в месяц, ₽». Пустое поле — без лимита; по умолчанию оба пустые.
• В лимит идут все расходы ключа: расчёты разбора, память сделок, саммари и расшифровка звонков, проверки ключа.
• Когда лимит исчерпан, анализ приостанавливается до следующего периода. Новый запрос отправляется, только если расходы за период ещё меньше лимита, поэтому последний запрос может выйти за лимит на свою стоимость. Если стоимость запроса неизвестна (SpeShu.AI её не прислал и посчитать по токенам не удалось), в расходы записывается его максимальная цена: для разбора 5 ₽ на «Экономе», 15 ₽ на «Стандарте», 40 ₽ на «Премиуме». Пока идут другие запросы, они учитываются по максимальной цене: анализ может на время остановиться чуть раньше лимита, а вместе одновременные запросы выходят за лимит не больше чем на один запрос.
• Сутки и месяц считаются по UTC: новый день начинается в 03:00 по Москве.
• Под полями — сколько уже израсходовано за эти сутки и месяц: «Израсходовано сегодня: 8,50 ₽» и «Израсходовано в этом месяце: 120,00 ₽». Это те же суммы, что сверяются с лимитом: запросы, которые ещё идут, учтены по максимальной цене. Их видит администратор, а РОП — только при включённой галочке «Показывать менеджерам стоимость расчёта».
• Когда расходы за сутки или месяц доходят до 80% лимита, администратор видит в панели сделки предупреждение, например «Израсходовано 85% дневного лимита (8,50 ₽ из 10,00 ₽)». Менеджерам оно не показывается. Если лимит не задан, предупреждения нет.

Ручных обновлений в час на пользователя

По умолчанию 20, можно от 1 до 1000. Засчитывается каждое нажатие Обновить или Рассчитать и автоматический пересчёт при открытии карточки — даже если вернулся прежний результат без запроса к модели. Отдельно действует ненастраиваемое ограничение: не больше 6 пересчётов в минуту на пользователя.

Звонки

• Галочка «Расшифровывать и анализировать записи звонков», по умолчанию выключена. Под ней предупреждение: «Записи звонков передаются в SpeShu.AI и далее провайдеру распознавания речи. Включайте, только если клиенты предупреждены о записи разговора.»
• Пока анализ включён, записи обрабатываются автоматически, по мере поступления: все звонки аккаунта с записью, в сделках, контактах и компаниях, даже если сделку никто не открывает. Расшифровка и саммари платные.
• Расшифровка через SpeShu.AI на реальных записях телефонии ещё проверяется, поэтому анализ звонков может работать нестабильно.
• «Не анализировать звонки короче, секунд» — по умолчанию 20, от 0 до 3600.
• «Лимит минут звонков в месяц» — по умолчанию 600. Месяц считается по UTC.
• Пропускаются звонки короче порога, несостоявшиеся, повторы одной и той же записи и звонки сверх месячного лимита минут. Если выключить анализ, звонки в очереди тоже не обрабатываются.
• Требования к записям — в разделе «Ограничения и тарифы amoCRM», подраздел «Звонки».

Вкладка «Доступ»

• «Кому доступен помощник»: «Всем пользователям аккаунта» (по умолчанию) или «Только отмеченным в таблице». Если во втором режиме никто не отмечен, появляется предупреждение «Никто не отмечен: помощник выключен для всех пользователей.».
• Таблица пользователей со столбцами «Пользователь», «Помощник», «РОП». Список берётся из amoCRM и обновляется не чаще раза в час. Отметка «РОП» сама по себе не включает человеку помощник в режиме «Только отмеченным»: нужна ещё отметка «Помощник».
• «Показывать менеджерам стоимость расчёта» — по умолчанию выключено. Если включить, строку «стоимость расчёта …» в окне «Разбор сделки» увидят все пользователи помощника, а РОП получит доступ к отчёту «Расходы на ИИ». Администратор видит стоимость всегда.
• «Маскировать телефоны и email перед отправкой в ИИ» — по умолчанию включено (что именно маскируется).

Вкладка «Отчёты»

«Использование»

Сколько разборов рассчитано и просмотрено, как их оценили и сколько действий выполнено. Период — поля «С» и «По» (по умолчанию с 1-го числа месяца по сегодня, не длиннее года), кнопка Показать. Таблица «По пользователям»: «Рекомендаций», «Просмотров», «Полезно», «Не полезно», «Выполнено», «Задач создано», «Примечаний добавлено». Просмотр считается один раз на пользователя для каждого разбора.

Поле «Менеджер» — «Все менеджеры» (по умолчанию) или один пользователь аккаунта. С выбранным пользователем в отчёте только его просмотры, оценки, созданные задачи и примечания, а также разборы, рассчитанные по его запросу.

«Расходы на ИИ»

Расход с баланса SpeShu.AI вашей компании за месяц: поле «Месяц», кнопка Показать. В отчёте — «Итого», «Лимит на месяц» (или «без лимита»), прогноз «Баланса хватит примерно на N дн.» по среднему расходу за 7 дней и таблицы «По операциям» («Рекомендации», «Память сделок», «Саммари звонков», «Расшифровка звонков», «Проверка ключа») и «По дням». Если разработчик интеграции запускал по вашему ключу служебные проверки моделей, они видны как «Эксперимент E4» и «Эксперимент E5». Знак «≈» означает, что SpeShu.AI не прислал стоимость части запросов: она посчитана по токенам и ценам моделей, а если токенов нет (например, запрос оборвался), взята максимальная цена запроса, поэтому сумма может быть завышена.

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

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

«Радар рисков»

По менеджерам: сделки без следующей задачи, просроченные задачи, клиенты без ответа, застрявшие сделки. Считается без ИИ, бесплатно и без ключа SpeShu.AI. Кнопка Сформировать.

• Таблица: «Имя», «Без задачи», «Просроченных задач», «Клиент ждёт ответа», «Застряли на этапе». Ниже — сделки каждого менеджера с пометками «нет следующей задачи», «просроченная задача», «клиент ждёт ответа», «застряла на этапе», «срок задачи переносили».
• Пороги фиксированы: клиент ждёт ответа дольше 24 часов, сделка на этапе 14 дней и больше, срок задачи переносили 3 раза и больше за 30 дней. Порог 14 дней не связан с оценкой «застряла» в панели: там её ставит модель, и не раньше чем через 7 дней на этапе.
• Учитываются открытые сделки с ответственным, по которым были события после установки или которые открывали с помощником. Задачи — все открытые задачи по сделкам.

Выгрузка в Excel

Когда отчёт показан, над ним появляется кнопка Скачать для Excel. Файл — в формате CSV. Файл собирается в браузере из показанного отчёта, без нового запроса к серверу. Разделитель — точка с запятой, кодировка UTF-8: Excel с русскими региональными настройками открывает файл двойным щелчком, с русскими буквами и по колонкам.

• Имя файла — отчёт и период: usage_2026-10-01_2026-10-08.csv, spend_2026-10.csv, radar_2026-10-08.csv (у радара — дата выгрузки). Если выбран менеджер, в конце имени его ID в amoCRM: usage_2026-10-01_2026-10-08_456.csv.
• «Использование» — таблица по пользователям и строка «Итого».
• «Расходы на ИИ» — «Итого», «Лимит на месяц», таблицы «По операциям» и «По дням». Суммы — как их хранит сервер, до 4 знаков после запятой.
• «Радар рисков» — таблица по менеджерам и список сделок: «Менеджер», «ID сделки», «Сделка», «Пометки».
• Текст, который начинается с =, +, - или @ (например, название сделки «+7 999…»), выгружается с апострофом в начале, чтобы Excel не принял его за формулу.

Сохранение настроек

• Внизу вкладок «Методика и критерии», «Этапы», «База знаний», «Возражения», «Модели, лимиты и звонки» и «Доступ» — одна кнопка Сохранить настройки. Она сохраняет изменения всех вкладок сразу. При переходе между вкладками несохранённое не теряется, но предупреждения при уходе со страницы нет.
• После сохранения появится одно из сообщений: «Настройки сохранены (версия N).», «Настройки сохранены (версия N). Рекомендации пересчитаются при следующем открытии сделок.» или «Изменений нет: настройки остались прежними (версия N).».
• Второе сообщение бывает, когда изменились методика, этапы, база знаний или возражения. Тогда все разборы аккаунта помечаются устаревшими. В фоне они не пересчитываются: каждый пересчитается, когда сделку откроет пользователь с доступом к помощнику. Это платно и засчитывается в его лимит обновлений.
• Каждое сохранение с изменениями увеличивает номер версии. Версии хранятся на сервере, но просмотра истории и отката в интерфейсе нет.
• Если после открытия страницы настройки сохранил кто-то другой, появится «Настройки изменил другой пользователь. Обновите страницу и внесите свои изменения снова.». Введённое останется в форме — перенесите его после обновления страницы.
• Если поле заполнено неверно, сообщение может содержать техническое имя поля, например methodology.criteria.0.title — это первый критерий на вкладке «Методика и критерии».

Стоимость

Расходы состоят из двух частей: оплата самой интеграции и оплата запросов к ИИ в SpeShu.AI.

Интеграция

[TODO: стоимость интеграции, порядок оплаты и условия пробного периода]

Запросы к ИИ

Запросы к языковым моделям оплачиваются с баланса вашей компании в SpeShu.AI по его тарифам. Интеграция их не перепродаёт. Оплачиваются:

• расчёт разбора — при каждом нажатии Рассчитать или Обновить и при автоматическом пересчёте устаревшего разбора (если в тот же день ничего не изменилось, повторного запроса к модели нет);
• «память сделки» — сжатая история сделки. Она обновляется при расчёте разбора, а длинную историю интеграция дособирает после расчёта;
• расшифровка и саммари звонков — если включён анализ звонков. Записи обрабатываются автоматически, по мере поступления: все звонки аккаунта с записью, в сделках, контактах и компаниях, даже если сделку никто не открывает. Расход ограничивают порог длительности, «Лимит минут звонков в месяц» и лимиты расходов;
• кнопка Проверить запросом;
• служебные проверки моделей, если разработчик интеграции запускал их по вашему ключу (в отчёте «Расходы на ИИ» — «Эксперимент E4» и «Эксперимент E5»).

Проверка ключа при Сохранить и проверить — это запрос баланса без обращения к модели, в отчёт «Расходы на ИИ» она не попадает. Радар рисков считается без ИИ.

Ориентиры за один расчёт разбора

Это ориентиры: «Эконом» и «Стандарт» — по замерам, «Премиум» — оценка по ценам моделей, его не замеряли. Фактическая цена зависит от длины истории сделки и текущих цен моделей в SpeShu.AI. «Память сделки» и саммари звонков оплачиваются отдельно от расчёта, их считает самая дешёвая модель.

Звонки

Расшифровка записей оплачивается с баланса SpeShu.AI по его тарифам. Цену распознавания речи SpeShu.AI пока не публикует: [TODO: цена расшифровки за минуту записи в SpeShu.AI]. Для лимитов расходов интеграция заранее резервирует 2 ₽ за минуту записи. Фактические суммы видны в отчёте «Расходы на ИИ», операция «Расшифровка звонков».

Где видно, сколько потрачено

• В окне «Разбор сделки» — «стоимость расчёта» одного разбора: например «1,73 ₽», приблизительная — «≈ 7,79 ₽», меньше копейки — «< 0,01 ₽». Это только сам расчёт разбора, без памяти сделки и звонков. Администратор видит её всегда, менеджеры — если включено «Показывать менеджерам стоимость расчёта».
• В отчёте «Расходы на ИИ» — все расходы за месяц по операциям и по дням.

Как держать расходы под контролем

• Выберите уровень моделей под свои продажи.
• Задайте «Лимит расходов в день, ₽» и «Лимит расходов в месяц, ₽».
• Оставьте разумный лимит «Ручных обновлений в час на пользователя».
• Для звонков — порог длительности и «Лимит минут звонков в месяц».
• Раз в неделю смотрите отчёт «Расходы на ИИ».

Данные и безопасность

Ключ SpeShu.AI

• Вводит, проверяет и удаляет ключ только администратор аккаунта.
• Ключ хранится на сервере интеграции в зашифрованном виде: у каждой установки свой ключ шифрования, а главный ключ хранится отдельно от базы данных.
• В браузер ключ не возвращается: после сохранения видны только последние 6 символов.
• Ключ используется только для запросов к SpeShu.AI. В текстах ошибок SpeShu.AI он заменяется звёздочками.
• Ключ удаляется при нажатии Удалить ключ и при отключении интеграции. Его зашифрованная копия остаётся в ночных резервных копиях базы до 14 дней.

Что уходит в ИИ

Данные уходят в SpeShu.AI, только когда подключён ключ и принято уведомление о передаче данных. В каждый запрос входит то, что описано в разделе «Откуда берутся данные»: история общения по сделке (тексты сообщений, примечания, задачи, ход сделки), сведения о сделке, имена контактов и название компании, их дополнительные поля, саммари и расшифровки звонков, а также настройки компании.

Телефоны, email и мессенджеры из карточек контактов в запрос не попадают. При включённом анализе звонков записи передаются на распознавание речи целиком.

Маскирование

Настройка «Маскировать телефоны и email перед отправкой в ИИ» на вкладке «Доступ» включена по умолчанию. Перед отправкой в модель в текстах (история сделки, память, данные карточки, расшифровки и саммари звонков):

• email заменяется на [email];
• телефоны заменяются на [телефон]: российские номера в форматах +7, 8 и 9xx с обычными разделителями и международные номера со знаком «+».

Куда уходят данные

• SpeShu.AI получает данные по API-ключу вашей компании, в рамках вашего договора с SpeShu.AI, и передаёт запрос провайдеру языковой модели или распознавания речи. Провайдер может находиться за пределами России.
• По документации SpeShu.AI, по умолчанию сервис хранит только метаданные запросов (время, модель, токены) и не сохраняет их содержимое. Логи содержимого можно включить на самом ключе — тогда они хранятся 30 дней. Провайдеры моделей (например, OpenAI, Anthropic, Google) могут временно хранить запросы до 30 дней. Выбрать конкретных провайдеров в интеграции пока нельзя.
• Ваша компания как оператор персональных данных отвечает за правовые основания такой передачи, в том числе трансграничной.
• Сервер интеграции размещён: [TODO: где размещён сервер интеграции (страна, хостинг)].

Что хранится на сервере интеграции

• Лента событий сделок, включая тексты сообщений, расшифровки и саммари звонков, «память сделок», разборы, настройки и их версии, записи о принятии уведомления, журнал расходов.
• Аудиозаписи звонков хранятся в зашифрованном виде и удаляются сразу после успешной расшифровки, в любом случае — не позже чем через 7 дней.
• Срок хранения остальных данных и порядок их удаления: [TODO: сроки хранения и порядок удаления данных — по политике конфиденциальности].
• Политика конфиденциальности: amo.speshu.ai/privacy/.

Права пользователей

• Перед показом и расчётом сервер спрашивает у amoCRM, может ли пользователь открыть эту сделку. Ответ запоминается на 5 минут. Бесплатные и отключённые пользователи amoCRM доступа не получают.
• Панель работает только у тех, кого администратор включил на вкладке «Доступ».
• Задачи и примечания создаются от имени пользователя и с его правами в amoCRM.
• Историю сделки, её контактов и компании интеграция читает целиком, со своими правами доступа к аккаунту. Разбор один на сделку и общий для всех, кто её открывает.
• Выдержки из карточек контакта или компании, к которым у пользователя нет доступа, скрыты. Но модель при расчёте видела эти данные, и саммари или следующий шаг могут на них опираться.
• РОП в отчётах и радаре видит все открытые сделки аккаунта.

Тексты клиентов — не команды

Модель получает указание не выполнять инструкции из текстов клиентов, звонков и примечаний (это данные для разбора) и ссылаться только на источники из расчёта. Ссылки на несуществующие источники сервер интеграции удаляет.

Отключение интеграции

• Примерно через минуту после отключения в amoCRM сервер проверяет, что доступа к аккаунту действительно нет. Если amoCRM не отвечает, проверка повторяется в течение полутора часов. Затем установка помечается отключённой, доступ к amoCRM отзывается, а ключ SpeShu.AI стирается. Если подтвердить отключение так и не удалось, ничего не удаляется.
• Остальные данные при отключении не удаляются. Ночные резервные копии базы хранятся 14 дней.
• При повторной установке настройки сохраняются. Ключ SpeShu.AI нужно подключить заново, а тексты чатов снова поступают с момента новой установки.
• Удаление данных по запросу: [TODO: как запросить удаление данных аккаунта].

Ограничения и тарифы amoCRM

Тарифы amoCRM

Тексты сообщений из чатов помощник получает через вебхуки API amoCRM, а они доступны на тарифах «Расширенный» и выше. На тарифе ниже помощник работает по примечаниям, звонкам, задачам и ходу сделки: о сообщениях чатов он знает только время и направление, без текста, а новые события видит с задержкой до 15 минут. В строке покрытия это видно как «N сообщ. без текста».

Что нужно учитывать

• История. Тексты чатов есть только с момента установки интеграции. Старую переписку помощник не пересказывает. Из почты видны только темы входящих писем.
• Платформа. Только веб-версия amocrm.ru, только русский язык. amocrm.com и kommo.com не поддерживаются, в мобильном приложении помощника нет.
• Где работает. Только в карточке сделки: не в контактах, компаниях, покупателях и не в списках. Свободного чата «спросить помощника» нет.
• Без автодействий. Помощник не отправляет сообщения, не меняет этап, не заполняет поля и ничего не пишет в сделку сам. Задачи и примечания — только по кнопке.
• Без фонового расчёта. Первый разбор — по кнопке Рассчитать, дальше — при открытии устаревшей карточки или по Обновить. Обновлений в реальном времени нет.
• Без ключа. Пока не подключён ключ SpeShu.AI, в панели только сообщение о том, что ИИ-анализ не подключён. Без ИИ работает только радар рисков в отчётах.
• База знаний. Только текстовые поля. Вместе с методикой, возражениями и целями этапов не больше 60 000 символов. Файлы, сайты и поиск по документам не поддерживаются.
• Радар строится по кнопке и уведомлений не присылает. Пороги не настраиваются, учитываются сделки с событиями после установки.
• Часовые пояса. Лимиты расходов и дни в отчётах считаются по UTC, срок задачи — в часовом поясе браузера.
• Настройки меняет только администратор аккаунта. Истории и отката версий в интерфейсе нет.
• Качество. Помощник может ошибаться, как любая языковая модель, в том числе в расчётах цены и бюджета. Проверяйте черновики и цифры перед отправкой клиенту.

Звонки

• Анализ звонков по умолчанию выключен — его включает администратор. Пока он включён, записи обрабатываются в фоне, по мере поступления.
• Расшифровка через SpeShu.AI на реальных записях телефонии ещё проверяется, поэтому анализ звонков может работать нестабильно.
• Нужна телефония, которая кладёт в примечание о звонке ссылку на запись. Ссылка должна быть публичной и вести прямо на аудиофайл: ссылка на страницу плеера или входа не подойдёт. Если в примечании есть статус звонка, он должен быть «разговор состоялся».
• Форматы: MP3, WAV, M4A, FLAC, OGG, WebM, AMR, AAC. Файл — не больше 100 МБ, в расшифровку идёт не больше 2 часов записи.
• Звонки короче порога (по умолчанию 20 секунд) и сверх месячного лимита минут (по умолчанию 600) пропускаются.
• Разделения речи по собеседникам нет. Готовые расшифровки телефонии и голосовые сообщения из раздела «Файлы» не используются.
• В строке покрытия видно, сколько звонков расшифровано и сколько записей недоступно: «звонки 2 из 3 расшифрованы, недоступно записей: 1». Недоступными считаются записи, которые не скачались, не расшифровались или были пропущены (короче порога, сверх лимита минут, без ссылки на запись, при выключенном анализе).

Вопросы и сообщения об ошибках

Частые вопросы

Сообщения и что делать

Сообщения приведены дословно, подставляемые значения выделены курсивом. Где тексты для менеджера и администратора различаются, даны оба. К сообщениям о сбоях добавляется строка с контактом поддержки интеграции.

Поддержка и контакты

«ИИ-помощник менеджера» — сторонняя интеграция: её разрабатывает и поддерживает не amoCRM. По работе помощника обращайтесь в поддержку интеграции.

Email

[TODO: email поддержки]

Телефон

[TODO: телефон поддержки]

Часы работы

[TODO: часы работы поддержки]

Страница поддержки

[TODO: ссылка на страницу поддержки]

Разработчик

[TODO: юрлицо, ИНН/ОГРН, адрес]

Политика конфиденциальности

amo.speshu.ai/privacy/

Что написать в обращении

• адрес аккаунта amoCRM (вида компания.amocrm.ru);
• ссылку на сделку или её номер;
• текст сообщения дословно и время, когда оно появилось;
• что вы делали перед этим.

Не присылайте логин и пароль от amoCRM и значение API-ключа SpeShu.AI: для поддержки они не нужны.

Вопросы по балансу и API-ключам SpeShu.AI решаются в личном кабинете SpeShu.AI.