Инструкция: «Healthcheck»
Виджет для amoCRM от LEADLAB. Описание самой интеграции — на странице виджета. Вопросы — в чате на этой странице или на support@leadlab.su.
1. Как это устроено
Сервис LEADLAB регулярно проверяет ваш аккаунт amoCRM через API: вебхуки интеграций, установленные виджеты, события каналов и телефонии, доставку ответов клиентам, записи разговоров, лимиты тарифа и оплату. Когда что-то сломалось, Telegram-бот вашего аккаунта пишет всем подписчикам. Когда починилось — пишет ещё раз.
- 🔴 — проблема, 🟢 — исправлено, ℹ️ — для сведения.
- Неисправленное бот напоминает раз в сутки.
- Пишет бот только о сбоях. Сводку в любой момент даёт команда
/status.
2. Установка
Устанавливает виджет администратор аккаунта.
- Откройте amoМаркет и найдите «Healthcheck».
- Нажмите «Установить» и отметьте согласие с условиями — ссылка в окне ведёт на оферту.
- Окно установки сохранится само. Если появилась подсказка «Нажмите «Сохранить», чтобы завершить установку», нажмите «Сохранить».
Проверки начинаются сразу после установки, первая — в течение нескольких минут. Чтобы оповещения приходили, подключите бота (раздел 3).
3. Подключение бота
Оповещения приходят от вашего собственного Telegram-бота. Нужен отдельный бот — не тот, что подключён к amoCRM как канал Telegram: такой виджет не возьмёт, чтобы не сломать переписку с клиентами.
- Откройте @BotFather в Telegram и отправьте
/newbot. - Придумайте имя (например, «Оповещения amoCRM») и ник бота — он должен заканчиваться на
bot. - Скопируйте токен из ответа @BotFather.
- В amoCRM откройте «Настройки» → «Healthcheck» → вкладка «Бот и подписчики», вставьте токен и нажмите «Подключить».
- Под формой появится админская ссылка-приглашение. Откройте её в Telegram и нажмите «Старт» — вы станете подписчиком и администратором бота.
Токен бота в amoCRM не сохраняется — он хранится в сервисе LEADLAB в зашифрованном виде.
4. Подписчики
Подписаться на оповещения можно только по ссылке-приглашению: оповещения раскрывают устройство вашей CRM. Ссылка одноразовая — подписывает один чат, человека или группу — и действует 7 дней.
- Ссылка для подписчика — человек открывает её и нажимает «Старт».
- Админская ссылка — открывший её в личном чате с ботом станет администратором бота. Администратор приглашает и отписывает людей прямо в Telegram командой
/adminи получает сообщения об изменении настроек. - В рабочую группу — добавьте бота в группу и отправьте в ней команду
/start@<ник бота> <код>, где код — всё, что в ссылке послеstart=.
Ссылка показывается один раз: отправьте её человеку сразу. Потерялась — отзовите её в списке ниже и создайте новую. Там же, в списке подписчиков, можно назначить или снять администратора бота и отписать человека.
Команды бота: /status — сводка по аккаунту, /help — подсказка и что проверяем, /stop — отписаться.
5. Обзор и «Не тревожить»
Вкладка «Обзор» показывает итог — всё в порядке, стоит присмотреться или есть сбои, — открытые сбои и сводку по аккаунту, как команда /status в боте: тариф, лимиты, интеграции, каналы и телефонию. Разбивка сделок по воронкам и список всех каналов открываются по клику. Если оповещения о каком-то сбое вам не нужны — например, вебхук тестового стенда интеграции регулярно оказывается отключён, — нажмите рядом с ним «Не тревожить». Вернуть оповещения можно на вкладке «Что проверять», в блоке «Не тревожить — остальное».
6. Что проверять
Вкладка «Что проверять»:
- Проверки — выключите ненужную целиком.
- Вебхуки интеграций — выключите вебхук, о котором не нужно тревожить.
- Каналы и телефония — выключите канал или задайте свой порог тишины в часах: тогда оповещение придёт, если событий нет дольше указанного, независимо от обычного ритма.
- Тонкая настройка — как часто напоминать о неисправленном и когда тишина считается сбоем. Нужны оба условия: тишина длится не меньше заданных часов (по умолчанию 2) и за это время в канал обычно пришло бы не меньше заданного числа событий (по умолчанию 8). Второе условие не даёт оповещениям срабатывать ночью, в выходные и в редких каналах.
Изменения сохраняются кнопкой «Сохранить» внизу вкладки. Менять настройки может только администратор amoCRM. Об изменениях бот пишет своим администраторам.
/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: отключённый вебхук, остановившийся поток событий, недоставленные сообщения.