The gap
Small businesses take bookings by phone and chat messages, which means interrupted work, double bookings, forgotten appointments and no-shows, while booking platforms charge every month and keep the client list.
Bots and game servers
Slotnik
A self-hosted Telegram bot that books appointments for a small business in Bulgarian and English, with reminders, cancellations, approval and owner commands, from one configuration file.
- Python
- python-telegram-bot
- SQLite
- TOML
- Coming soon
Coming soon
Not published on its store yet, so there is no buy or download link. PN Scripts does not take payment for it here.
What it solves
What it is
Slotnik answers in Telegram around the clock, offers only times that are really free, reminds clients, lets them cancel in time, and sends every booking to the owner, all on the owner's own server.
How you use it
Clients book themselves at any hour; you see each booking at once and never lose the list to a platform.
For barbers, salons, tutors, therapists and workshops that already talk to clients in Telegram, Slotnik is a booking bot you host yourself, in Bulgarian and English, paid once.
Who it is for
Use it when
- A barber shop or beauty salon with two or three people
- A tutor, trainer or therapist who books sessions by the hour
- A car service or repair shop that takes appointments for inspections
Built for
- Small service businesses in Bulgaria that talk to clients in Telegram
- Developers and agencies who set up booking for local businesses
What is inside
For clients
A menu with booking, their bookings, address and contacts, and a language switch. Only days with free time are offered; the time list shows real starts; the phone number is one tap. A summary with the price comes before the confirmation, and reminders arrive the day before and two hours before.
Free times you can trust
Hours with breaks, each person's own schedule, service length plus cleaning buffer, minimum notice and booking horizon decide what is offered. Bulgarian holidays and the days off after weekend holidays are closed unless you open them. A transaction re-checks every booking, so the second of two clients is shown the remaining times.
For the owner
Each booking and cancellation arrives in your chat with the client's name and phone. /day lists the day in order with blocked time; /block closes hours or a whole day for one person or everyone; /cancel tells the client the reason; /export sends a CSV for Excel or LibreOffice. Approval mode adds Approve and Decline buttons.
Set up in one file
Business, hours, services, prices, people and rules live in slotnik.toml. slotnik check validates it with clear errors and shows the first free times; slotnik slots lists a day. The token stays in an environment variable, bookings in SQLite, and the included systemd unit keeps the bot running.
Gallery
This file could not be loaded.
This file could not be loaded.
This file could not be loaded.
This file could not be loaded.
This file could not be loaded.
1 of 5
Specs
- Availability
- Coming soon
- Vendor
- PN Scripts
- Type
- Software
- Pricing
- One-time purchase Price to be announced.
- License
- Proprietary
- Deployment
- Download (ZIP with the Python source, example configuration and systemd unit)
- Maturity
- v1.0.0
Compatibility
| Platform or runtime | Supported versions | Tested up to |
|---|---|---|
| Python | 3.11 or newer | 3.12.3 |
| python-telegram-bot | 22.0 or newer | 22.8 |
Stack
- Python
- python-telegram-bot
- SQLite
- TOML
Slotnik is coming soon
It is finished and tested. It is not on sale yet; this page will say where to get it when it is.
Coming soon
Not published on its store yet, so there is no buy or download link. PN Scripts does not take payment for it here.
Questions
A Telegram bot you run on your own server that takes appointments for one small business, in Bulgarian and English, with reminders, cancellations, optional approval and commands for the owner.
Python 3.11 or newer on a server or always-on computer with internet access, and a bot token from Telegram's BotFather. No domain, web server or open port is needed. Tested with Python 3.12.3 and python-telegram-bot 22.8.
Online payments and deposits, other messengers, and hosting. One bot serves one business; for two locations you run two bots. You are responsible for your clients' personal data on your server.
PN Scripts wrote the bot and tested it end to end against a fake Telegram Bot API over HTTP. Created with AI assistance; the booking rules, both languages and every command were checked by PN Scripts with 40 automated tests, including end-to-end runs against a fake Telegram Bot API.
It is not on sale yet. When it is, this page will link to the store; PN Scripts does not take payment on this site.