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

Если интеграция с 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: обычно для этого нужно заново авторизоваться или вставить обновлённый ключ.

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

Уведомление о нередактируемом поле amoCRM 

Помимо уведомлений об отключении интеграций, Carrot quest предупреждает о проблемах с полями в amoCRM.

Когда появляется

Если в amoCRM одно из полей сделки, на которое настроен маппинг, стало нередактируемым (вычисляемым, системным или ограниченным по правам), Carrot quest не может записать в него данные. В этом случае вы получите уведомление.

Чем отличается от отключения интеграции

Баннер

Если вы находитесь в личном кабинете, появится баннер c уведомлением, что определённая интеграция требует внимания.

Вы можете «Открыть настройки», чтобы перейти к интеграции и отредактировать её настройки.

Email

Одновременно с баннером придёт письмо на email всем администраторам проекта:

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

• Название проекта и интеграции.
• Что интеграция продолжает работать.
• Ссылка «Перейти к интеграции».

Что делать при обнаружении нередактируемого поля

Зайдите в amoCRM → раздел настроек → Поля сделок.

1. Проверьте, какие поля изменились — стали вычисляемыми, формульными или ограниченными по правам.
2. Если нашли проблемное поле:
   • Вариант А: верните возможность редактирования в amoCRM (если это допустимо для вашего процесса).
   • Вариант Б: в Carrot quest уберите это поле из маппинга: Настройки → Интеграции → amoCRM → маппинг полей.
3. После исправления данные начнут передаваться автоматически при следующей отправке лида.

Почему не указано, какое именно поле стало нередактируемым

amoCRM при этой ошибке не сообщает, какое конкретно поле заблокировано. Поэтому в уведомлении написано «нередактируемое поле» без указания конкретного. Проверить настройки полей в amoCRM вам нужно самостоятельно.

Подсказка: обычно нередактируемыми становятся поля, которые администратор amoCRM сделал вычисляемыми (формулы), системными или ограниченными по правам доступа.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Пришло уведомление «Не удаётся обновить нередактируемое поле» для amoCRM. Как найти проблемное поле?

Зайдите в amoCRM → настройки → поля сделок. Проверьте, какие поля были недавно изменены — стали вычисляемыми, формульными или системными. Именно такие поля Carrot quest не может обновить через API. Уберите это поле из маппинга в настройках интеграции Carrot quest, или верните ему возможность редактирования в amoCRM.

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

• Интеграция «требует внимания», но не «приостановлена». Данные передаются?

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