API Tutorial
So sendest du Instagram-Nachrichten per API
Um Instagram-Nachrichten per API zu senden, verbinde Instagram ü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 Instagram 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 Instagram 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 Instagram-Konto verbinden
Klicke im Dashboard auf Verbinden und wähle Instagram. 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 Instagram. 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 Instagram zu und gibt die Nachrichten-ID zurück, unter Beachtung der Messaging-Fenster und -Regeln von Instagram.
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 Instagram-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 Instagram ausprobieren
Kostenlos startenFAQ
Kann ich ein einheitliches Postfach bauen, das Instagram einschließt?
Ja. `messages_inbox` gibt Konversationen von Instagram in derselben Form zurück wie jeder andere Kanal, sodass eine Postfach-Oberfläche sie alle abdeckt.
Beachtet Modiva die Messaging-Regeln von Instagram?
Ja — Modiva erzwingt die Messaging-Fenster und Richtlinienvorgaben von Instagram, damit deine Sendungen konform bleiben.