Stirling-PDF/frontend/src/core
Ludy e7b030e6b5
Add Telegram bot integration for pipeline processing (#5185)
# Description of Changes

This pull request introduces Telegram bot integration to the
application, enabling users to send files via Telegram for processing
through the pipeline. The main changes add configuration options,
dependency management, and a new service for handling Telegram
interactions.

**Telegram bot integration:**

* Added a new `TelegramPipelineBot` service (`TelegramPipelineBot.java`)
that listens for incoming Telegram messages, downloads attached files or
photos, places them in a pipeline inbox folder, waits for processing
results, and sends the output files back to the user. The service
includes error handling and status messaging.
* Introduced a `TelegramBotConfig` configuration class to initialize and
register the Telegram bot only when enabled via application properties.
* Added a new `Telegram` configuration section to
`ApplicationProperties` and the `settings.yml.template`, supporting
options like enabling/disabling the bot, bot token/username, pipeline
folder, processing timeout, and polling interval.
[[1]](diffhunk://#diff-1c357db0a3e88cf5bedd4a5852415fadad83b8b3b9eb56e67059d8b9d8b10702R63)
[[2]](diffhunk://#diff-1c357db0a3e88cf5bedd4a5852415fadad83b8b3b9eb56e67059d8b9d8b10702R580-R589)
[[3]](diffhunk://#diff-12f23603ae35319a3ea08f91b6340d5d935216941fda2e69d2df1b6cd22a63f2R108-R115)

**Dependency management:**

* Added the `org.telegram:telegrambots` library to the project
dependencies to support Telegram bot functionality.

---

## Checklist

### General

- [ ] I have read the [Contribution
Guidelines](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/CONTRIBUTING.md)
- [ ] I have read the [Stirling-PDF Developer
Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/DeveloperGuide.md)
(if applicable)
- [ ] I have read the [How to add new languages to
Stirling-PDF](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/HowToAddNewLanguage.md)
(if applicable)
- [ ] I have performed a self-review of my own code
- [ ] My changes generate no new warnings

### Documentation

- [ ] I have updated relevant docs on [Stirling-PDF's doc
repo](https://github.com/Stirling-Tools/Stirling-Tools.github.io/blob/main/docs/)
(if functionality has heavily changed)
- [ ] I have read the section [Add New Translation
Tags](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/HowToAddNewLanguage.md#add-new-translation-tags)
(for new translation tags only)

### UI Changes (if applicable)

- [ ] Screenshots or videos demonstrating the UI changes are attached
(e.g., as comments or direct attachments in the PR)

### Testing (if applicable)

- [ ] I have tested my changes locally. Refer to the [Testing
Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/DeveloperGuide.md#6-testing)
for more details.

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Anthony Stirling <77850077+Frooodle@users.noreply.github.com>
2026-01-13 22:14:59 +00:00
..
components Add Telegram bot integration for pipeline processing (#5185) 2026-01-13 22:14:59 +00:00
constants feat(conversion): refactor EML parser to use Simple Java Mail library and add MSG support (#5427) 2026-01-13 21:17:40 +00:00
contexts OCR fix and Mobile QR changes (#5433) 2026-01-12 11:18:37 +00:00
data photo scan V2 (#5255) 2025-12-30 18:55:56 +00:00
hooks feat(conversion): refactor EML parser to use Simple Java Mail library and add MSG support (#5427) 2026-01-13 21:17:40 +00:00
i18n [V2] feat(pdfa): add PDF/A-3b option with updated descriptions and translations (#5286) 2025-12-22 15:17:47 +00:00
pages photo scan V2 (#5255) 2025-12-30 18:55:56 +00:00
services Shorten onbaording (#5198) 2025-12-15 09:31:41 +00:00
styles Fiix colours (#5211) 2025-12-10 11:10:34 +00:00
testing 🤖 format everything with pre-commit by stirlingbot (#5426) 2026-01-13 16:02:25 +00:00
tests feat(conversion): refactor EML parser to use Simple Java Mail library and add MSG support (#5427) 2026-01-13 21:17:40 +00:00
theme Restructure frontend code to allow for extensions (#4721) 2025-10-28 10:29:36 +00:00
tools Fix PDF editor (#5393) 2026-01-08 09:27:55 +00:00
types Feature/v2/redact (#5249) 2026-01-05 15:12:14 +00:00
utils feat(conversion): refactor EML parser to use Simple Java Mail library and add MSG support (#5427) 2026-01-13 21:17:40 +00:00
workers Feature/v2/compare tool (#4751) 2025-11-12 14:54:01 +00:00
App.tsx photo scan V2 (#5255) 2025-12-30 18:55:56 +00:00
i18n.ts Handle restricted language configuration fallback V2 (#5154) 2025-12-10 11:12:18 +00:00
setupTests.js Restructure frontend code to allow for extensions (#4721) 2025-10-28 10:29:36 +00:00
setupTests.ts OAuth Provider Buttons (#5103) 2025-12-03 10:54:53 +00:00