LinkedIn
Instagram
WhatsApp
Telgraf
Gmail
Görünüm
Google Takvim
Slack Topluluğuna Katılın İçindekiler
Gruplar ve Güvenlik
Telegram API Mesaj Gönderme
Telegram API Mesaj Gönderme: sendMessage ve Bağlı Hesaplar
Telegram mesajı göndermeye kod odaklı bir bakış: Bot API
sendMessage curl, Python ve Node'da endpoint, bir botun birine ilk mesajı yazmasını engelleyen yapısal sınır ve Unipile kullanarak gerçek, bağlı bir Telegram hesabından nasıl mesaj gönderileceği Sohbeti başlat ve sendMessage.# Bot API'si sendMessage
curl -X POST ""https://api.telegram.org/bot$TOKEN/sendMessage"" \
-d chat_id=123456789 \
-d metin="Bot API'den merhaba" \
-d parse_mode="Markdown"200 OK: mesaj gönderildi
Karar Rehberi
Bir Telegram mesajı göndermenin üç yolu ve hangisini seçmeniz gerektiği
Telegram API üzerinden mesaj göndermenin tam olarak üç yolu vardır. Bunlar birbirinin yerine geçemez: her biri mesajı farklı bir tür gönderici olarak, kimin alabileceği konusunda farklı kısıtlamalarla gönderir.
Bot API
sendMessageBotFather''dan alınan bir bot belirteciyle kimlik doğrulaması yapılan tek bir HTTP çağrısı. Bildirimler, uyarılar ve yanıtlar göndermenin en hızlı yolu. İşin püf noktası: bir bot yalnızca kendisiyle halihazırda bir sohbet başlatmış olan kullanıcılara mesaj gönderebilir.
Botlar ve bildirimler için en iyisi MTProto istemcisi (Telegram API)
Şu yolla tam protokol erişimi:
Özel bir istemci oluşturmak için en iyisi api_id ve api_hash, kendi Telegram istemcinizi sıfırdan oluşturmak için kullanılır (Telethon, Pyrogram, TDLib). Uygulaması ve bakımı en zahmetli seçenektir.Bağlı kullanıcı hesabıUnipile
Telegram'ın Cihazlar özelliği (QR kod veya Barındırılan Kimlik Doğrulama) aracılığıyla bağlanmış gerçek bir Telegram hesabı olarak gönderir. "Önce bana mesaj at" kısıtlaması yoktur ve gruplarda ve mevcut sohbetlerde de çalışır.
Büyük ölçekli giden mesajlaşma için en iyisi Bir bot token'ı alma veya bir
api_id / api_hash çift ayrı bir konudur. Bu konunun adım adım anlatımı için tam kılavuzumuza bakın Telegram API erişimi alma. Bu kılavuz, yalnızca kimlik bilgilerine sahip olduğunuzda mesaj göndermeyi kapsar.Telegram entegrasyonunuzu oluşturun
Kod Eğitimi
Bot API sendMessage uç noktasını kullanarak bir mesaj gönderin
Bot API, mesaj göndermek için tek bir HTTP uç noktası sunar:
YAYIN https://api.telegram.org/bot/sendMessage. Bot API 10.2 (14 Temmuz 2026) itibarıyla, gerekli parametreler aynı kalmıştır: a chat_id ve bir text gövde.| Parametre | Tip | Açıklama |
|---|---|---|
chat_id Gerekli | Tam sayı veya Dize | Hedef sohbetin benzersiz tanımlayıcısı veya @kullaniciadi genel bir kanal için. |
text Gerekli | Dize | Mesaj metni, varlık ayrıştırmasından sonra 1 ila 4096 karakter. |
ayrıştırma_modu İsteğe bağlı | Dize | MarkdownV2, HTML veya eski sistem İşaret Dili, kalın yazıyı, bağlantıları ve kod biçimlendirmesini oluşturmak için. |
bildirimi_devre_disa_birak İsteğe bağlı | Mantıksal | Mesajı, anında bildirim sesi olmadan sessizce gönderir. |
yanıt_parametreleri İsteğe bağlı | Nesne | Mesajı, sohbetteki mevcut bir mesaja yanıt olarak gönderir. |
curl -X POST ""https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/sendMessage"" \
-H "İçerik-Türü: uygulama/json" \
-d '{
"chat_id": 123456789,
""text": "#4821 numaralı siparişiniz kargoya verildi.",
"parse_mode": "MarkdownV2"
}'İthalat istekleri
TOKEN = "123456:ABC-your-bot-token"
url = f"https://api.telegram.org/bot{TOKEN}/sendMessage"
yük = {
"sohbet_kimliği": 123456789,
"metin": ""#4821 numaralı siparişiniz kargoya verildi."",
"ayirma_modu": "MarkdownV2"
}
response = istemler.POST(url, json=payload)
print(Yanıt.json())const TOKEN = "123456:ABC-your-bot-token";
const url = `https://api.telegram.org/bot${TOKEN}/sendMessage`;
const response = bekliyor fetch(url, {
method: "POST",
headers: { "İçerik-Türü": "application/json" },
body: JSON.stringify({
chat_id: 123456789,
text: ""#4821 numaralı siparişiniz kargoya verildi."",
ayzırma modu: "MarkdownV2"
})
});
const veri = bekliyor cevap.json();
konsol.log(veri);Kalkma Noktası
Botlar neden ilk mesajı atamaz ve bu sizin için ne anlama geliyor
Yukarıdaki her sendMessage çağrısı, botunuzla hiç etkileşime girmemiş birine ulaşmaya çalışana kadar kusursuz çalışır. İşte o zaman Bot API, hiçbir parametrenin, yeniden denemenin veya geçici çözümün düzeltemediği aşılmaz bir duvara çarpar.
Bir bot, kendisine önceden yazmamış bir kullanıcıya mesaj gönderemez
Bu, bir hız sınırı veya hata değil, Bot API'nin yapısal bir kuralıdır. Bir kullanıcı gönderene kadar /başla (veya herhangi bir mesajı) botunuza,
sendMessage ona chat_id tamamen başarısız olur. Bu, kullanıcının önce ulaştığı destek botları ve isteğe bağlı bildirim botları için sorun teşkil etmez. Botunuzu daha önce hiç açmamış bir kişiye yönelik giden kullanım senaryolarında tamamen çöker: satış amaçlı dış arama mesajları, hesap kurtarma mesajları, işlemsel sinyaller.MTProto istemcisi bu kısıtlamaya sahip değildir: tam bir Telegram API istemcisi, tıpkı Telegram uygulamasının yaptığı gibi herhangi bir kullanıc والا mesaj gönderebilir.
Bağlı bir kullanıcı hesabı onda da yok, çünkü mesaj bir bot tarafından değil, gerçek bir Telegram hesabı tarafından gönderiliyor. Bu, sonraki bölümde ele alınan yaklaşımdır.
Bağlı hesap akışını oluştur
Bağlı Hesap
Unipile ile gerçek bir Telegram hesabından gönder
Unipile gerçek bir Telegram'ı birbirine bağlıyor kullanıcı hesabı, bot değil. Cihazlar arası bağlantı, Telegram'ın kendi Cihazlar özelliği aracılığıyla ya bir QR kod taraması ya da şununla Barındırılan Kimlik Doğrulama (Hosted Auth) ile gerçekleşir:
sağlayıcılar: "TELEGRAM". Mesaj gerçek bir hesaptan geldiği için, aşılması gereken botlara özel "önce bana mesaj at" kısıtlaması yoktur. Şuraya bakın: Telegram API Tam uç nokta listesi için ürün sayfasına bakın.1
startChat ile yeni bir sohbet başlatın
Alıcının bağlantılı hesapla mevcut bir sohbeti olmadığında, arayın
POST /sohbetler ile kullanıcı_idleri ve text. Telegram, kullanıcı çifti başına yalnızca bir bireysel sohbete izin verir; bu nedenle, halihazırda bir sohbet mevcutsa, bu aynı çağrı kopya oluşturmak yerine mesajı doğrudan bu sohbetin içine iletir.İthalat istekleri
url = ""https://api6.unipile.com/v2/${accountId}/chats/send""
başlıklar = {"X-API-ANAHTAR": api_key}
veri = {
"hesap_kimliği": hesap_kimliği,
"kullanici_idleri": [telegram_kullanici_id],
"metin": "Merhaba, talebinizle ilgili takipteyim."
}
response = istemler.POST(url, headers=headers, data=data)
sohbet = cevap.json()
print(sohbet["sohbet_kimliği"]) 1:1 sohbetler için # alıcısının kimliği2
sendMessage ile mevcut bir sohbete gönder
Bir zamanlar
chat_id mevcut, ara POST /chats/{chat_id}/messages sadece text gövde. Bu, devam eden bir sohbet içerisindeki her takip mesajı için kullanılacak çağrıdır.const sohbetKimliği = "CHAT_ID_FROM_STARTCHAT";
const form = yeni FormData();
form.ekle("metin", "Günncellemeniz incelenmeye hazır.");
const response = bekliyor fetch(
`https://api6.unipile.com/v2/${accountId}/chats/${chatId}/messages/send`,
{
method: "POST",
headers: { "X-API-ANAHTAR": apiKey },
gövde: biçim
}
);
const gönderildi = bekliyor cevap.json();
konsol.log(sent.message_id);Her iki çağrı da multipart/form-data alıyor, JSON değil. 1:1 sohbetler için,
chat_id tarafından döndürüldü Sohbeti başlat alıcının kendi kimliği: Bir kullanıcının Telegram tanımlayıcısını öğrendikten sonra, bunu doğrudan tekrar kullanabilirsiniz sendMessage arama adımı olmadan.Unipile ile inşa etmeye başlayın
Gruplar
Bir Telegram grubunun içine mesaj gönder
Bir gruba mesaj göndermek, mevcut bir sohbetle aynı şekilde çalışır:
POST /chats/{chat_id}/messages grubun chat_id ve bir text Gövde. Değişen şey, kendi uç noktalarını kullanan katılımcı yönetimidir.| Operasyon | Uç nokta | Notlar |
|---|---|---|
| GET Katılımcıları listele | /v2/{account_id}/chats/{chat_id}/participants | Grubun mevcut üye listesini döndürür. |
| POSTA Katılımcı ekle | /v2/{account_id}/chats/{chat_id}/participants | Grupta "Diğer üyeleri ekle" izninin etkinleştirilmesi gerekir. |
| SİL Katılımcıyı çıkar | /v2/{account_id}/chats/{chat_id}/participants | Bağlı hesap bir grup yöneticisi olmalıdır. |
Yanıt koduna güvenmeden önce izinleri kontrol edin. Grup "Diğer üyeleri ekle" iznini vermezse veya bağlanan hesap bir yönetici değilse, API kimseyi gerçekten eklemeden veya çıkarmadan yine de başarılı bir yanıt döndürebilir. Her zaman çağrıdan sonra katılımcı listesini doğrulayın, yalnızca durum koduna güvenmeyin.
Unipile'da Telegram için desteklenmeyen özellikler nelerdir?
Kanallar, topluluklar ve yayınlar
Grup yöneticisi eylemleri: üyeleri onaylama veya terfi ettirme
Kişi, konum, anket ve etkinlik ekleri
Sohbeti arşivleme
Sesli ve görüntülü aramalar
Teslim Edilebilirlik
Telegram kısıtlamalarından kaçınmak için en iyi uygulamalar
Bağlanmış bir hesap gerçek bir Telegram kullanıcısı gibi davranır, bu da onun da şu kurala tabi olduğu anlamına gelir: aynı istenmeyen eposta karşıtı standartlar birlik olarak. Unipile'ın resmi rehberliği çok nettir: yanıt alınmadan başlatılan çok fazla sohbet veya çok fazla spam ve engelleme sinyali, hesapta geçici bir kısıtlamaya yol açabilir.
Gecikmeye saygı gösterin
Mesajlar arasında asla 10 ila 20 saniyeden daha az süre bırakmayın. Aralığı değiştirin, sabit bir saatte tetiklemeyin.
Yeni hesapları ısıtın
Yeni bağlanmış hesaplardan yüksek hacimli gönderimler yapmaktan kaçının. Düşük başlayın ve yanıt oranları hesabın güvenilir olduğunu doğruladıkça kademeli olarak artırın.
Yanıt oranlarını izle
Yanıt alınamayan konuşmaların yüksek bir oranı, Telegram'ın bir hesabı işaretlemek için kullandığı en güçlü sinyallerden biridir.
Sıcak iletişim kurmayı tercih edin
Mevcut bir ilişkiye veya referansa dayanan konuşmalar, tamamen soğuk ilk mesajlara göre daha az engelleme oluşturur.
Bu, müşteri tarafında alınacak bir karardır
Unipile gönderdiğiniz mesajları iletir, sizin için mesajlaşma sıklığınızı belirlemez. Gönderim hacmi, zamanlaması ve hızı sizin tarafınızdan belirlenir, hesabın geçmişine ve Telegram'ın belirli bir andaki kendi toleransına bağlı olarak. İlk günden itibaren gerçekçi gecikmeler eklemek, buradaki en yüksek etkiye sahip tek uygulamadır.
Güvenli gönderim limitleriyle geliştirin
Unipile ile Geliştirin
Gerçek bağlı hesaplardan Telegram mesajları göndermeye hazır mısınız?
Telegram, WhatsApp, LinkedIn, Instagram, Gmail, Outlook, IMAP ve ayrıca Google Takvim ile Outlook Takvim üzerinde startChat ve sendMessage için tek bir API. Bir hesap bağlayın ve dakikalar içinde ilk mesajınızı gönderin.
Telegram API Mesaj Gönderme - SSS
Bot API ve bağlı hesaplarla Telegram mesajı gönderme hakkında sık sorulan sorular.
POST çağrısını https://api.telegram.org/bot/sendMessage adresine, bir chat_id ve bir text parametresiyle gönderin. Jeton, BotFather’dan alınır. Bot API’si ücretsizdir ve mevcut sürümü 14 Temmuz 2026 tarihinde yayınlanan 10.2’dir..
Telegram, bir botun herhangi bir şey gönderebilmesi için kullanıcının önce botla sohbeti başlatmasını gerektirir. Bir botun rastgele bir kullanıcıyla sohbet başlatmasını sağlayan hiçbir uç nokta yoktur. Ürününüzün iletişim başlatması gerekiyorsa, bot yanlış bir araçtır ve gerçek bir kullanıcı hesabına ihtiyacınız vardır.
startChat yeni bir sohbet açar ve ilk mesajı tek bir çağrıda gönderir. sendMessage, halihazırda var olan bir sohbet içine gönderi yapar. Telegram, kullanıcı başına yalnızca bir bireysel sohbet olmasına izin verir, bu nedenle halihazırda bir sohbetinizin olduğu biri üzerinde startChat çağrısı yapmak, sadece o mevcut sohbetin içine gönderi yapar.
Bot API ile botu gruba ekleyin ve grup chat_id'sini kullanın. Bağlı bir hesaptan, diğer herhangi bir sohbette olduğu gibi grup sohbet kimliğine gönderin. Unipile ayrıca gruplarda katılımcı listeleme, ekleme ve çıkarma özellikleri sunar, ancak kanalları, toplulukları veya yayınları desteklemez.
Telegram, MarkdownV2 ve HTML'i destekler. MarkdownV2 uzun bir ayrılmış karakter listesinin kaçış karakteriyle kullanılmasını gerektirir; bu nedenle mesaj metni dinamik olarak oluşturulduğunda HTML genellikle daha güvenli bir seçenektir.
Tamamen otomasyon için yepyeni bir hesap kullanmayın, hacmi kademeli olarak artırın ve asla 10 ila 20 saniyede bir mesajdan daha hızlı göndermeyin. Telegram, flood, spam ve sayaç şişirme ile yanıtsız kalan birçok sohbet başlatma durumunda kalıcı olarak yasaklar; bu durum güçlü bir spam sinyalidir.
Hala sorularınız mı var? Ekibimiz yardım etmek için burada.
TR 
EN 
FR 
ES 
DE 
IT 
BR 
NL 
PL