Interacting with the Bot
In addition the the web UI, much of the interaction with TrufotBot is through, unsurprisingly, a bot (on Telegram).
TrufotBot uses Telegram's [Inline Keyboards] to make some interactions quicker, see below.
Notifications
When medication is given, a message will be sent in the configured Telegram group. It will include the time of the dose relative to the time the notification was sent (usually "now", but can be e.g. "5 minutes earlier" after editing).
Notifications will have these inline keyboard buttons:
- Edit... ✏️ - This allows you to retroactively modify the time, quantity, and person who gave the dose. This also allows you to delete a dose.
- Repeat 🔁 - This immediately records a new identical dose to the selected one (except for the time, which will be "now").
Note
Editing a dose also edits the telegram message. The Telegram app doesn't send notifications for edits, so this is effectively silent. It may take some time to propagate to other users.
Reminders
Reminders are sent in the configured Telegram group. They have these inline keyboard buttons; clicking through any of them will remove the reminder and send a notification instead.
Note
Because the reminder is removed and a notification is sent instead:
- Telegram will notify other members of the group (like for any notification)
- The message will be a new one (even if there were other messages after the reminder).
This prevents a delay, as Telegram doesn't immediately distribute edits to other group members; this helps avoid situations where the other medication-giver in the group doesn't realize medication has been given.
To change this behavior, set the environment variable
TRUFOTBOT_REMINDER_COMPLETION_DELETE_AND_RESEND to false.
- Take 5 💊 - This marks the reminder as completed. Note that 5 will be replaced by the quantity of the most recent non-zero dose for that medication and patient.
- Skip ⏭️ - This is equivalent to "Take 0", and explicitly marks a dose as skipped.
- Take... 📝 - This opens a browser window to
FRONTEND_URLfor recording a specific dosage, with a specific time, given by a specific person.
Natural Input
In a Telegram group assigned to exactly one patient (when the bot is allowed to read group messages), you can log a dose by sending a plain message containing the medication name (or an alias) and the quantity — no slash command required:
| Input | Notes |
|---|---|
Nurofen kids 7.5 |
Base case |
Nurofen kids 7.5ml |
Unit suffix, no space |
Nurofen kids 7.5 ml |
Unit suffix, with space |
Nurfen kidss 7.5ml |
Minor typos matched fuzzily |
Nurofen 7.5ml |
Matches "Nurofen Kids" if only it is enabled |
Ibuprofen 7.5 |
Matches via a configured alias |
- Per-patient, per-medication opt-in: Natural input is disabled by default
for every medication (including after an upgrade). Enable Allow natural
input on a medication's edit page for that patient in the web UI, or use
/natural_from_historyto enable medications the patient has taken recently. - Aliases: You can add comma-separated aliases (such as brand names, generic names, or names in another language) on the medication's edit page. Aliases are shared across patients, while the natural-input switch is per patient and per medication. Saving fails if two medications enabled for the same patient share a name or alias.
- Single-patient groups only: Natural input only works in a group assigned to a single patient (not in private messages with the bot or in groups shared by multiple patients), so the bot knows which patient the dose is for.
- Units are ignored: Any unit suffix (such as
mlormg) is parsed and ignored; the number is recorded directly in the medication's unit. - Bot feedback:
- When a single medication matches, the bot records the dose, reacts with 👍, and posts the standard dose notification (use Edit... ✏️ to edit or delete it).
- When multiple enabled medications tie, the bot replies with the candidates and asks you to rephrase.
- When your message matches a medication that is not enabled for natural input for that patient, the bot replies to say which disabled medication(s) it could have matched.
- Messages shaped like
<medication> <quantity>that match nothing receive a 🤷 reaction; ordinary chatter and replies to other messages are ignored silently.
Commands
These commands can be sent directly to the bot in private messages or in any group the bot is invited to.
/help
Displays help information and available commands. The bot will also provide a copyable button containing the current chat's ID.
It also lists the patients assigned to the current group. In a single-patient
group, /help shows which medications are enabled for natural input together
with their aliases, or suggests /natural_from_history if none are enabled yet.
/record
Records a medication dose. The format is:
/record <patient> <medication> <quantity> [by <username>]
Examples:
/record Alice "Kids Paracetamol" 2
/record Bob Aspirin 1 by Sarah
/record "Fido" "Heartworm Pill" 1
If the patient or medication name contains spaces, use quotes around the name.
Tip
Patient and medication have to be spelled precisely; therefore, it's recommended to use auto-completion (or natural input in single-patient groups).
/natural_from_history
Scans a patient's recent dose history and enables natural input for medications used within a window (90 days by default).
In a patient's Telegram group, run it with no arguments:
/natural_from_history
When messaging the bot directly (or to customize the patient or window in days), pass them as parameters:
/natural_from_history [patient] [days]
Any medication with at least one non-zero dose in the last days days is
enabled for natural input, starting with the most recently dosed; medications
whose name or aliases collide with an already-enabled medication are skipped
and reported. Existing reminder schedules are preserved, and the command is
safe to run multiple times.
Using Auto-Completion
The easiest way to record a dose is through inline autocomplete. Type your bot
username (e.g., @YourMedBot) in any Telegram chat and start typing:
@YourMedBot ali par
The bot will suggest completions based on your history. Selecting a suggestion
inserts the full /record command:
/record Alice Paracetamol 1
How It Works
- Type
@YourMedBotfollowed by a search term - TrufotBot shows up to 10 suggestions based on:
- Matching patient names
- Matching medication names
- Your recent dose history
- Tap a suggestion to insert it as a message
- Send the message to record the dose
Examples
If you frequently give Alice Paracetamol, typing partial matches works:
| You Type | Suggested Completion |
|---|---|
@YourMedBot al p |
/record Alice Paracetamol 1 |
@YourMedBot alice 2 |
/record Alice Paracetamol 2 |
@YourMedBot bob |
/record Bob Metformin 1 |