Airtable | Adjabkhanian

Telegram Bot “Dialog of Truth”

Tue, 15 Jul 2025 00:00:00 +0000

🧠 Project Idea

This Telegram bot was developed for the spiritual and educational initiative “Dialog of Truth” to:

Automate contact collection from Instagram users
Understand participant motivation through a short survey
Enable admins to broadcast messages to the entire database
Seamlessly integrate with Airtable

🔍 What Does the Bot Do?

A user joins the bot via a link from Instagram
They are asked to provide:
- 📱 Phone number (via a button)
- 📧 Email address
- 👤 First and last name
- ❓ Answer to: “Do you want religious knowledge?”
The bot saves all the data to Airtable
Sends a link to the main Telegram channel
The admin can send a broadcast with the /sendall command

📊 Survey Inside the Bot

Do you want religious knowledge?
• To receive and apply it for myself
• To receive, apply, and share it with others
• I just want to observe for now

All responses are also saved in Airtable.

🛠 Technologies Used

Python 3.11
Aiogram 3.x — asynchronous Telegram bot framework
Airtable — external database for storing structured user data
Railway — deployment without exposing tokens (via ENV)
GitHub — source code is private, available upon request

🖼 Project Cover

📂 Airtable Data Structure

Telegram ID
Username
Phone
Email
First Name
Last Name
Survey Answer
Registration Date

📦 Admin Features

✅ /sendall Hello! — sends a message to all users
🔐 Only specified Telegram IDs can broadcast
🧑‍💻 All collected data is stored in Airtable and can be exported easily

💡 Who Is This For?

Online schools and educational communities
Projects growing from Instagram or Telegram
Small teams without complex CRM systems

📥 How to Deploy

Create an Airtable base with the required fields
Add secret variables in Railway:
- BOT_TOKEN
- AIRTABLE_API_KEY
- AIRTABLE_BASE_ID
- AIRTABLE_TABLE_NAME
Deploy the bot on Railway
Connect a domain and share the link in your Instagram bio

🎯 Results

A clean Telegram-based form that acts as a mini landing page
All user data in Airtable for future communication and analysis
Quick survey for audience segmentation

📎 Want to Collaborate?

If you want to create a custom Telegram bot for your project —
Contact me →

🛠 Additional Resources

ZarplataBot — Telegram Bot for Shift, Bar, and Report Management

Mon, 09 Jun 2025 00:00:00 +0000

🔍 About the Project

ZarplataBot is a Telegram bot designed to automate financial tracking in small teams such as baristas, shift workers, support staff, and administrators. It replaces manual spreadsheet entries and helps track:

💼 Work shifts (day and night)
🍷 Bar income with dynamic percentages
💸 Expenses with comments
🚫 Fines and deductions
📊 Monthly reports with filtering

The project was developed as a personal internal automation solution but can scale to any team.

💡 Why I created this?

Working in a team where tracking was often done manually, I noticed:

Shift records were forgotten
Expenses got lost
Income was estimated roughly
Reports had to be collected piecemeal

To remove routine and errors, I decided to automate the process via Telegram, which everyone uses daily.

🔧 Features

🕑 Adding shifts: day or night (with fixed rates)
🍷 Bar accounting: income percentage depends on the amount (dynamic)
- up to 3500 — 5%
- 3500 to 4000 — 6%
- 4000 to 4500 — 7%
- …
- from 10,000 — 15%
💸 Entering expenses with comments (e.g., “300 food”)
🚫 Fines with explanations (“500 late”)
📊 Monthly reports — current, previous, and manually selected
🗃 All data stored in Airtable — easy manual editing
⏱ Instant response — via Telegram bot, no need to open spreadsheets

🔌 Integrations

Telegram Bot API — user communication
Airtable API — database editable manually if needed
SQLite — local storage fallback
Railway — deployment and 24/7 uptime
GitHub — project storage and updates

🚀 Deployment

The bot is deployed on Railway, allowing 24/7 operation without relying on local machines. Code updates are done by git push to GitHub, and Railway automatically rebuilds and restarts the bot.

🖼 Interface

Users interact with the bot via buttons:

▶️ Start
🕑 Day / 🌙 Night shift
🍷 Bar
💸 Expense
🚫 Fine
📊 Report

Each action is accompanied by confirmations and interactive messages. The interface is adapted to Telegram UX.

🛠 Technologies Used

Area	Technologies
Language	Python 3.11
Framework	Aiogram 3
APIs	Telegram Bot API, Airtable REST
Hosting	Railway
Storage	SQLite + Airtable
CI/CD	GitHub + Railway Integration

📦 Project Repository

Code available on GitHub:

👉 github.com/adjabkhanian/zarplata-bot

📈 Future Plans

User authorization
Google Sheets integration
PDF reports
Analytics with charts
Admin panel via web interface

💬 Conclusion

ZarplataBot is not just a bot but a working tool for accounting and transparency. It removes chaos and makes routine pleasant.

If you want to adapt this bot for your team — contact me 😉

🚀 Telegram Bot for Task Management with Airtable

Fri, 16 May 2025 00:00:00 +0000

📱 Telegram Bot for Field Tasks

Project: a smart Telegram bot that helps field teams efficiently complete tasks and report on them in just a few clicks.

❓ Why do you need this bot?

Many companies face problems like:

🚫 Tasks get lost, employees forget to report
📉 Managers find it hard to track task status
🕒 Photo reports are collected manually and slowly

Solution: a bot that handles it all. Simple, fast, and clear.

⚙️ How does it work?

👤 Employee starts /start, selects their role and enters their name
🔘 Gets a “Go to tasks” button
🗺️ Selects a region (e.g., “North” or “Center”)
📋 Sees a task list:
- 🔧 Fix the network
- 📶 Install Wi-Fi
📸 Clicks “Complete task” and sends a photo report
🤖 Bot:
- saves the photo and executor’s name
- 💾 updates Airtable
- sends “✅ Task completed”
- automatically returns to region selection

🌟 Why is this convenient?

Features:

🧠 FSM: bot “remembers” user’s current step
🖱️ Intuitive buttons: “Back,” “Select region,” “Complete”
🎨 Emojis: add visual logic and make interaction pleasant
📷 Photo required: task cannot be completed without a photo
☁️ Airtable link: tasks live in the cloud and update in real time
🔄 Auto navigation: no manual return needed — bot does it automatically

📊 Airtable as a database

Uses an Airtable base where:

🗂️ Tasks are stored by roles and locations
📸 Photos and executor names are saved
✔️ Status updates after task completion

Integration via API — everything happens automatically.

🚚 Where is it useful?

📦 Courier services
🛠️ Installation teams
👷 Engineers and service teams
🏢 Internal company task management

💡 Advantages of the solution

🖱️ Minimal clicks — maximum results
📲 No separate app needed — works in Telegram
🌍 Scalable and flexible
👥 Easy to add new employees

🖥️ 24/7 Deployment

Bot hosted on a server:

🌐 VPS rental (e.g., Timeweb Cloud)
🐍 Installing Python, Git, pip
📂 Cloning the code repository
⚙️ Setting up .env file with keys
▶️ Running: python3 main.py
📟 Using tmux — bot works even when terminal is closed

📩 Want a bot like this?

Write to us — and we’ll automate your team’s tasks together!

Contact:

Telegram: @adjabkhanian
Email: adjabkhanian@gmail.com

⚡ Automate tasks. Free up time. Grow faster.