Zum Hauptinhalt springen
Connic

Telegram

Von Connic

Connic übernimmt die Telegram Bot API. Nachrichten lösen einen Agenten aus, der im Thread antwortet; Outbound Runs senden Reports und Benachrichtigungen an jeden Chat oder Channel. Kein eigenes Bot Framework.

InboundOutbound
Leg losDokumentation

Überblick

Der Bot wird einmal mit @BotFather erstellt; Connic übernimmt den Rest. Bei einer eingehenden Telegram-Verbindung mit Bot Token registriert Connic einen Webhook bei Telegram. Nachrichten, bearbeitete Nachrichten und Callback Queries treffen als HTTP POST ein, werden geprüft und lösen die verknüpften Agenten mit einer strukturierten Payload aus: Text, chat_id, Absenderdetails und das unveränderte Update. Eine ausgehende Verbindung schließt den Kreislauf und sendet den Agenten-Output über sendMessage in einen beliebigen Chat zurück.

Damit entfällt der sonst nötige Bot-Prozess: kein Long-Polling Service, kein Bot Framework zum Hosten und keine Webhook-Infrastruktur. Die Logik des Bots übernimmt ein Connic-Agent. Seine Gespräche erscheinen als überprüfbare Runs, und sein Verhalten ändert sich mit einem neuen Agenten-Deployment statt mit einem Bot Deployment.

So funktioniert es

1

Bot mit @BotFather erstellen

Schreibe @BotFather auf Telegram an, sende /newbot und folge den Anweisungen. Kopiere anschließend den Bot-Token.

2

Verbindung erstellen

Füge den Bot-Token in eine neue Telegram-Verbindung ein. Im Inbound-Modus validiert Connic das Token und registriert automatisch den Webhook bei Telegram. Optional beschränkt eine Liste erlaubter Telegram-Nutzer-IDs den Zugriff.

3

Agent verknüpfen

Jede Nachricht an den Bot löst nun den verknüpften Agenten mit der Message Payload als Input aus. Füge für Antworten im Chat eine ausgehende Verbindung hinzu; der Agent gibt chat_id und Antworttext zurück.

Muster für den Produktivbetrieb

Muster für den Produktivbetrieb, bei denen Connic Queues, Worker und Scheduler betreibt.

Trigger

Nutzer sendet Nachricht

message
Agent-Aktion

Der Agent liest die Frage, durchsucht verbundene Help Docs und antwortet innerhalb von Sekunden im selben Chat. Thread, Ton und Typing Indicator bleiben erhalten.

Lies die Dokumentation zu Telegram

Authentifizierung und Zugriffskontrolle

Die Verbindung verwendet Telegrams integrierten secret_token Mechanismus: Ein bei der Erstellung generiertes zufälliges Token wird über setWebhook bei Telegram registriert. Jede eingehende Anfrage muss es im X-Telegram-Bot-Api-Secret-Token Header enthalten. Anfragen unterliegen Rate Limits, das Bot Token wird verschlüsselt gespeichert und eine optionale Allowlist mit Telegram-Nutzer-IDs hält den Bot privat, auch wenn ihn jeder finden kann. Beim Löschen der Verbindung wird der Webhook deregistriert.

Jede Nachricht wird zu einem normalen Agent Run mit vollständigen Traces, Token- und Kosten-Tracking sowie denselben Guardrails und Approval-Regeln wie jeder andere Trigger. Eine Chat-Oberfläche bedeutet damit keinen Verlust an Kontrolle.

Antworten und Nachrichtenformate

Inbound erhält der Agent die wichtigsten Felder auf oberster Ebene: text, chat_id und ein message Objekt mit Absenderdetails sowie das unveränderte Telegram-Update. Outbound gibt der Agent JSON mit einem text Feld und optional einer chat_id zurück; auch ein einfacher String funktioniert und geht an die Default Chat ID der Verbindung. Die chat_id im Agenten-Output hat Vorrang und sorgt dafür, dass eine Antwort den ursprünglichen Nutzer erreicht. Nachrichten werden mit parse_mode: HTML gesendet, sodass der Agent Antworten formatieren kann. Telegram-Dokumentation: Payload- und Output-Formate.

Informationen

Publisher
Von Connic
Verbindungen
Verbindungen
Modi
Inbound, Outbound
Dokumentation
Telegram Docs

Häufig gestellte Fragen

Mit @BotFather wird ein Bot erstellt und dessen Token in einer neuen Telegram-Verbindung hinterlegt. Anschließend wird ein Agent verknüpft. Connic registriert den Webhook automatisch bei Telegram, sodass jede Nachricht an den Bot einen Agent Run auslöst. Ein Bot Server oder eine Polling-Schleife ist nicht erforderlich. Telegram ist eine von mehreren Chat- und Event-Quellen; Überblick über weitere Verbindungen.

Ja. Die Inbound Payload enthält die chat_id des Absenders. Derselbe Agent wird mit einer ausgehenden Telegram-Verbindung verknüpft und gibt JSON mit dieser chat_id und einem text Feld zurück; die Verbindung sendet die Antwort per sendMessage in denselben Chat. Für feste Ziele wie einen Alerts Channel wird stattdessen eine Default Chat ID gesetzt.

Ja. Eine Liste erlaubter Telegram-Nutzer-IDs in der Verbindung sorgt dafür, dass alle anderen Nachrichten ignoriert werden. Ohne Liste akzeptiert der Bot Nachrichten von jedem, der ihn erreichen kann. Nach einer Nachricht an den Bot steht die Nutzer-ID unter message.from_id in der Run Payload.
Plane einen Agenten-Workflow mit Telegram und Connic

Beschreibe die Event-Quelle, die Struktur der Payload, das Ziel für die Ergebnisse und die Anforderungen an private Netzwerke oder Freigaben. Wir helfen, Telegram mit dem passenden Verbindungsmodus, Deployment und Monitoring in Connic einzurichten.

Sprich mit Sales

Weitere Verbindungen

Entdecke den Marketplace

Stripe

Agenten bei Zahlungs-Events ausführen

E-Mail (SMTP/IMAP)

Postfächer lesen und Antworten senden

HTTP-Webhooks

Agenten bei jeder HTTP-Anfrage ausführen

MCP Server

Agenten als MCP Tools bereitstellen

Cron-Scheduler

Agenten nach einem Cron-Ausdruck ausführen

Apache Kafka

Topics konsumieren und Ergebnisse veröffentlichen