GestAImmo - Option B: Resident Telegram Gateway

GestAImmo - Option B: Resident Telegram Gateway An architecture diagram generated by Archify. Resident Telegram · Mobile / Desktop App · Architecture component · Telegram Client Resident Telegram Mobile / Desktop App Telegram Client Telegram Bot API · api.telegram.org · Architecture component · Webhook & Push Telegram Bot API api.telegram.org Webhook & Push Telegram Router · modules/telegram/router · Architecture component · Express :3001 Telegram Router modules/telegram/router Express :3001 Telegram Service · lib/telegramService.js · Architecture component · Bot Logic & Auth Telegram Service lib/telegramService.js Bot Logic & Auth Core Database · SQLite / PostgreSQL · Telegram Core Subsystem · People & Logs Core Database SQLite / PostgreSQL People & Logs Manager Web UI · ThirdPartyAppsModal · Architecture component · React / TelegramCard Manager Web UI ThirdPartyAppsModal React / TelegramCard n8n Automation · telegram-bot-resident-feeder · Architecture component · Low-Code Feeder n8n Automation telegram-bot-resident-feeder Low-Code Feeder resident messages POST /webhook dispatch command verify & query dues reply message POST /broadcast automated alerts Telegram Core Subsystem Legend Frontend Backend Database Cloud External

Resident Interaction

  • • OTP code binding (/verify) links Telegram chat ID to person record
  • • Instant query for condo balance, overdue dues, and upcoming assembly dates
  • • Interactive maintenance ticket creation with photo/description attachments

Secure Architecture

  • • HMAC / Bearer verification on webhook ingress
  • • Granular audit trails in telegram_bot_logs table
  • • Zero exposure of private condo accounting data to unverified users

Automation & Broadcast

  • • Building managers broadcast urgent alerts to verified tenants
  • • Declarative n8n workflow triggers scheduled payment notices