# Telegram-боты

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

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

## Что это

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

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

## Как начать

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

<figure id="bkmrk-%D0%9C%D0%B5%D0%BD%D1%8E-%D0%B1%D0%BE%D1%82%D0%B0" style="margin:16px 0; text-align:center">[![Меню бота](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bh-start.png)](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bh-start.png)<figcaption style="font-size:13px; color:#6b7280; margin-top:8px; text-align:center">Меню бота</figcaption></figure>- **«Сообщить об ошибке»** — что-то работало и перестало или работает не так.
- **«Поставить задачу»** — нужна доработка или новая возможность.
- **«Мои заявки и очередь»** — ваши заявки и общая очередь.

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

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

<figure id="bkmrk-%D0%97%D0%B0%D0%BF%D0%BE%D0%BB%D0%BD%D0%B5%D0%BD%D0%BD%D0%B0%D1%8F-%D0%B7%D0%B0%D1%8F%D0%B2%D0%BA%D0%B0-%D0%BE" style="margin:16px 0; text-align:center">[![Заполненная заявка об ошибке](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bh-bug-form.png)](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bh-bug-form.png)<figcaption style="font-size:13px; color:#6b7280; margin-top:8px; text-align:center">Заполненная заявка об ошибке</figcaption></figure>1. **Сервис** — где сломалось. Если нужного нет в списке — выберите «Другое» и напишите название.
2. **Кратко о проблеме** — одной строкой, до 80 символов: «Не сохраняется комментарий к звонку».
3. **Ссылки на сделки** — если ошибка видна на конкретных сделках. Каждую ссылку с новой строки. Это самое полезное, что вы можете дать: по ссылке разработчик сразу видит проблему.
4. **Что вы делали**, **что ожидали увидеть**, **что произошло на самом деле** — по шагам, как было.
5. **Фото или видео** — обязательно. Скриншот с ошибкой или запись экрана, до 80 МБ, можно несколько. Если на экране проблему не видно (например, «не пришло уведомление») — отметьте «показывать нечего».

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

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

<figure id="bkmrk-%D0%97%D0%B0%D0%BF%D0%BE%D0%BB%D0%BD%D0%B5%D0%BD%D0%BD%D0%B0%D1%8F-%D0%B7%D0%B0%D0%B4%D0%B0%D1%87%D0%B0" style="margin:16px 0; text-align:center">[![Заполненная задача](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bh-task-form.png)](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bh-task-form.png)<figcaption style="font-size:13px; color:#6b7280; margin-top:8px; text-align:center">Заполненная задача</figcaption></figure>То же самое, но вместо шагов — **что нужно сделать** и **зачем это нужно**. «Зачем» — главное поле: по нему решают, насколько задача важна и когда за неё браться. Фото не обязательны, но макет или пример того, что хотите получить, очень помогает.

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

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

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

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

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

<figure id="bkmrk-%D0%A3%D0%B2%D0%B5%D0%B4%D0%BE%D0%BC%D0%BB%D0%B5%D0%BD%D0%B8%D1%8F-%D0%BF%D0%BE-%D0%B7%D0%B0%D1%8F%D0%B2%D0%BA" style="margin:16px 0; text-align:center">[![Уведомления по заявке](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bh-notify.png)](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bh-notify.png)<figcaption style="font-size:13px; color:#6b7280; margin-top:8px; text-align:center">Уведомления по заявке</figcaption></figure>- **«взял в работу»** — разработчик начал разбираться;
- **«… пишет»** — у разработчика вопрос. Пока вы не ответите, работа по заявке стоит. Нажмите «Открыть заявку» и ответьте в переписке — после ответа заявка вернётся в работу сама;
- **«закрыты: готово»** — исправлено;
- **«отклонены»** — это не ошибка, повтор уже известной заявки или от задачи отказались. Причина — в сообщении.

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

<table id="bkmrk-%D0%9C%D0%BE%D0%B8-%D0%B7%D0%B0%D1%8F%D0%B2%D0%BA%D0%B8-%D0%9E%D0%B1%D1%89%D0%B0%D1%8F-%D0%BE%D1%87%D0%B5"><tbody><tr><td style="vertical-align:top; width:50%"><figure style="margin:16px 0; text-align:center">[![Мои заявки](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bh-list.png)](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bh-list.png)<figcaption style="font-size:13px; color:#6b7280; margin-top:8px; text-align:center">Мои заявки</figcaption></figure></td><td style="vertical-align:top; width:50%"><figure style="margin:16px 0; text-align:center">[![Общая очередь](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bh-queue.png)](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bh-queue.png)<figcaption style="font-size:13px; color:#6b7280; margin-top:8px; text-align:center">Общая очередь</figcaption></figure></td></tr></tbody></table>

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

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

<figure id="bkmrk-%D0%97%D0%B0%D1%8F%D0%B2%D0%BA%D0%B0-%D1%81-%D0%B2%D0%BE%D0%BF%D1%80%D0%BE%D1%81%D0%BE%D0%BC-%D1%80%D0%B0" style="margin:16px 0; text-align:center">[![Заявка с вопросом разработчика](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bh-view.png)](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bh-view.png)<figcaption style="font-size:13px; color:#6b7280; margin-top:8px; text-align:center">Заявка с вопросом разработчика</figcaption></figure>- **«Править»** — поправить или дополнить, пока заявку не взяли в работу.
- **«Отозвать»** — если проблема решилась сама или задача больше не нужна.
- **«Вернуть в работу»** — у выполненной задачи, если сделали не то. Можно один раз, в течение 14 дней, с объяснением.
- В закрытую заявку писать нельзя. Если проблема повторилась — заведите новую.

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

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

# Счета на оплату

*Для сотрудников, которым нужно передать счёт на оплату. На картинках — макеты переписки: названия, суммы и файлы вымышленные.*

## Что делает бот

Бот «Счета на оплату» принимает счёт в Telegram и заводит по нему задачу на доске **«Счета на оплату»** в YouGile. В задаче будут название, сумма, срочность и ваш файл. Дальше счёт обрабатывают уже на доске — бот за задачей не следит и об оплате не сообщает.

## Как отправить счёт

1. **Отправьте боту файл счёта** — документом (PDF, Word, Excel, что угодно) или фото. **В подписи к файлу** напишите, что это за счёт: подпись станет названием задачи.
2. Бот ответит «Файл принят…» и попросит **сумму**. Напишите число: `12480`, `12 480` или `12480,50`.
3. Нажмите **«Срочно»** или **«Не срочно»**. Задача создаётся сразу после нажатия — отдельного подтверждения нет.

<figure id="bkmrk-%D0%A1%D1%87%D1%91%D1%82-%D1%81-%D0%BF%D0%BE%D0%B4%D0%BF%D0%B8%D1%81%D1%8C%D1%8E%2C-%D1%81%D1%83%D0%BC" style="margin:16px 0; text-align:center">[![Счёт с подписью, сумма и выбор срочности](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bots-invoice-flow.png)](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bots-invoice-flow.png)<figcaption style="font-size:13px; color:#6b7280; margin-top:8px; text-align:center">Счёт с подписью, сумма и выбор срочности</figcaption></figure>Бот ответит «Задача создана в YouGile!» и пришлёт ссылку на задачу (иногда вместо ссылки — её номер, «ID: …»).

<figure id="bkmrk-%D0%97%D0%B0%D0%B4%D0%B0%D1%87%D0%B0-%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B0" style="margin:16px 0; text-align:center">[![Задача создана](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bots-invoice-done.png)](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bots-invoice-done.png)<figcaption style="font-size:13px; color:#6b7280; margin-top:8px; text-align:center">Задача создана</figcaption></figure>## Что писать в названии

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

- за что счёт;
- кому платим — контрагент;
- **свою фамилию** — чтобы было понятно, к кому идти с вопросами.

Например: «Канцтовары на октябрь, ООО „Канцторг“, Петрова».

## Другие способы

- **Файл без подписи** — бот попросит название отдельным сообщением.
- **Сначала текст, потом файл** — тоже можно: бот запомнит текст как название и попросит файл. Если у файла будет подпись, название заменится подписью.

## Если что-то пошло не так

<figure id="bkmrk-%D0%A1%D1%83%D0%BC%D0%BC%D0%B0-%D1%81-%D0%B1%D1%83%D0%BA%D0%B2%D0%B0%D0%BC%D0%B8-%D0%B8-%D0%BE%D1%82" style="margin:16px 0; text-align:center">[![Сумма с буквами и отмена](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bots-invoice-errors.png)](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bots-invoice-errors.png)<figcaption style="font-size:13px; color:#6b7280; margin-top:8px; text-align:center">Сумма с буквами и отмена</figcaption></figure>- **«Не похоже на число»** — в сумме есть буквы или знаки: «руб», «₽», «р.». Напишите только число. Если копировали сумму из документа и бот её не принимает — наберите вручную: в скопированном тексте бывают невидимые пробелы.
- **Передумали или ошиблись** — отправьте `/cancel` и начните заново с файла. Кнопки «назад» нет, поменять файл или название на полпути нельзя.
- **Бот не реагирует на текст после вопроса о срочности** — так и задумано: он ждёт нажатия «Срочно» или «Не срочно».
- **«Не удалось создать задачу в YouGile»** — отправьте файл заново. Если ошибка повторяется, напишите разработчикам.
- **«Файл не удалось прикрепить автоматически»** — задача создана, но без файла. Приложите файл к задаче в YouGile сами.

## Ограничения

- **Один счёт — один файл.** Несколько файлов одним сообщением (альбомом) бот не примет: отправляйте по одному, каждый — отдельной задачей, или соберите в один PDF.
- **Файл не больше 20 МБ.** Больший Telegram боту не отдаст: задача создастся без файла.
- **Фото счёта лучше отправлять «как файл»**, а не «как фото»: так Telegram не сожмёт его и мелкий текст останется читаемым.
- **Копейки на доске не видны.** Сумма в описании задачи полная, а в метке суммы на карточке — только рубли.
- Видео, голосовые и стикеры бот не принимает.

# Бот оплат

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

## Что делает бот

Бот оплат пишет в общий чат, когда клиент оплатил: сделка перешла на стадию оплаты в amoCRM — через несколько секунд в чате сообщение «A K S E P T» с клиентом, суммой и менеджером. Название сделки в сообщении — ссылка на неё в amoCRM. Ещё бот сообщает о завершении дел и вечером присылает итоги дня.

## Сообщения об оплате

<figure id="bkmrk-%D0%9E%D0%BF%D0%BB%D0%B0%D1%82%D0%B0-%D0%B2-%D0%9C%D0%9F%D0%9F2-%28%D1%81%D0%B2%D0%B5%D1%80%D1%85" style="margin:16px 0; text-align:center">[![Оплата в МПП2 (сверху) и оплата 99 ₽ (снизу)](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bots-success-full.png)](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bots-success-full.png)<figcaption style="font-size:13px; color:#6b7280; margin-top:8px; text-align:center">Оплата в МПП2 (сверху) и оплата 99 ₽ (снизу)</figcaption></figure>**Короткое сообщение** — по воронкам, где клиент платит 99 ₽. Вместо суммы может стоять «Горячий лид».

**Полное сообщение** — по воронкам МПП2 и партнёрских лидов:

<table id="bkmrk-%D0%A1%D1%82%D1%80%D0%BE%D0%BA%D0%B0%D0%A7%D1%82%D0%BE-%D1%8D%D1%82%D0%BE-a-k-s-"><thead><tr><th>Строка</th><th>Что это</th></tr></thead><tbody><tr><td>A K S E P T / D O A K S E P T</td><td>АКСЕПТ — оплачен первый платёж, ДОАКСЕПТ — один из следующих</td></tr><tr><td>Сумма под именем</td><td>Сколько клиент заплатил сейчас</td></tr><tr><td>Три строки ниже</td><td>Тип услуги, срок рассрочки, «Полный» или «Не полный» первый платёж</td></tr><tr><td>Договор на</td><td>Сумма всех платежей по договору</td></tr><tr><td>Что за лид?</td><td>Теги сделки</td></tr><tr><td>Менеджер</td><td>МПП второго уровня (в коротком — первого)</td></tr></tbody></table>

Остальное — поля сделки как есть. Пустое поле остаётся пустой строкой: «Дата ДОАКЦЕПТА:» без даты значит, что поле не заполнено.

## Завершение дела

<figure id="bkmrk-%D0%94%D0%B5%D0%BB%D0%BE-%D0%B7%D0%B0%D0%B2%D0%B5%D1%80%D1%88%D0%B5%D0%BD%D0%BE" style="margin:16px 0; text-align:center">[![Дело завершено](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bots-success-completion.png)](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bots-success-completion.png)<figcaption style="font-size:13px; color:#6b7280; margin-top:8px; text-align:center">Дело завершено</figcaption></figure>Когда сделка переходит на стадию «Завершение», бот пишет, кто финансовый управляющий и сколько дело было в работе — от первого платежа до сегодня.

## Итоги дня

<figure id="bkmrk-%D0%92%D0%B5%D1%87%D0%B5%D1%80%D0%BD%D0%B8%D0%B9-%D0%BE%D1%82%D1%87%D1%91%D1%82-%D0%B2-20%3A" style="margin:16px 0; text-align:center">[![Вечерний отчёт в 20:00](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bots-success-daily.png)](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bots-success-daily.png)<figcaption style="font-size:13px; color:#6b7280; margin-top:8px; text-align:center">Вечерний отчёт в 20:00</figcaption></figure>В 20:00 по Москве в отдельный чат приходят итоги за день и за месяц: сколько клиентов оплатили 99 ₽, сколько продаж из маркетинга и из партнёрки и выручка.

## Если сообщения нет

- **Обычная задержка** — до минуты: бот ждёт, пока данные сделки обновятся.
- **Если не получилось**, бот повторяет попытку через 1, 5 и 15 минут и через час. Сообщение может прийти с опозданием до полутора часов.
- **Не пришло совсем** — сделка не из тех воронок, её удалили, или все попытки не удались. Напишите разработчикам с номером сделки.
- **Сделку вернули и снова перевели в оплату** — в течение 10 минут бот повторно не напишет, позже — напишет ещё раз.

# Боты активации SIM

*Для менеджеров, которые ведут сделки активации SIM. На картинках — макеты переписки клиента с ботом.*

## Что делают боты

Клиент, купивший SIM-карту, переходит по ссылке со страницы активации в бота — в Telegram (`@activator_sim_bot`) или в MAX. Бот:

1. присылает клиенту его тариф, кнопку для активации и видеоинструкцию;
2. заводит сделку в amoCRM — в воронке активаций, на первой стадии;
3. через сутки спрашивает, получилось ли активировать, и если да — просит отзыв на OZON и Wildberries.

Оператор определяется по ссылке, с которой пришёл клиент: Билайн, Билайн 60, T2, Мегафон, Yota или Донуля. У каждого свой текст тарифа и своя кнопка.

<figure id="bkmrk-%D0%A7%D1%82%D0%BE-%D0%B2%D0%B8%D0%B4%D0%B8%D1%82-%D0%BA%D0%BB%D0%B8%D0%B5%D0%BD%D1%82-%D0%91%D0%B8%D0%BB" style="margin:16px 0; text-align:center">[![Что видит клиент Билайна после входа](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bots-activation-start.png)](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bots-activation-start.png)<figcaption style="font-size:13px; color:#6b7280; margin-top:8px; text-align:center">Что видит клиент Билайна после входа</figcaption></figure>## Где переписка

Вся переписка — в **чате сделки в amoCRM**. Там видно, откуда клиент пришёл («🟢 Запустил бота (источник: …)»), всё, что он пишет боту, и всё, что бот ему отправил. Отвечайте клиенту прямо из чата сделки — бот передаст ответ в Telegram или MAX.

## Как сделка двигается сама

<table id="bkmrk-%D0%A7%D1%82%D0%BE-%D0%BF%D1%80%D0%BE%D0%B8%D0%B7%D0%BE%D1%88%D0%BB%D0%BE%D0%9A%D1%83%D0%B4%D0%B0-%D0%B1%D0%BE"><thead><tr><th>Что произошло</th><th>Куда бот переводит сделку</th></tr></thead><tbody><tr><td>Клиент впервые зашёл в бота</td><td>новая сделка, первая стадия</td></tr><tr><td>Клиент написал сообщение</td><td>«В диалоге»</td></tr><tr><td>Клиент молчит сутки</td><td>«Спросили об активации» — и бот задаёт вопрос</td></tr><tr><td>Клиент ответил «Да»</td><td>«Получен отзыв» — бот просит отзыв</td></tr><tr><td>Клиент ответил «Нет»</td><td>обратно «В диалоге» — бот спрашивает, какая проблема</td></tr></tbody></table>

<figure id="bkmrk-%D0%92%D0%BE%D0%BF%D1%80%D0%BE%D1%81-%D1%87%D0%B5%D1%80%D0%B5%D0%B7-%D1%81%D1%83%D1%82%D0%BA%D0%B8-%D0%B8" style="margin:16px 0; text-align:center">[![Вопрос через сутки и просьба об отзыве](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bots-activation-followup.png)](https://wiki.donula26.ru/uploads/images/gallery/2026-09/bots-activation-followup.png)<figcaption style="font-size:13px; color:#6b7280; margin-top:8px; text-align:center">Вопрос через сутки и просьба об отзыве</figcaption></figure>**Бот трогает только свои стадии.** Перевели сделку в другую стадию вручную — бот её больше не двигает и вопрос через сутки не задаёт.

Сутки отсчитываются от последнего сообщения **клиента**: ваши ответы отсчёт не сбрасывают.

## На что обратить внимание

- **Задач бот не ставит.** Уведомлений в Telegram сотрудникам тоже нет — следите за входящими в amoCRM.
- **Клиент нажал «Нет»** — в чате сделки появится «Пользователь нажал «Нет»», а клиент получит «Какая проблема у вас возникла?». Дальше — ваша работа: ответить и помочь с активацией.
- **Клиент заблокировал бота** — в сделке снимется галочка «Бот ТГ (активатор)» или «Бот MAX (активатор)». Написать ему через бота больше нельзя.
- **Новый клиент зашёл без ссылки** (нашёл бота поиском) — бот попросит перейти по ссылке с сайта и сделку не заведёт.
- **Один клиент — две сделки**, если он зашёл и в Telegram, и в MAX: для amoCRM это два разных собеседника.