- Integrations
- Telegram
Telegram integration: new requests and alerts in your team's Telegram chat
Agenola's Telegram integration sends new support requests and alerts to your team's Telegram group or to your private chat, and your agents can send messages, photos and documents to the linked chats. You just add the Agenola bot to the chat; there's no token or key to copy.
How it works
You add a chat from the Integrations → Telegram page: add the bot to a group, or start a chat with the bot to receive notifications yourself. The chat is listed in the dashboard as "Group" or "Private chat".
You choose which notification goes to which chat on the Account → Alerts and notifications page: a new support request, a frustrated visitor, a completed conversation record, a question that keeps going unanswered, credits running low, a broken integration connection and payment problems.
Flow steps send messages, photos, videos, documents and locations to linked chats; edit, pin and delete messages; and fetch a chat's details and admins.
- The bot only sees commands addressed to it; it doesn't read the group's conversation.
- Today the Telegram integration is for team notifications; for messaging with your customers, you can use WhatsApp.
- The "Delete message" and "Leave chat" steps don't run until the confirmation box on the step is ticked.
- If the bot is removed from a chat, the chat is marked "Bot removed" and no notifications go there.
What it does
This list is generated from the same source as the Telegram page in the dashboard: if it isn't listed here, we don't do it with Telegram. Flow steps live in the flow editor under Add step → Integrations → Telegram.
Team messagesAction · Flow step14
Send message
Posts a team message with the title, collected answers and note to the chosen chat through Agenola's notification bot.
Edit message
Changes the text of a message the bot sent.
Delete message
Deletes a message in the chat.
Pin message
Pins the message to the top of the chat.
Unpin message
Unpins the message.
Send photo
Sends the photo at the URL with a caption.
Send video
Sends the video at the URL with a caption.
Send audio
Sends the audio file at the URL as a music player.
Send document
Sends the file at the URL as a document.
Send animation
Sends a GIF or silent video as an animation.
Send sticker
Sends a sticker by file ID or URL.
Send location
Sends the location at the latitude and longitude.
Send media group
Sends several photos and videos (2–10) as one group.
Send chat action
Briefly shows a status such as "typing…" in the chat.
Team chatsAction · Flow step6
Get chat
Reads the chat's name, type and description.
Get administrators
Returns the chat's administrators as a list.
Get member
Reads a user's status in the chat.
Leave chat
The bot leaves the chat; notifications stop going there too.
Set description
Changes the chat's description (the bot must be an admin).
Set title
Changes the chat's name (the bot must be an admin).
FileAction · Flow step1
Get file info
Reads the file's size and path; the download URL isn't given because it contains the bot token.
TriggerTrigger · On connect1
Chat linking
When the notification bot is added to a group or to your private chat, that chat is linked to this workspace; if the bot is removed from the group, the chat is marked “bot removed”. The bot only sees commands addressed to it; it doesn't read the group's conversation.
Example conversations
Visitor: My order arrived damaged and I'd like to speak to someone.
Agent: I'll pass this to our customer service team. Could I have your order number and phone number?
Visitor: 5521, +1 917 555 0166
Agent: Done. Our team will call you as soon as possible.
Behind the scenes: The request lands in your dashboard and a message goes to the team's Telegram group: the agent's name, the reason, the visitor's phone number and a link that opens the request in your dashboard.
Visitor: This is the third time I'm asking: when will my refund arrive?
Agent: You're right, and I'm sorry for the wait. I'm passing your refund request to our team as a priority.
Behind the scenes: When the agent notices the visitor is frustrated, an alert goes to your team's Telegram chat; it's sent once per conversation.
Setup
- 1In Agenola, go to Integrations → Telegram and press "Add chat" on the Team notifications card.
- 2Choose "Add to group" to add the bot to a group, or "Add to my chat" to receive notifications yourself. Telegram opens; pick the group and add the bot, or start the chat with the bot.
- 3Once the dashboard shows "Chat linked.", choose which notifications go to this chat on the Account → Alerts and notifications page.
Detailed setup: How do I set up Telegram notifications?
Permissions and where your data goes
- Sent to Telegram: in notifications, the agent's name, the reason, the visitor's contact details and a dashboard link; in flow steps, the messages you write and the files you send.
- Read from Telegram: the chat's name and type when it's linked; chat and admin details when a flow step asks. The group's messages are not read.
- No token or key is needed; Agenola's own bot is used.
- Only the workspace owner and admins can add or remove chats. When you remove a chat, the notifications and steps going there stop; if no other workspace uses the chat, the bot leaves the group.
Related integrations
See all integrations
Frequently asked questions
Does the bot read our group's conversations?
No. The bot only sees commands addressed to it; it doesn't read the group's conversation.
Can I talk to my customers on Telegram?
Today the Telegram integration is for team notifications. For messaging with your customers, you can use WhatsApp.
What should I do if I see "The link has expired"?
The link for adding a chat is valid for a short time. Press "Add chat" in the dashboard again, then add the bot or start the chat in Telegram.