Ошибки и как их исправить

Что-то не сработало: синхронизация остановилась, вход не прошёл или WireCat показал предупреждение. Здесь вы узнаете, что случилось и как это исправить: по подсказке в приложении, с помощью своего ИИ-агента или с нашей помощью. Часто на это уходит пара минут.

На этой странице:

1. Что случилось
2. Как это исправить
3. Где видна ошибка
4. Полный текст ошибки в журнале
5. Ошибка в терминале
6. Попросите агента помочь
7. Напишите нам
8. Как проверить, что всё исправлено
9. Справочник кодов ошибок

Что случилосьCopy Anchor Link

Почти любая ошибка в WireCat относится к одному из четырёх случаев:

• Сервис попросил подождать или не ответил. Telegram, почта или Битрикс24 ограничивают, как часто к ним можно обращаться, иногда бывают недоступны, или пропал интернет. Обычно это проходит само.
• Вход больше не работает. Сессия устарела, пароль сменили или доступ отозвали в самом сервисе.
• Не хватает настройки. WireCat не знает, что сделать, пока вы не выберете, например, чьи сделки копировать.
• Что-то сломалось у нас. Тогда исправить можем только мы, и нам поможет ваш отчёт.

Подсказка под ошибкой говорит простыми словами, какой это случай.

Как это исправитьCopy Anchor Link

1. Сделайте то, что советует подсказка. Нажмите Ещё раз, войдите снова или подождите. Часто этого достаточно.
2. Посмотрите полный текст ошибки в журнале. Там написано, что именно случилось и какую команду выполнить.
3. Попросите своего ИИ-агента, например Claude Code. Он сам прочитает журнал и предложит решение.
4. Напишите нам кнопкой Сообщить о проблеме в приложении или в чат поддержки.

Ниже каждый способ описан подробно.

Где видна ошибкаCopy Anchor Link

Ошибки синхронизации и входа появляются на странице Инструменты. Там подключены ваши сервисы: Telegram, почта, Битрикс24 и другие, у каждого своя карточка. Ошибка видна в карточке аккаунта, с которым что-то случилось. Первая строка объясняет, что произошло и что сделать.

Нажмите Подробнее, чтобы увидеть код ошибки, например provider_unavailable · profile.locked, и кнопку Открыть запуск в журнале. Код пригодится агенту или нам. Что значит каждый код, сказано в справочнике в конце страницы.

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

Полный текст ошибки в журналеCopy Anchor Link

Каждый раз, когда WireCat что-то делает с сервисом, например синхронизирует его, это записывается в журнал как запуск. Кнопка Открыть запуск в журнале открывает запуск с ошибкой на странице Журнал. Блок Что пошло не так показывает полный текст ошибки, на каком запросе она случилась и что ответил сервис.

Текст ошибки обычно называет, что сделать, иногда готовой командой. Скопировать JSON копирует всю запись запуска: её можно отдать агенту или приложить к отчёту. Личные данные в ней уже скрыты. Как искать в журнале, объясняет страница Журнал.

Ошибка в терминалеCopy Anchor Link

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

Повторите то, что не получилось. Для синхронизации это sync, например для Битрикс24 с аккаунтом Anna:

b24 Anna sync

Или прочитайте записи прошлых запусков:

b24 Anna runs list status:failed --limit 5
b24 Anna runs show 20261112T095912Z-sync-54a1a4 --problems

runs list показывает последние запуски с ошибкой, а runs show один запуск со всеми шагами. Вместо b24 и Anna подставьте свой сервис и аккаунт, например tg personal runs list или mail work runs list. Все команды журнала описаны в разделе Логи в терминале.

Проверку целиком делает doctor, например tg personal doctor или memo doctor. Он проверяет вход, настройки и файлы и говорит, что исправить.

Попросите агента помочьCopy Anchor Link

Ваш ИИ-агент, например Claude Code или Codex, умеет сам читать журнал WireCat и часто быстрее находит причину. Дайте ему:

• код ошибки из карточки, например configuration_error · config.invalid, и в каком сервисе и аккаунте она;
• запись запуска, скопированную кнопкой Скопировать JSON, если она у вас есть.

Можно написать так:

WireCat: синхронизация Bitrix24 для аккаунта Anna падает
с configuration_error · config.invalid. Найди причину в логах b24
(b24 Anna runs list status:failed) и скажи, что сделать.

Не давайте агенту коды входа, пароли и ключи. Для разбора ошибки они не нужны.

Напишите намCopy Anchor Link

Если агент не помог, нажмите Сообщить о проблеме вверху окна или Сообщить рядом с ошибкой. Опишите, что вы делали, что случилось и чего ждали.

• Отчёт становится открытым обсуждением (issue) на GitHub, поэтому за ним можно следить. Адреса почты, номера телефонов и токены в тексте скрываются ещё на вашем компьютере.
• К отчёту прикладываются последние записи ошибок из журнала. Они не публикуются, хранятся на сервере WireCat 90 дней и удаляются. Подробнее в политике конфиденциальности.
• Пока вы не нажали Отправить отчёт, ничего не уходит.

Или напишите в чат поддержки в Telegram, тема «Помощь», или в Discord, канал #help. Скопируйте пример и замените на своё:

Что делал: подключал Bitrix24, нажал «Ещё раз»
Ожидал: что сделки появятся на странице «Клиенты»
Получилось: configuration_error · config.invalid, скриншот ниже
Версии: кнопка «?», «О WireCat», «Скопировать сведения о версии»
Система: Windows 11
Агент ответил: что не выбраны пользователи CRM

Не присылайте коды входа, пароли, ключи и чужую переписку.

Как проверить, что всё исправленоCopy Anchor Link

Повторите то, что не получилось, например нажмите Ещё раз в карточке. Всё исправлено, если ошибка пропала из карточки, а в журнале у нового запуска статус Успешно. Если ошибка вернулась, напишите нам и приложите её код и запись запуска из журнала.

Справочник кодов ошибокCopy Anchor Link

Код под Подробнее состоит из двух частей, например provider_unavailable · profile.locked. Код (provider_unavailable) говорит, к какому виду относится ошибка, и он одинаковый во всех программах WireCat. Причина (profile.locked) уточняет, что именно произошло: здесь аккаунтом сейчас занят другой запуск.

Причины config.invalid, input.invalid, auth.failed, access.denied и item.not-found общие. Их ставят, когда точной причины нет, и они говорят только о виде ошибки. Что случилось на самом деле, написано в полном тексте ошибки в журнале.

Код выхода нужен в терминале и скриптам: программа завершается с этим числом.