Jetzt bauen

Telegram API Nachricht senden: sendMessage in curl, Python und Node

Telegram-API: Nachricht senden

Telegram API Nachricht senden: sendMessage und Verbundene Konten

Eine Code-First-Anleitung zum Senden einer Telegram-Nachricht: Die Bot-API sendMessage Endpunkt in cURL, Python und Node, die strukturelle Grenze, die einen Bot daran hindert, zuerst jemanden anzuschreiben, und wie man von einem echten verbundenen Telegram-Konto mit Unipile sendet Chat starten und sendMessage.


Bauen mit Unipile


Lies die Dokumentation



send_message.sh
# Bot-API: sendMessage curl -X POST "https://api.telegram.org/bot$TOKEN/sendMessage" \ -d chat_id=123456789 \ -d Text="Hallo von der Bot-API" \ -d parse_mode="Markdown"
200 OK: Nachricht gesendet
Entscheidungsleitfaden

Drei Wege, eine Telegram-Nachricht zu senden, und welcher der richtige ist

Es gibt genau drei Möglichkeiten, eine Nachricht über die Telegram-API zu senden. Sie sind nicht austauschbar: Jede sendet die Nachricht als eine andere Art von Absender mit unterschiedlichen Einschränkungen bezüglich der Empfänger.
Bot-API sendMessage
Ein einzelner HTTP-Aufruf, authentifiziert mit einem Bot-Token von BotFather. Der schnellste Weg, Benachrichtigungen, Alarme und Antworten zu senden. Der Haken: Ein Bot kann nur Nutzern Nachrichten senden, die bereits ein Gespräch mit ihm begonnen haben.
Am besten für Bots und Benachrichtigungen
MTProto-Client (Telegram-API)
Vollständiger Protokollzugriff über api_id und API-Hash, wird verwendet, um Ihren eigenen Telegram-Client von Grund auf zu erstellen (Telethon, Pyrogram, TDLib). Die am schwersten zu implementierende und zu wartende Option.
Am besten für die Entwicklung eines benutzerdefinierten Clients
Verknüpftes BenutzerkontoUnipile
Sendet als echtes Telegram-Konto, verknüpft über die Telegram-Gerätefunktion (QR-Code oder Hosted Auth). Keine "Schreib mir zuerst"-Einschränkung, und es funktioniert auch für Gruppen und bestehende Unterhaltungen.
Am besten für Outbound-Messaging in großem Umfang
Einen Bot-Token bekommen oder ein api_id / API-Hash Paar ist ein separates Thema. Eine Schritt-für-Schritt-Anleitung dazu finden Sie in unserem vollständigen Leitfaden zu Telegram-API-Zugang erhalten. Dieser Leitfaden behandelt nur das Senden der Nachricht, sobald Sie über Zugangsdaten verfügen.


Erstellen Sie Ihre Telegram-Integration
Code-Tutorial

Senden Sie eine Nachricht mit dem Endpunkt sendMessage der Bot-API

Die Bot-API stellt einen einzigen HTTP-Endpunkt zum Senden einer Nachricht bereit: POST https://api.telegram.org/bot/sendMessage. Ab Bot-API 10.2 (14. Juli 2026) sind die erforderlichen Parameter unverändert: a chat_id und ein text Körper.
ParameterTypBeschreibung
chat_id ErforderlichGanze Zahl oder ZeichenketteEindeutige Kennung des Zielchats oder @username für einen öffentlichen Kanal.
text ErforderlichZeichenketteNach Entitäten-Parsing 1 bis 4096 Zeichen Nachrichtentext.
Parse-Modus OptionalZeichenketteMarkdownV2, HTML oder älter Markdown, um Fettgedrucktes, Links und Code-Formatierung darzustellen.
Benachrichtigung deaktivieren OptionalBooleschSendet die Nachricht leise und ohne Push-Benachrichtigungston.
Antwortparameter OptionalObjektSendet die Nachricht als Antwort auf eine bestehende Nachricht im Chat.



locken.
curl -X POST "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/sendMessage" \ -H "Content-Type: application/json" \ -d '{ "chat_id": 123456789, ""text": "Ihre Bestellung #4821 wurde versandt.", "parse_mode": "MarkdownV2" }'



nachricht_senden.py
import Anfragen TOKEN = "123456:ABC-your-bot-token" URL = f"https://api.telegram.org/bot{TOKEN}/sendMessage" Nutzlast = { "chat_id": 123456789, "Text": "Ihre Bestellung mit der Nummer #4821 wurde versandt.", "Parse-Modus": "MarkdownV2" } response = Anfragen.Beitrag(url, json=payload) print(Antwort.json())



sendMessage.js
const TOKEN = "123456:ABC-your-bot-token"; const URL = `https://api.telegram.org/bot${TOKEN}/sendMessage`; const response = await fetch(url, { method: "POST", Kopfzeilen: { "Content-Type": "application/json" }, body: JSON.stringify({ chat_id: 123456789, text: "Ihre Bestellung mit der Nummer #4821 wurde versandt.", Parse-Modus: "MarkdownV2" }) }); const Daten = await Antwort.json(); Konsole.log(Daten);
Der Bascule Point

Warum Bots keine Nachrichten zuerst senden können und was das für Sie bedeutet

Jeder sendMessage-Aufruf oben funktioniert, bis man versucht, jemanden zu erreichen, der noch nie mit Ihrem Bot interagiert hat. Genau an diesem Punkt stößt die Bot-API an eine Grenze, die durch keinen Parameter, keinen Wiederholungsversuch und keinen Workaround behoben werden kann.
Ein Bot kann keinem Nutzer schreiben, der ihm nicht zuerst geschrieben hat
Dies ist eine strukturelle Regel der Bot-API, kein Rate-Limit oder Fehler. Bis ein Nutzer sendet /start (oder eine beliebige Nachricht) an deinen Bot, sendMessage dazu chat_id scheitert komplett. Das ist in Ordnung für Support-Bots und freiwillige Benachrichtigungs-Bots, bei denen der Nutzer zuerst den Kontakt aufsucht. Bei Outbound-Anwendungsfällen versagt es völlig: Vertriebsansprachen, Kontowiederherstellungsnachrichten, transaktionale Pings an einen Kontakt, der Ihren Bot noch nie geöffnet hat.
Der MTProto-Client hat diese Einschränkung nicht: Ein vollständiger Telegram-API-Client kann jedem Nutzer Nachrichten senden, genau wie die Telegram-App.
Ein verbundenes Benutzerkonto hat es ebenfalls nicht, da die Nachricht von einem echten Telegram-Konto und keinem Bot gesendet wird. Dies ist der Ansatz, der im nächsten Abschnitt behandelt wird.


Baue den Connected-Account-Flow
Verknüpftes Konto

Versenden Sie von einem echten Telegram-Konto mit Unipile

Unipile verbindet sich mit einem echten Telegram Benutzerkonto, kein Bot. Die Verknüpfung erfolgt über die Telegram-eigene Gerätespielfunktion, entweder durch das Scannen eines QR-Codes oder über Hosted Auth mit Anbieter: "TELEGRAM". Da die Nachricht von einem echten Konto stammt, gibt es keine Bot-spezifische Einschränkung wie "Schreib mir zuerst", die umgangen werden muss. Siehe die Telegramm-API Produktseite für die vollständige Endpunktliste.
1
Starten Sie eine neue Konversation mit startChat
Wenn der Empfänger keinen bestehenden Chat mit dem verknüpften Konto hat, rufen Sie auf POST /chats mit Benutzer-IDs und text. Telegram erlaubt nur eine individuelle Unterversation pro Nutzerpaar; wenn also bereits ein Chat existiert, stellt derselbe Aufruf die Nachricht einfach darin zu, anstatt ein Duplikat zu erstellen.



start_chat.py
import Anfragen URL = "https://api6.unipile.com/v2/${accountId}/chats/send" Kopfzeilen = {"X-API-KEY": api_key} Daten = { "Konto_ID"Konto-ID, "user_ids": [telegram_user_id], "Text": "Hallo, ich komme auf Ihre Anfrage zurück." } response = Anfragen.Beitrag(url, headers=headers, data=data) Chat = Antwort.json() print(chat["chat_id"]) #-Empfänger-ID für 1:1-Chats
2
Mit sendMessage in einen bestehenden Chat senden
Es war einmal chat_id existiert, Anruf POST /chats/{chat_id}/messages mit nur dem text Rumpf. Dies ist der Aufruf, der für jede Folhenachricht in einem laufenden Gespräch zu verwenden ist.



send_message.js
const Chat-ID = "CHAT_ID_VON_STARTCHAT"; const Formular = new FormData(); Formular.anhängen("Text", "Ihr Update steht zur Überprüfung bereit."); const response = await fetch( `https://api6.unipile.com/v2/${accountId}/chats/${chatId}/messages/send`, { method: "POST", Kopfzeilen: { "X-API-KEY": apiKey }, Körper: Form } ); const gesendet = await Antwort.json(); Konsole.log(sent.message_id);
Beide Aufrufe verwenden multipart/form-data, kein JSON. Für 1:1-Chats, die chat_id zurückgegeben von Chat starten ist die eigene ID des Empfängers: Sobald Sie die Telegram-Kennung eines Benutzers kennen, können Sie diese direkt wiederverwenden für sendMessage ohne Nachschlageschritt.


Beginnen Sie mit Unipile zu bauen
Gruppen

Sende eine Nachricht in einer Telegram-Gruppe

Das Senden in eine Gruppe funktioniert genauso wie das Senden in einen bestehenden Chat: POST /chats/{chat_id}/messages mit der Gruppe chat_id und ein text Körper. Was sich ändert, ist das Teilnehmer-Management, das eigene Endpunkte verwendet.
OperationEndpunktNotizen
GET Teilnehmer auflisten/v2/{account_id}/chats/{chat_id}/participantsGibt die aktuelle Mitgliederliste der Gruppe zurück.
POST Teilnehmer hinzufügen/v2/{account_id}/chats/{chat_id}/participantsDie Berechtigung "Andere Mitglieder hinzufügen" muss für die Gruppe aktiviert sein.
DELETE Teilnehmer entfernen/v2/{account_id}/chats/{chat_id}/participantsDas verknüpfte Konto muss Gruppenadministrator sein.
Überprüfen Sie die Berechtigungen, bevor Sie sich auf den Antwortcode verlassen. Wenn die Gruppe die Berechtigung "Andere Mitglieder hinzufügen" nicht erteilt oder das verknüpfte Konto kein Administrator ist, kann die API dennoch eine Erfolgsantwort zurückgeben, ohne tatsächlich jemanden hinzuzufügen oder zu entfernen. Überprüfen Sie nach dem Aufruf immer die Teilnehmerliste und vertrauen Sie nicht allein dem Statuscode.
Was wird für Telegram in Unipile nicht unterstützt?
Kanäle, Communities und Broadcasts
Gruppenadmin-Aktionen: Mitglieder genehmigen oder befördern
Kontakt-, Standort-, Umfrage- und Event-Anhänge
Chat-Archivierung
Sprach- und Videoanrufe
Zustellbarkeit

Bewährte Methoden zur Vermeidung von Telegram-Einschränkungen

Ein verknüpftes Konto verhält sich wie ein echter Telegram-Nutzer, was bedeutet, dass es ebenfalls den dieselbem Anti-Spam-Standards als eine. Die offizielle Empfehlung von Unipile lautet direkt: Zu viele begonnene Konversationen ohne Antwort oder zu viele Spam- und Blockierungssignale können zu einer vorübergehenden Einschränkung des Kontos führen.
Respektieren Sie die Verzögerung
Sende niemals Nachrichten in kürzeren Abständen als 10 bis 20 Sekunden voneinander. Variiere das Intervall, löse nicht nach einer festen Uhrzeit aus.
Neue Konten aufwärmen
Vermeiden Sie es, hohe Volumina über frisch verknüpfte Konten zu versenden. Beginnen Sie niedrig und steigern Sie sich schrittweise, sobald die Antwortraten bestätigen, dass das Konto vertrauenswürdig ist.
Antwortraten beobachten
Ein hoher Anteil von Konversationen ohne Antwort ist eines der stärksten Signale, die Telegram nutzt, um ein Konto zu kennzeichnen.
Bevorzugen Sie die Kontaktaufnahme mit bestehenden Kontakten
Gespräche, die auf einer bestehenden Beziehung oder Empfehlung aufbauen, erzeugen weniger Blockaden als völlig kalte Erstnachrichten.
Dies ist eine kunden-seitige Entscheidung
Unipile leitet die von Ihnen gesendeten Nachrichten weiter, gibt Ihnen aber nicht Ihren Takt vor. Das Versandvolumen, der Zeitpunkt und das Tempo werden von Ihnen festgelegt., basierend auf der Historie des Kontos und der jeweiligen Toleranz von Telegram. Das Einbauen realistischer Verzögerungen vom ersten Tag an ist hier die wirksamste Maßnahme überhaupt.


Entwickeln Sie mit sicheren Versandlimits
Mit Unipile entwickeln

Bereit, Telegram-Nachrichten von echten verknüpften Konten zu senden?

Eine API für startChat und sendMessage über Telegram, WhatsApp, LinkedIn, Instagram, Gmail, Outlook und IMAP sowie Google Kalender und Outlook Kalender. Verknüpfen Sie ein Konto und senden Sie Ihre erste Nachricht in wenigen Minuten.


Erstellen Sie Ihre Telegram-Integration


Lies die API-Dokumentation
 Siehe dir die Telegram-API-Seite an
Neu bei der Telegram-API?
Beginnen Sie mit unserem Zugangsleitfaden
•
Erkunden Sie die Telegram-API-Seite

Telegram API Nachricht senden - FAQ

Häufig gestellte Fragen zum Senden von Telegram-Nachrichten über die Bot-API und mit verknüpften Konten.

Rufe POST https://api.telegram.org/bot/sendMessage mit einem „chat_id“- und einem „text“-Parameter auf. Das Token stammt von BotFather. Die Bot-API ist kostenlos; die aktuelle Version ist 10.2 und wurde am 14. Juli 2026 veröffentlicht..

Telegram erfordert, dass der Nutzer das Gespräch mit dem Bot öffnet, bevor der Bot etwas senden kann. Es gibt keinen Endpunkt, mit dem ein Bot einen Chat mit einem beliebigen Nutzer starten kann. Wenn Ihr Produkt den Kontakt initiieren muss, ist ein Bot das falsche Werkzeug und Sie benötigen ein echtes Nutzerkonto.

startChat öffnet eine neue Unterhaltung und sendet die erste Nachricht in einem Aufruf. sendMessage postet in eine bereits vorhandene Unterhaltung. Telegram erlaubt nur einen individuellen Chat pro Nutzer, sodass der Aufruf von startChat bei jemandem, mit dem Sie bereits einen Chat haben, einfach in diesen bestehenden Chat postet.

Fügen Sie den Bot mit der Bot-API zur Gruppe hinzu und verwenden Sie die chat_id der Gruppe. Senden Sie von einem verbundenen Konto aus an die Gruppen-Chat-ID wie an jeden anderen Chat. Unipile bietet zudem eine Teilnehmerliste sowie das Hinzufügen und Entfernen von Teilnehmern in Gruppen, unterstützt jedoch keine Kanäle, Communities oder Broadcasts.

Telegram unterstützt MarkdownV2 und HTML. MarkdownV2 erfordert das Escapen einer langen Liste reservierter Zeichen, daher ist HTML meistens die sicherere Wahl, wenn der Nachrichtentext dynamisch generiert wird.

Verwenden Sie keinen brandneuen Account ausschließlich für Automatisierung, steigern Sie das Volumen schrittweise und senden Sie niemals schneller als eine Nachricht alle 10 bis 20 Sekunden. Telegram sperrt dauerhaft wegen Floodings, Spammens und des künstlichen Hochsetzens von Zählern, und das Starten vieler Unterhaltungen, die unbeantwortet bleiben, ist ein starkes Spam-Signal.

Haben Sie noch Fragen? Unser Team ist für Sie da.

Sprechen Sie mit einem Experten
de_DEDE
en_USEN fr_FRFR es_ESES it_ITIT pt_BRBR nl_NLNL pl_PLPL tr_TRTR de_DEDE