Уведомления об отключении интеграций

Если интеграция с CRM или другим сервисом отключается из-за ошибки авторизации, вы узнаете об этом сразу — через баннер в личном кабинете Carrot quest и в письме на email. Так вы сможете быстро восстановить работу интеграции и не потерять лидов.

В этой статье:

• Как работают уведомления
• Баннер в личном кабинете
• Email-уведомление
• Какие интеграции поддерживаются
• Почему интеграция может отключиться
• Как восстановить интеграцию
• Частые вопросы

Как работают уведомления

Когда интеграция автоматически отключается из-за ошибки (например, истёк токен доступа к amoCRM), Carrot quest оповещает вас по двум каналам одновременно:

1. Баннер в личном кабинете - плашка под шапкой на всех страницах сервиса. Показывает, какие интеграции приостановлены, и ведёт прямо в их настройки.
2. Email - автоматическое письмо всем администраторам и суперадминистраторам проекта.

Уведомления приходят автоматически — ничего настраивать не нужно.

Уведомления видят только администраторы и суперадминистраторы. Операторам баннер не показывается, т.к. они не могут управлять интеграциями.

Ошибки интеграций по-прежнему записываются в колокольчик справа вверху (панель оповещений о фоновых задачах в шапке), и видны всем сотрудникам проекта.

Баннер в личном кабинете

При отключении интеграции под шапкой админки появляется баннер. Он виден на всех страницах сервиса, пока вы его не закроете.

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

В списке по каждой интеграции вы увидите:

• Тип интеграции (amoCRM, Bitrix24, Telegram и др.),
• Название конкретной интеграции, которое вы задали при подключении,
• Дату и время отключения,
• Причину (например, «Нет доступа к вашему аккаунту AmoCRM»),
• Ссылку «Открыть настройки» — нажмите, чтобы перейти прямо на страницу этой интеграции и переподключить её.

Как закрыть баннер

Нажмите на крестик × справа. Баннер скроется, и для этой ошибки больше не появится. Если после этого интеграция отключится повторно или отключится другая интеграция — баннер покажется снова.

Несколько деталей, которые полезно знать:

• Баннер хранит состояние «закрыт» в вашем браузере. Если вы закрыли его на ноутбуке, на телефоне он покажется снова.
• Каждый администратор видит баннер независимо. Если ваш коллега закрыл баннер, у вас он все равно будет показан.
• В тексте баннера есть дата и время отключения — по ним вы поймёте, насколько актуальна ошибка.

Email-уведомление

Одновременно с баннером Carrot quest отправляет письмо на email всем администраторам и суперадминистраторам проекта.

В письме указаны:

• Название вашего проекта.
• Тип интеграции и её название.
• Причина отключения и время.
• Кнопка «Перейти к интеграции» — ведёт прямо в настройки.

Письмо отправляется один раз при каждом отключении. Уведомление отправляется только один раз — предполагается, что после получения письма вы переподключите интеграцию.

Письмо приходит на тот email, который указан в вашем аккаунте Carrot quest. Настроить отдельные адреса для уведомлений пока нельзя.

Какие интеграции поддерживаются

Уведомления работают для всех основных интеграций: 

Для Webhook логика немного отличается: интеграция отключается не из-за одной ошибки, а когда накапливается большое количество ошибок при отправке данных на ваш сервер (больше 300 ошибок за 30 мин).

Если вы отключаете интеграцию вручную (сами, в настройках) — уведомление не приходит. Баннер и email срабатывают только при автоматическом отключении из-за ошибки.

Почему интеграция может отключиться

Carrot quest регулярно отправляет запросы к подключённым сервисам (amoCRM, Bitrix24, Telegram и другим). Если сервис отвечает ошибкой авторизации — это значит, что текущий ключ доступа больше не работает. После нескольких неудачных попыток Carrot quest приостанавливает интеграцию, чтобы не отправлять заведомо неработающие запросы.

Вот самые частые причины:

• amoCRM. Кто-то из администраторов amoCRM сменил пароль или включил двухфакторную аутентификацию. Или в amoCRM отозвали доступ приложению Carrot quest (Настройки → Интеграции → отключить). Также: аккаунт заблокирован или истекла подписка на amoCRM.
• Bitrix24. Токен доступа истёк (обычно через ~30 дней без обновления). Портал переехал на другой адрес (mycompany.bitrix24.ru → newname.bitrix24.ru). Сотрудник, который авторизовал интеграцию, уволен или деактивирован в Bitrix24. Администратор удалил приложение или снял права.
• Telegram. Владелец бота сбросил токен через @BotFather (команда /revoke). Бот удалён или заблокирован Telegram за нарушения.
• ВКонтакте. Токен сообщества пересоздан. Человек, который авторизовал интеграцию, перестал быть администратором сообщества. Доступ к API отключён в настройках группы.
• WhatsApp (edna). API-ключ стал неактивным (пересоздан в личном кабинете edna). Проблемы с биллингом на стороне edna.
• RetailCRM. API-ключ пересоздан или у него изменили права.
• Dialogflow. Ключ сервисного аккаунта удалён в Google Cloud Console. На проекте отключён биллинг. Роль Dialogflow API Client отозвана.
• Webhook. Ваш сервер, принимающий данные, недоступен (отвечает ошибками 500, 502 или не отвечает вовсе). Истёк SSL-сертификат. URL изменился, а в Carrot quest остался старый.

Как восстановить интеграцию

1. Нажмите «Открыть настройки» в баннере или «Перейти к интеграции» в email — вы попадёте на страницу нужной интеграции. Или перейдите в раздел интеграций в личном кабинете и выберете нужную интеграцию.
2. Проверьте, что на стороне внешнего сервиса ничего не менялось (пароль, токен, права доступа).
3. Если причина найдена — устраните её в самом сервисе (amoCRM, Bitrix24 и т.д.).
4. Переподключите интеграцию в Carrot quest: обычно для этого нужно заново авторизоваться или вставить обновлённый ключ.

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

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

• Я закрыл баннер, но интеграция всё ещё не работает. Покажется ли он снова?

Нет, для этой конкретной ошибки баннер больше не появится — он считает её «прочитанной». Чтобы проверить статус интеграции, зайдите в её настройки вручную (раздел Интеграции). Если интеграция снова отключится (повторная ошибка) — баннер появится как новый. 

• Почему я закрыл баннер на компьютере, а на телефоне он опять показывается?

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

• Могу ли я настроить, на какой email приходят уведомления?

Пока нет — письмо уходит на email, указанный в вашем аккаунте Carrot quest, всем администраторам и суперадминистраторам проекта. 

• Придёт ли уведомление, если я сам отключил интеграцию?

Нет. Уведомления срабатывают только при автоматическом отключении из-за ошибки. 

• Операторы тоже видят баннер?

Нет, баннер виден только администраторам и суперадминистраторам. Операторы видят уведомления в колокольчике, но баннер им не показывается. 

• Приходит ли повторное письмо, если я не починил интеграцию?

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