Build Now

Telegram API: Integrate Chats & Messaging into Your App

Connect your users' Telegram accounts to your application with one unified API. Send and receive messages, sync conversations, share files and manage contacts, with simple QR code authentication.

Telegram Personal Account
QR Code Auth
Build Now Documentation
7-Day Free Trial
Your App
Synced
David Chen
Chats 18
Groups 7
Files 24
Contacts 156
Marco RiveraPersonal
Just now
@marco_dev
Hey! Just reviewed the API docs, the integration looks smooth 🚀
Sophie LaurentPersonal
12 min
@sophie_lrt
Contract signed ✅ Sending onboarding docs now
James Donovan📎 File
45 min
@jdonovan
Shared: Architecture_Diagram_v2.pdf
Priya SharmaPersonal
2h
@priya_s
The webhook is firing correctly now, thanks! 🎯
💬
Engineering Team
6
+12 members
Marco: Deployment pipeline is green, pushing to staging ✅
1.2k msgs 45 files
📢
Product Updates
Channel
+248 subscribers
New release: v3.2 is now available with Telegram support 🎉
89 posts 3.4k views
🤝
Client - TechFlow
2
+4 members
Sophie: Invoice approved, starting integration next week 📋
156 msgs 11 files
Architecture_Diagram_v2.pdf
2.4 MB · Today, 10:32 AM
James D.
Q1_Revenue_Report.xlsx
845 KB · Yesterday, 4:15 PM
Sophie L.
Product_Mockup_Final.png
3.1 MB · Yesterday, 11:20 AM
Marco R.
Voice_Note_Meeting.ogg
1.2 MB · Mon, 2:45 PM
Priya S.
Integration_Notes.docx
320 KB · Mon, 9:00 AM
Group
Marco RiveraEnriched
@marco_dev
Online Phone Barcelona
Sophie LaurentSynced
@sophie_lrt
Online Paris
James DonovanEnriched
@jdonovan
Offline About San Francisco
Priya SharmaSynced
@priya_s
Online Mumbai
await client.telegram.send("Hi!");

Why Integrating Telegram API
is a Game-Changer for Your Software

Telegram Unified Inbox Compose
TG
Telegram 8
LI
LinkedIn
WA
WhatsApp
GM
Gmail
Marco Rivera2 min
Hey! The API integration looks smooth 🚀
TG
Sophie Laurent15 min
Contract signed ✅ Onboarding docs sent
TG
James Donovan1h
Shared: Architecture_Diagram.pdf
TG
Syncing Telegram conversations in real time...
Telegram Webhook Events Configure
TG
Marco Rivera sent a message
New Message Webhook fired
Just now
Sophie Laurent read your message
Read Receipt Chat synced
5 min
James Donovan shared a file
Attachment Architecture.pdf
12 min
Priya Sharma reacted 👍
Reaction On your message
30 min
Webhook payload
{ "event": "message.new",
  "provider": "TELEGRAM",
  "sender": "@marco_dev" }
Telegram Files & Media Send File
Architecture_Diagram.pdf
2.4 MB · Today, 10:32 AM
James D.
Product_Mockup_Final.png
3.1 MB · Yesterday
Marco R.
Voice_Note_Meeting.ogg
1.2 MB · Monday
Priya S.
Q1_Revenue_Report.xlsx
845 KB · Monday
Sophie L.
Up to 2 GB per file
Leverage Telegram's generous file size limits via API
Unified Chat Management
Integrate Telegram conversations alongside LinkedIn, WhatsApp, and email into a single inbox. Manage all your users' communication channels without switching between platforms.
Real-Time Sync & Webhooks
Receive instant notifications for new messages, reactions, and read receipts via webhooks. Keep your app synchronized with Telegram in real time — no polling required.
Rich Media & File Sharing
Send and receive documents, images, voice notes, and any file type through the API. Leverage Telegram's generous 2 GB file size limit to share rich content directly from your application.
Telegram Unified Inbox Compose
Marco Rivera2 min
Hey! The API integration looks smooth 🚀
TG
Sophie Laurent15 min
Contract signed ✅ Onboarding docs sent
TG
James Donovan1h
Shared: Architecture_Diagram.pdf
TG
Syncing Telegram conversations...
Unified Chat Management
Integrate Telegram conversations alongside LinkedIn, WhatsApp, and email into a single inbox.
Real-Time Sync & Webhooks
Receive instant notifications for new messages, reactions, and read receipts. No polling required.
Rich Media & File Sharing
Send documents, images, voice notes up to 2 GB per file via the API.
Telegram Messaging API

Telegram API Integration
for Messaging & Contacts

Send, receive, and sync all Telegram conversations, group chats, and attachments directly within your application.

Your App
Synced
Marco Rivera
Marco Rivera
Telegram LinkedIn Gmail Calendar +1
Message Email Calendar
Telegram Telegram LinkedIn LinkedIn Gmail Gmail
Me · 2:30 PM
Hi Marco! 👋 Following up on our call. Here's the proposal we discussed.
Me · 2:31 PM 📎 FILE
Proposal_Q2.pdf
2.4 MB
Marco Marco · 3:15 PM
Looks great! I'll review with the team and get back to you by Friday 👍
Me · 3:18 PM
Perfect, take your time! Let me know if you need anything else 🚀
Reply to Marco via Telegram...
Sophie
New message Telegram Sophie: Contract signed ✅
Read

Retrieve & Sync Conversations

Sync all Telegram chat history and new messages in real time. Link conversations to contacts in your CRM or platform.

Send & Receive Messages

Send text messages, reply to conversations, and manage read receipts and reactions directly from your application.

Share Files & Attachments

Send and receive documents, images, voice notes, and media up to 2 GB. All attachments synced and accessible via API.

Real-Time Webhooks

Get instant notifications for new messages, reactions, read receipts, and account status changes via webhooks.

Build Now
Multi-Account Management
Offer users the capability to connect and manage multiple Telegram accounts with ease. Facilitate centralized control over various communication channels, enhancing operational efficiency.
Build now
Telegram Telegram
Settings
Add Account
Multi-Channel Sequences

Orchestrate Telegram, Email & LinkedIn in One Sequence

Let your users build automated outreach workflows that combine Telegram, email, and LinkedIn touchpoints, all powered by a single API. Each step fires at the right time, on the right channel, with personalized messages.

Telegram Gmail / Outlook LinkedIn
95% Telegram read rate
4x More replies vs email only
3 min Avg. response time
Build Now
Your App
TG Email LI
Tech Recruiting — Senior Devs Running
Step 1/5
Day 1 Sending…
Telegram Introduction
Direct reach-out via Telegram DM
Hi Alex! 👋 I'm recruiting for a Senior Backend role at a fast-growing fintech. Your open-source contributions caught my eye — open to a quick chat?
Day 3 Pending
Email — Role Details
Full job spec + team overview + compensation
Subject: Senior Backend Engineer — Remote, €90-120K + equity. Here's the full spec and what the team is building right now.
Day 5 Pending
LinkedIn Connection
Connect request + reference to previous messages
Hey Alex — reached out on Telegram & email about the Backend role. Let's connect here too, happy to answer any questions!
Day 8 Pending
Telegram Follow-up
Share a tech blog post + gentle nudge
Hey Alex, thought you'd like this blog post from our CTO on our migration to Rust, still happy to chat if you're curious about the role!
Day 12 Pending
Email — Interview Invite
Calendar link for technical interview
Subject: Ready when you are — book a 30-min technical chat with our lead engineer → calendly.com/...
1Sent
1Opened
0Replied
4Pending
Telegram API

Telegram API Capabilities

Telegram API integration made easy for software editors. Connect personal Telegram accounts via QR code, sync chats, groups, and contacts in real time. No bot API restrictions — full access to personal messaging.

Explore All Endpoints
Messages
Account connectionAccount
Attachments
Webhooks

Messages

10 endpoints available

Send & Reply Messages
Send Voice Messages
Send Video Messages
List Messages, Chats & Attendees
Sync History
Reactions
Delete Message
Read Receipts
Create Group
List Groups & Contacts

Account Connection

2 endpoints available

Hosted Auth: QR code scanning wizard for your end users
Custom Auth: Build your own QR code flow with API endpoints

Attachments

2 endpoints available

Send file attachments (documents, images, video)
Receive file attachments (up to 2 GB per file)

Webhooks

3 events available

Account status changes
New message (sent & received)
New reaction / read receipt / event
Explore API Reference
Use Cases

Telegram API Use Cases

Add Telegram messaging to your platform. From recruiting to sales to outreach, give your users a direct and instant line to prospects and clients.

Your ATS
Candidates Jobs
Candidate Job From Created
Senior Dev
Telegram
2 hours ago
UX Lead
Telegram
5 hours ago
Marketer
LinkedIn
1 day ago
Designer
Telegram
2 days ago

ATS Publisher

Let recruiters reach candidates instantly on Telegram, faster replies, fewer no-shows, more placements.

ATS Use Case
Your CRM
Contacts Deals
Contacts Company From Status
NexaTech
Telegram
Responsive
Synthex
Telegram
Interested
Orbix
Gmail
Proposal
Quark
Telegram
Won

CRM Publisher

Sync Telegram conversations into your CRM. Your users manage deals and follow-ups without leaving the platform.

CRM Use Case
Your Outreach Tool
Sequences Contacts
Contacts Company From Status
NexaTech
Telegram
Responsive
Synthex
LinkedIn
Interested
Orbix
Telegram
Proposal
Quark
Telegram
Won

Outreach

Add Telegram steps to multi-channel sequences. Telegram, faster replies, more meetings booked.

Outreach Use Case

Build Features into Your Product Today

Try our White-Label solution for free and unlock its full potential for your business. With the 7-Day Free Trial, gain access to the complete suite of features designed to enhance your platform's capabilities and branding.

How many accounts?
5.00 €
/account/month
How accounts are calculated Pricing is based on the number of linked accounts. For example, 3 Emails + 2 LinkedIn + 6 WhatsApp accounts would cost 55€ (11 x 5€) (or $60.5, 11 x $5.5). No additional cost by request. We have minimum of 49€/month ($55), including up to 10 accounts.

What's included

check
One API. All channels
Linkedin, Instagram, Email, WhatsApp...
check
All Features
Outreach, Real-time Inbox, Enrichment...
check
Unlimited usage
Only providers limit apply.
check
7-Day Free Trial
Build Now
Cancel anytime. No credit card required
Built for Developers

Telegram API Integration for Modern Apps

Connect personal Telegram accounts in minutes via QR code. No Bot API limitations, no phone number verification headaches. Just real-time messaging from your codebase.

Simple Integration

Send messages, sync conversations, and manage contacts with a few lines of code. Our SDK handles QR code authentication, session persistence, and reconnection logic.

telegram-messaging.js 
// Connect to Telegram in seconds
import { UnipileClient } from 'unipile-node-sdk';

const client = new UnipileClient({
  dsn: 'https://api.unipile.com',
  token: process.env.UNIPILE_TOKEN
});

// Connect a Telegram account via QR code
const { qrCodeString } = await client.account
  .connectTelegram();

// Send a Telegram message
await client.messaging.send({
  account_id: accountId,
  chat_id: 'chat_xyz',
  text: 'Hey! Just sent the proposal 📎'
});

// List all conversations
const chats = await client.chats.list({
  account_id: accountId,
  limit: 50
});
Explore API Reference TypeScript Ready
Telegram
Personal
Telegram
Multi-Acc
One Unified API

RESTful API

Clean, standardized endpoints with JSON responses. Send messages, list chats, and manage contacts through predictable REST calls.

Real-time Webhooks

Get instant notifications for new messages, read receipts, reactions, and status changes. No polling, no delays.

Key Advantage

No Bot API Restrictions

Unipile connects real personal Telegram accounts, not bots. Full access to private chats, groups, and channels — no bot token limits, no "/start" requirement, no user initiation needed.

QR Code Authentication

Seamless QR code login via hosted or custom auth wizard. Automatic session persistence and reconnection — your users stay connected 24/7.

Groups & Contacts Sync

Full access to group conversations, supergroups, participants, and contact lists. Sync and enrich contact data automatically.

File Attachments up to 2 GB

Send and receive images, documents, PDFs, videos, and voice notes. Telegram supports files up to 2 GB — all through a single endpoint.

Build Now
Unified Dashboard

One dashboard for all your integrations

Manage all your LinkedIn, WhatsApp, Gmail accounts and more from a single, intuitive interface.

/
Acme
/
Application
Documentation
API Reference
Changelog
Connect a new account
Select the type of account you
want to connect
LinkedIn
LinkedIn
WhatsApp
WhatsApp
Instagram
Instagram
Telegram
Telegram
Google
Google
IMAP
IMAP
Microsoft
Microsoft
Google Calendar
Google Calendar
Outlook Calendar
Outlook Calendar

Accounts

20 Operational
0 Authentication required
0 Service interruption
0 Paused
Name ID Status Linked
Operational Linked on
03/01/2025
Operational Linked on
02/15/2025
Operational Linked on
02/10/2025
Operational Linked on
03/01/2025
Operational Linked on
02/28/2025
Operational Linked on
02/20/2025
Operational Linked on
03/01/2025
Operational Linked on
02/25/2025
Operational Linked on
03/01/2025
Operational Linked on
02/22/2025
Operational Linked on
02/14/2025
Operational Linked on
02/12/2025
Operational Linked on
02/08/2025
Operational Linked on
02/05/2025
Operational Linked on
03/01/2025
Operational Linked on
02/15/2025
Operational Linked on
03/01/2025
Operational Linked on
02/22/2025
Try for free
Dashboard Demo

Discover More from Our API Suite

Beyond Telegram, Unipile connects your product to LinkedIn, email providers, and calendars. Build a complete communication layer with a unified API approach.

LinkedIn
Instagram
WhatsApp

Messaging API

Connect LinkedIn, Instagram, and WhatsApp to send messages, sync conversations, manage contacts, and automate outreach. Build multi-channel messaging features in your app.

Gmail
Outlook
IMAP

Email API

Integrate Gmail, Outlook, and IMAP providers to send, receive, and sync emails in real time. Build powerful email features with tracking, threading, and attachment support.

Google Calendar
Outlook Calendar

Calendar API

Sync Google Calendar and Outlook events in real time. Create, update, and manage meetings directly from your product. Ideal for scheduling features and CRM integrations.

Our APIs are built for legitimate business use cases. We enforce rate limits and usage policies to ensure a secure, spam-free experience for all users.

4000+ Companies Innovating with Unipile
Trusted by industry leaders
1 API
Streamline operations for all major communication channels
2 Days
Achieve live integration quickly with minimal setup
30%
Reduction in maintenance efforts and resources

Built-In Security and Compliance

Enterprise-grade protection for your data and workflows Learn more about our security
SOC 2 Type II
SOC 2 Type II
Certified
Independently audited security controls ensuring data protection and operational integrity.
GDPR
GDPR
Compliant
Full compliance with European data protection regulations for user privacy.
99.9%
Platform Uptime over the last 24 months
24/7
Global Support with high-performance API

Telegram API FAQ

Common questions about integrating Telegram into your product with Unipile

Telegram's Bot API only allows bots to interact with users who initiate the conversation first. With Unipile, you connect real personal Telegram accounts — not bots. This means your users can send messages to anyone, access private chats and groups, and sync full conversation history. No "/start" requirement, no user initiation needed.
Users scan a QR code from the Telegram app on their phone — similar to WhatsApp Web. You can use our Hosted Auth Wizard (one API call to generate a link) or build a custom QR code flow using our API endpoints. Sessions persist automatically and reconnect without user action.
Yes. Each user can connect multiple Telegram accounts, all managed through the same API. This is ideal for teams handling several Telegram profiles from a single dashboard — common in sales, recruiting, and customer support use cases.
You can send text messages, images, videos, voice notes, and documents (PDFs, spreadsheets, etc.). Telegram supports file attachments up to 2 GB per file — far more than WhatsApp's 15 MB limit. You can also send reactions, read receipts, and reply to specific messages.
Yes. Unipile provides webhooks that fire instantly when a new message is sent or received, when a message is read, or when a reaction is added. No polling needed — your app stays in sync in real time. You also get webhooks for account status changes (connected, disconnected, etc.).
Unipile uses a pay-per-account model — you only pay for connected accounts, not per message or API call. A free trial is available with no credit card required. Check our pricing page for current plans and volume discounts.
Yes. Unipile is fully GDPR compliant with all data stored in Europe by default. We offer DPA agreements upon request and assign fixed proxies per account to ensure security. SOC 2 certification is currently in progress — contact us for details on enterprise security requirements.

Still have questions? Our team is here to help.

en_USEN
fr_FRFR es_ESES de_DEDE it_ITIT pt_BRBR nl_NLNL pl_PLPL tr_TRTR en_USEN