Инструкция: «Healthcheck»

Виджет для amoCRM от LEADLAB. Описание самой интеграции — на странице виджета. Вопросы — в чате на этой странице или на support@leadlab.su.

Содержание
  1. Как это устроено
  2. Установка
  3. Подключение бота
  4. Подписчики
  5. Обзор и «Не тревожить»
  6. Что проверять
  7. Лимиты тарифа
  8. Оплата
  9. Если удалить виджет
  10. Частые вопросы

1. Как это устроено

Сервис LEADLAB регулярно проверяет ваш аккаунт amoCRM через API: вебхуки интеграций, установленные виджеты, события каналов и телефонии, доставку ответов клиентам, записи разговоров, лимиты тарифа и оплату. Когда что-то сломалось, Telegram-бот вашего аккаунта пишет всем подписчикам. Когда починилось — пишет ещё раз.

2. Установка

Устанавливает виджет администратор аккаунта.

  1. Откройте amoМаркет и найдите «Healthcheck».
  2. Нажмите «Установить» и отметьте согласие с условиями — ссылка в окне ведёт на оферту.
  3. Окно установки сохранится само. Если появилась подсказка «Нажмите «Сохранить», чтобы завершить установку», нажмите «Сохранить».

Проверки начинаются сразу после установки, первая — в течение нескольких минут. Чтобы оповещения приходили, подключите бота (раздел 3).

3. Подключение бота

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

  1. Откройте @BotFather в Telegram и отправьте /newbot.
  2. Придумайте имя (например, «Оповещения amoCRM») и ник бота — он должен заканчиваться на bot.
  3. Скопируйте токен из ответа @BotFather.
  4. В amoCRM откройте «Настройки» → «Healthcheck» → вкладка «Бот и подписчики», вставьте токен и нажмите «Подключить».
  5. Под формой появится админская ссылка-приглашение. Откройте её в Telegram и нажмите «Старт» — вы станете подписчиком и администратором бота.

Токен бота в amoCRM не сохраняется — он хранится в сервисе LEADLAB в зашифрованном виде.

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

4. Подписчики

Подписаться на оповещения можно только по ссылке-приглашению: оповещения раскрывают устройство вашей CRM. Ссылка одноразовая — подписывает один чат, человека или группу — и действует 7 дней.

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

Команды бота: /status — сводка по аккаунту, /help — подсказка и что проверяем, /stop — отписаться.

5. Обзор и «Не тревожить»

Вкладка «Обзор» показывает итог — всё в порядке, стоит присмотреться или есть сбои, — открытые сбои и сводку по аккаунту, как команда /status в боте: тариф, лимиты, интеграции, каналы и телефонию. Разбивка сделок по воронкам и список всех каналов открываются по клику. Если оповещения о каком-то сбое вам не нужны — например, вебхук тестового стенда интеграции регулярно оказывается отключён, — нажмите рядом с ним «Не тревожить». Вернуть оповещения можно на вкладке «Что проверять», в блоке «Не тревожить — остальное».

6. Что проверять

Вкладка «Что проверять»:

Изменения сохраняются кнопкой «Сохранить» внизу вкладки. Менять настройки может только администратор amoCRM. Об изменениях бот пишет своим администраторам.

Доступ виджетов к amoCRM: если виджет 3 месяца не обращался к аккаунту, доступ к нему отзывается — после этого виджет перестаёт работать. Healthcheck предупредит примерно за месяц и ещё раз, если доступ пропал. Виджеты, у которых доступа нет уже при установке Healthcheck, — в /status, строка «Без доступа к amoCRM»: многим виджетам доступ не нужен, но если ваш должен сам работать с amoCRM — подключите его заново.
Тишину виджет оценивает по ритму аккаунта: в это время суток и день недели события обычно есть, а сейчас их нет. Ночи, выходные и тихие каналы учитываются. Первую неделю после установки виджет только изучает ритм и о тишине не пишет.

7. Лимиты тарифа

Оповещение приходит при 80, 95 и 100% лимита открытых сделок, контактов и компаний, дополнительных полей и места на диске. Место на диске считается как в разделе «Файлы» amoCRM — вместе с докупленным. Докупленные пакеты «Лимиты+» amoCRM по API не отдаёт. Если они у вас есть, впишите итоговый лимит на вкладке «Лимиты» — оповещения будут считаться от него.

8. Оплата

Пробный период — 7 дней, затем 6 000 ₽ / мес за аккаунт.

Оплатить — кнопкой «Оплатить» в окне виджета (amoМаркет → «Установленные» → «Healthcheck») или в чате на этой странице.

9. Если удалить виджет

Проверки и оповещения прекратятся. Настройки и подписчики хранятся ещё 30 дней: если за это время установить виджет снова, их не придётся настраивать заново. Через 30 дней данные удаляются.

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

Почему виджет не принимает токен бота?

Скорее всего, этот бот уже работает в другом сервисе — например, подключён к amoCRM как канал Telegram. Создайте для оповещений отдельного бота в @BotFather.

Ссылка-приглашение не сработала

Ссылка одноразовая и действует 7 дней. Если её уже использовали, отозвали или срок прошёл, создайте новую. Админскую ссылку открывайте в личном чате с ботом, не в группе.

Оповещение пришла, но всё работает

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

На странице настроек «Виджет потерял доступ к amoCRM»

Доступ интеграции к аккаунту отозван. Отключите виджет в amoМаркете и установите заново: настройки и подписчики сохранятся.

Проверяет ли виджет, что сработал сценарий Триггеров?

Нет. Виджет видит внешние признаки сбоя, которые amoCRM отдаёт по API: отключённый вебхук, остановившийся поток событий, недоставленные сообщения.