У первого бота должна быть одна понятная работа. Возьмём сообщение «После обновления каталога кнопка „Получить КП“ съехала на телефоне». Помощник готовит карточку: что случилось, где проверить, какой результат принять. Сотрудник правит черновик и решает, создавать ли задачу. Это учебный пример без клиентских данных.
Соберите цепочку из четырёх шагов
- Вход. Сотрудник отправляет сообщение боту в личном чате. Для командного пилота можно сделать отдельную тестовую группу и вызывать бота командой.
- Проверка. Приложение принимает входящие сообщения от Telegram, сверяет разрешённый чат и отправителя. Сохраняет идентификатор обновления, чтобы повторная доставка не создавала вторую карточку.
- Черновик. Приложение передаёт модели только текст задачи и короткий справочник команды. Модель возвращает поля по заданной схеме. Приложение проверяет, что обязательные поля присутствуют, а строки разумной длины.
- Подтверждение. Бот показывает карточку. Сотрудник подтверждает её, дополняет или закрывает. В первом пилоте карточку можно перенести в ваш трекер вручную.
Для небольшого теста можно получать обновления через getUpdates. Если у приложения уже есть публичный HTTPS-адрес, можно принимать их через webhook и проверять заголовок с секретом, настроенным в Telegram. Эти режимы нельзя использовать одновременно для одного бота. В группе с включённым режимом приватности не рассчитывайте, что бот увидит обычную переписку. Начните с явной команды или сообщения в ответ боту.
Опишите результат до подключения модели
Согласуйте поля с тем, кто будет принимать задачи. Для пилота хватает такой карточки:
- Проблема: кнопка «Получить КП» выглядит некорректно на телефоне.
- Где смотреть: ссылка на страницу не указана. Уточнить у автора.
- Проверка: открыть страницу на телефоне и проверить положение и нажатие кнопки.
- Готово, когда: кнопка целиком видна и открывает нужную форму.
- Ответственный и срок: назначает координатор.
В инструкции модели задайте простой принцип: неизвестное вынести в уточнения. Ответственного, ссылку и срок нельзя брать из догадки. На уровне приложения ограничьте допустимые действия. Текст из сообщения пользователя и ответ модели сами по себе не дают прав менять сайт, писать клиентам или добавлять задачу.
Прогоните пилот до доступа к рабочей группе
| Вход | Что проверить |
|---|---|
| Есть URL, устройство и симптом | В черновике сохранились исходные факты |
| «Не работает сайт» | Есть уточнение, какой сайт и при каком действии |
| То же обновление доставлено повторно | В журнале одна карточка |
| Сообщение пришло из другого чата | Черновик не создан |
| Модель ответила с ошибкой или не по формату | Бот сообщает о сбое и не создаёт задачу |
Сравните результаты пилота с ручным разбором: сколько карточек пришлось переписать, какие факты потерялись, на каком шаге сократилось время. Только после этого решайте, нужна ли кнопка создания задачи в CRM. Для неё потребуется отдельная проверка полномочий и повторных нажатий.
Технические детали сверяйте по Telegram Bot API. Для самой постановки задачи пригодится шаблон задания для ИИ.