API Tutorial
So sendest du Telegram-Nachrichten per API
Um Telegram-Nachrichten per API zu senden, verbinde Telegram über Modiva und rufe dann `messages_send` mit Empfänger und Text auf — lies die Konversation mit `messages_list`, um Postfächer und KI-Auto-Antworten anzutreiben.
Programmatisches Messaging auf Telegram bedeutet normalerweise, sich durch plattformspezifische Messaging-APIs und Freigaben zu arbeiten. Modiva abstrahiert das in `messages_send`, `messages_list` und `messages_inbox`, sodass ein einheitliches Postfach oder ein KI-Responder auf Telegram genauso funktioniert wie überall sonst.
Schritt für Schritt
Modiva-Konto und MCP-Schlüssel erstellen
Registriere dich kostenlos und generiere im Dashboard einen MCP-Schlüssel (`mk_live_…`). Derselbe Schlüssel authentifiziert sowohl den gehosteten MCP-Server (für KI-Agenten) als auch die REST-API (für dein Backend), sodass du nur eine Zugangsberechtigung verwaltest.
Dein Telegram-Konto verbinden
Klicke im Dashboard auf Verbinden und wähle Telegram. Modiva führt den OAuth-Flow aus und fordert die passenden Scopes für dich an, speichert die Access- + Refresh-Tokens dann in einem verschlüsselten Tresor und hält sie aktuell — du hantierst nie mit den rohen API-Zugangsdaten von Telegram. Die Verbindung erhält eine stabile `connectionId`, auf die du in jedem Aufruf verweist.
Eine Nachricht mit messages_send senden
Rufe `messages_send` mit der Connection-ID, einer `recipient_id` und deinem Text auf. Modiva stellt sie über Telegram zu und gibt die Nachrichten-ID zurück, unter Beachtung der Messaging-Fenster und -Regeln von Telegram.
Ein Postfach oder einen KI-Responder bauen
Nutze `messages_inbox` und `messages_list`, um Konversationen in eine Ansicht zu holen. Über MCP kann ein Agent eine eingehende Telegram-Nachricht lesen, über eine Antwort entscheiden und mit `messages_send` antworten — ein vollständiger KI-Support-Loop.
Beispielanfrage
Rufe das Tool messages_send über die REST-API von Modiva auf. Dasselbe Tool steht KI-Agenten über den MCP-Server unter https://mcp.modiva.ai/v1 zur Verfügung.
curl -X POST https://api.modiva.ai/v1/tools/invoke \
-H "Authorization: Bearer mk_live_…" \
-H "Content-Type: application/json" \
-d '{
"tool": "messages_send",
"connectionId": "conn_…",
"args": { "recipient_id": "u_456", "text": "Hi! How can we help today?" }
}'Mit Telegram ausprobieren
Kostenlos startenFAQ
Kann ich ein einheitliches Postfach bauen, das Telegram einschließt?
Ja. `messages_inbox` gibt Konversationen von Telegram in derselben Form zurück wie jeder andere Kanal, sodass eine Postfach-Oberfläche sie alle abdeckt.
Beachtet Modiva die Messaging-Regeln von Telegram?
Ja — Modiva erzwingt die Messaging-Fenster und Richtlinienvorgaben von Telegram, damit deine Sendungen konform bleiben.