Как сообщить об ошибке

Для всех сотрудников. На картинках — макеты: люди, заявки и сделки вымышленные.

Что это

Бот @donula_bug_hunter_bot принимает заявки в разработку: когда что-то сломалось или когда нужно что-то доделать в наших дашбордах, виджетах и ботах. Заявка сразу уходит тому, кто отвечает за этот сервис. Там же видно, что с ней происходит и какое у неё место в общей очереди.

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

Как начать

Откройте бота и отправьте /start. Под сообщением будут кнопки:

• «Сообщить об ошибке» — что-то работало и перестало или работает не так.
• «Поставить задачу» — нужна доработка или новая возможность.
• «Мои заявки и очередь» — ваши заявки и общая очередь.

Кнопки открывают форму прямо в Telegram. Если открывается пустая страница — отправьте боту /start app: он пришлёт ссылку, которая откроет то же самое в браузере. Ссылка одноразовая и действует пять минут — никому её не пересылайте.

Сообщить об ошибке

1. Сервис — где сломалось. Если нужного нет в списке — выберите «Другое» и напишите название.
2. Кратко о проблеме — одной строкой, до 80 символов: «Не сохраняется комментарий к звонку».
3. Ссылки на сделки — если ошибка видна на конкретных сделках. Каждую ссылку с новой строки. Это самое полезное, что вы можете дать: по ссылке разработчик сразу видит проблему.
4. Что вы делали, что ожидали увидеть, что произошло на самом деле — по шагам, как было.
5. Фото или видео — обязательно. Скриншот с ошибкой или запись экрана, до 80 МБ, можно несколько. Если на экране проблему не видно (например, «не пришло уведомление») — отметьте «показывать нечего».

Пока что-то не заполнено, над кнопкой написано, чего не хватает. Нажмите «Отправить заявку» — бот ответит «Заявка #… принята».

Поставить задачу

То же самое, но вместо шагов — что нужно сделать и зачем это нужно. «Зачем» — главное поле: по нему решают, насколько задача важна и когда за неё браться. Фото не обязательны, но макет или пример того, что хотите получить, очень помогает.

Срочность определяет место в очереди. От меньшей к большей: «Не срочно», «В ближайшее время» (выбрана по умолчанию), «Срочно», «Вне очереди».

Срочность видна всем в общей очереди вместе с вашим именем. Ставьте честно: если все задачи «вне очереди», очередь перестаёт работать.

Задача может сначала уйти на согласование руководителю — тогда бот так и напишет. В очередь она встанет после согласования.

Что происходит с заявкой дальше

Бот пишет вам на каждом важном шаге:

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

Мои заявки и очередь

• «Мои» — ваши заявки: открытые сверху, закрытые ниже. Синий кружок с числом — новые сообщения по заявке. «№ 3» справа — место в очереди.
• «Очередь» — все открытые заявки компании по порядку. Сначала «вне очереди», потом по срочности, при равной — по должности автора, при равной — кто раньше поставил. Ваши помечены «ваша».

Откройте заявку, чтобы увидеть её целиком и переписку:

• «Править» — поправить или дополнить, пока заявку не взяли в работу.
• «Отозвать» — если проблема решилась сама или задача больше не нужна.
• «Вернуть в работу» — у выполненной задачи, если сделали не то. Можно один раз, в течение 14 дней, с объяснением.
• В закрытую заявку писать нельзя. Если проблема повторилась — заведите новую.

Как написать заявку, которую быстро починят

• Одна проблема — одна заявка. Три разные ошибки в одной заявке разбираются дольше, чем три отдельные.
• Ссылка на сделку и скриншот экономят разработчику больше времени, чем любое описание.
• «Не работает» — не описание. Напишите, что нажали и что увидели: «нажала „Сохранить“ — появилась надпись „Ошибка 500“».
• Не больше 10 заявок в час с одного человека — если упёрлись, объедините похожие.