Team Telegram
Get work alerts on Telegram, take tasks with one tap and open your day in the "My day" Mini App.
Updated:
Team Telegram is the fastest way for everyone in the business to know what is theirs: an assigned task, an unclaimed job, a reminder or the daily summary. It works from your phone, with nothing to install except Telegram.
There is one single Fiuit bot for all teams. It is not your business's bot: that one talks to your customers (customer Telegram). The two are independent and never mixed.
Link your Telegram
The link is per person, not per business: you do it once and it applies to every business you have access to.
- In the dashboard, open My account (your name, at the bottom of the menu) and tap Link Telegram.
- Tap Open Telegram and, in the bot, Start. The bot confirms the link.
- To unlink, send
/leaveto the bot or unlink from My account.
The link is single-use and expires after 15 minutes. If it expired, generate another. If you do not see Link Telegram, the team bot is not enabled in your environment yet: let us know.
Add someone new through Telegram
If the person isn't on the team and you don't have their number, invite them through Telegram: in My business → Team and resources → Add → Invite, choose Channel: Telegram, type their name and save. We show a link only once to copy or share: when they open it in Telegram and tap Start, they join the team and get linked. It works once and expires after 48 hours. Only for operational staff; other roles are invited by email. WhatsApp is still the default channel.
The first Telegram account that opens the link uses it, so share it only with that person. When someone uses it, we notify you with their Telegram account name, which you also see on their row and profile in People; if it isn't who you expected, deactivate them. If the link was shared too widely before it was used, cancel it: in Pending invitations, Cancel invitation.
Which alerts you get
| Alert | When it arrives |
|---|---|
| Assigned task | Someone assigned a task to you |
| Unclaimed job | There is a queue task your team can take |
| Reminder | An appointment is coming up (team advance notice) |
| Daily report | A summary of your day |
| Changes | One of your tasks was cancelled or changed |
| Expense to approve | Owner and Manager only: someone on the team recorded an expense waiting for your approval (amount and category; never the note) |
Alerts come with buttons so you can act without opening the dashboard:
- Open opens the Mini App straight on that task. For an expense to approve, it opens Finance → Transactions, where Expenses to approve is.
- Take and Complete run the action with your permissions, just like the dashboard. If someone else took the job first, the bot tells you it is already taken.
- Alerts never include data from another business.
Reminders, the daily report and the team notice come from your reminders and rules. If you turn one on, the team receives it on this channel.
Choose how to receive them
In My account → Alert preferences you set:
- Preferred channel: automatic, Telegram, WhatsApp or email. On automatic, Telegram if you have it linked; if not, WhatsApp (with your verified link) and, if not that either, email.
- What to mute: assigned, unclaimed, reminders, daily report, changes or (Owner and Manager) expenses to approve.
If Telegram cannot deliver an alert (for example, you blocked the bot), the alert falls back to the next channel.
Commands
| Command | What it does |
|---|---|
/start | Links your account (with the link from My account) |
/next | Your next task with all the detail: customer, order, address, Google Maps and Waze, and its stage buttons. Completing it shows the following one |
/next5 | Your next 5 tasks, with Start or View to choose the order |
/free | Unassigned tasks you can take, with Take |
/today | Shows your day, per business |
/expense | Records an expense: type it («spent 5000 on supplies») or send the receipt photo |
/leave | Unlinks your Telegram |
/help | Reminds you how to take a task, move it to the next stage, share your live location and the commands |
Your next task with /next
/next shows a single task: the one you already have in progress or, if none, the next one by today's schedule (overdue first; tasks without a time at the end). Tap Start, On my way or Complete (the names are your business's stages) and the bot sends the following one on its own, until none are left.
If moving on needs something missing (a photo, a required field, the payment or your location), the card says what is missing and Open takes you to the task in the Mini App. Cancelling or marking that the customer was not there is also done in the Mini App. Buttons only do what your role allows, and an old button of a task that already changed does not move it forward: it shows how it is now.
Record an expense
Message the bot «spent 5000 on supplies» (or «paid 80 for fuel yesterday», or just «expense 30 fuel»), use /expense or send the receipt photo, with or without text. The photo is kept as the expense receipt; the bot doesn't read the receipt, so if you didn't type the amount it asks how much it was.
- If the amount isn't clear (for example, two numbers, or decimals in guaraníes), it asks for the total. Always in your business currency, with no conversion.
- If it doesn't recognize the category, you pick one with a button. If you work in several businesses, you first pick which one.
- It shows the expense with the amount, the category and the day, and you confirm with Confirm (or Change category or Cancel).
- If the amount is large for your business (from twice what it pays per month for its plan), it asks for a second confirmation. If the same expense already exists that day, the card warns you so you don't record it twice.
Tapping Confirm twice doesn't record two expenses. What Staff record stays pending approval until the Owner or a Manager approves it (they get the Expense to approve alert); what the Owner and Managers record counts right away. Roles that don't record expenses get a notice and nothing is recorded.
"My day" Mini App
The bot's menu button (to the left of the text field) opens My day: the dashboard in a compact format inside Telegram, without asking for a password. It shows the same as you would see in the dashboard for your role: Today and Work (with "Mine" by default for staff) and a business selector if you have several.
- The session lasts 60 minutes and only reaches Today, Work and tasks. It gives no access to API keys, team, channels or webhooks.
- It ends on its own if you unlink Telegram or are removed from the business.
Team group
Besides personal notices, the business can have one Telegram team group where unassigned tasks are posted with a Take button. The first tap wins: if two people tap at the same time, only one gets assigned and the other sees it was already taken.
- An Owner or Manager with their Telegram already linked adds the team bot to the group.
- In the group they type
/linkand tap Confirm (if they manage several businesses, they pick one). Only whoever asked can confirm. - Optional, in a group with topics: inside a topic, type
/topicand pick the zone or work team whose tasks go there. The rest go to the general topic.
| Group command | What it does |
|---|---|
/link | Links the group to the business (with confirmation) |
/topic | Chooses which zone or team posts in this topic |
/unlink | Stops posting tasks in the group |
- Only people from the business with their Telegram linked and permission to take tasks (and, for staff, within their team and zone) can Take. The bot does not answer anyone else.
- A post shows only the service, the time and the zone: never the customer, the address or the phone. When someone takes it, the message says who and loses the button.
- There is one group per business and one business per group. View and unlink it in My business → Team and resources → person profile; it is also cut if you remove the bot from the group.
- The bot posts at most 20 messages a minute in the group; the rest waits in the queue.
- When the group is replaced or migrated to a supergroup, unassigned tasks are posted again in the linked group. Buttons on older messages reply “This group is no longer linked” and do not assign the task.
Limits and security
- In private chats the bot only talks to one person; in the team group it only reads its own commands and buttons.
- Telegram allows 1 message per second per chat; if many alerts arrive together, the next ones wait in a queue and still arrive.
- The link and the Mini App are always validated on the server. A used, expired or other-account link gets the same neutral message.
To see what each person can view and do, read Roles and permissions. For developers: the endpoints GET/DELETE /me/telegram, POST /me/telegram/link and GET/PUT /me/notification-preferences belong to the user's account (dashboard session) and are not used with API keys.