Instagram Kommentar-zu-DM per API automatisieren
CommentKeyword macht aus Instagram-Kommentaren automatisierte DM-Gespräche. Die REST-API legt Keyword-Trigger an, setzt Antworttexte und verbindet KI-Agenten programmatisch – deine Tools, Workflows und KI-Agenten steuern alles ohne Dashboard.
// 1. Find your live AI agent
const agentsResponse = await ck.get("/api/agents");
const agent = agentsResponse.data.find((item) => item.status === "live");
if (!agent) throw new Error("No live agent found");
// 2. Create the keyword trigger
const keywordResponse = await ck.post("/api/keywords", {
keyword: "GUIDE",
matchMode: "contains",
scope: "global",
commentReplies: ["Sent it to you, {{namefirst}}!"],
dmMessages: ["Hey {{namefirst}}, here's your free guide."],
delaySec: 20,
aiAgentId: agent.id
});
// 3. Go live.
console.log("Live:", keywordResponse.data.id);Alles, was du per API steuern kannst
Ein PAT-Token gibt deinem Code die volle Kontrolle über Keyword-Trigger, Antworttexte und KI-Agenten-Verbindungen.
Keywords erstellen und verwalten
Lege einen neuen Keyword-Trigger mit einem POST an: Match-Modus (exakt oder enthält), Reichweite (global oder postbezogen) und Nachrichten-Varianten – ganz ohne Dashboard.
POST /api/keywords
{
"keyword": "GUIDE",
"matchMode": "contains",
"scope": "global"
}Kommentarantworten und DMs setzen
Übergib commentReplies und dmMessages im selben Create- oder Update-Call. Platzhalter wie {{handle}}, {{name}} und {{namefirst}} personalisieren den Text beim Versand.
{
"commentReplies": ["Sent it to you, {{namefirst}}!"],
"dmMessages": ["Hey {{namefirst}}, here's the guide."],
"delaySec": 20
}KI-Agenten per ID anhängen
Existiert bereits ein Live-KI-Agent im Workspace, verknüpfst du ihn per öffentlicher ID mit jedem Keyword. Der Agent übernimmt die DM-Gespräche automatisch, nachdem die Hook-Frage gefeuert hat.
PATCH /api/keywords/{id}
{
"aiAgentId": "a6be1900-8f4f-4ae6-8f4e-48f8b28f0f17"
}Lass deinen KI-Agenten sein eigenes Setup erledigen
Baust du ein KI-System – einen Custom GPT, einen n8n-Agenten, einen Claude-Workflow oder dein eigenes Backend – gib ihm ein CommentKeyword-API-Token und lass es das komplette Instagram-Automatisierungs-Setup managen.
Der Agent liest deine bestehenden Live-Agenten, erstellt den Keyword-Trigger mit passendem Antworttext, hängt den richtigen KI-Agenten an und aktiviert alles – ohne manuelle Dashboard-Interaktion.
- Kein Dashboard-Login nötig, sobald das Token konfiguriert ist
- KI-Agenten-IDs sind über GET /api/agents abrufbar
- Keywords entstehen in einem einzigen POST-Request
- Partielle PATCH-Updates tauschen Texte oder Agenten ohne Neuanlage
- Kampagnen-Ende: Keywords per PATCH deaktivieren
Beispiel: agentengesteuerter Kampagnenstart
1. Kampagnen-Trigger feuert
Ein neuer Produkt-Post geht live. Dein n8n-Workflow oder KI-Agent erhält das Ereignis.
2. Agent ruft verfügbare KI-Agenten ab
Ruft GET /api/agents auf, um den passenden Live-Agenten für diesen Kampagnentyp zu finden.
3. Agent erstellt das Keyword
Postet Keyword, Kommentarantwort, DM-Text und aiAgentId in einem Call. Setzt delaySec auf 20.
4. In Sekunden live
CommentKeyword überwacht sofort Kommentare auf dieses Keyword. Kein Mensch in der Schleife.
Wer die API nutzt
Jeder Workflow, der Instagram Keyword-Automatisierung ohne manuelle Dashboard-Arbeit anlegen oder aktualisieren muss.
KI-Agenten, die sich selbst konfigurieren
Gib deinem KI-System ein PAT – es erstellt das Keyword, schreibt die Antwort und verdrahtet sich selbst als Gesprächsagenten, ganz ohne Dashboard.
n8n-, Make- und Zapier-Flows
Löse Keyword-Anlagen oder Updates aus Automatisierungsplattformen aus: Kampagnenstart, Produktlaunch oder Livegang eines Lead Magnets.
Eigene Dashboards und Agentur-Tools
Baue dein eigenes Management-Interface auf der API. Verwalte Keywords mehrerer Kunden, ohne dich in jeden Workspace einzeln einzuloggen.
Kampagnen-Skripting
Skripte ein komplettes Instagram-Kampagnen-Setup: Keyword anlegen, DM-Text setzen, planmäßig updaten oder deaktivieren – alles aus einem Skript.
MCP-Server — kommt als Nächstes
Ein Model-Context-Protocol-Server würde CommentKeyword-Aktionen als native Tools für Claude, GPT und alle MCP-kompatiblen KI-Systeme bereitstellen. Statt HTTP-Calls zu schreiben, ruft dein Agent Tools wie create_keyword oder attach_agent direkt auf.
Baust du einen KI-Workflow, der von einer MCP-Integration profitieren würde? Melde dich – das hilft uns bei der Priorisierung.
// Zukünftige MCP-Nutzung
await agent.use("commentkeyword");
await create_keyword({
keyword: "LAUNCH",
aiAgentId: agentId,
});
In Minuten loslegen
Registrieren, PAT-Token aus den Workspace-Einstellungen generieren und Requests senden.
1. PAT-Token generieren
Erstelle in deinen Workspace-Einstellungen ein Personal Access Token und wähle die Berechtigungen deiner Integration: keywords:read, keywords:write oder agents:read.
2. Ersten Request senden
curl -H "Authorization: Bearer TOKEN" \
https://commentkeyword.com/api/keywords3. Workflow bauen
Lege Keywords an, hänge Agenten an, setze Antworttexte und manage Kampagnen aus deinem Code, deiner Automatisierungsplattform oder deinem KI-System. Die vollständige Referenz findest du unter /api-docs oder als maschinenlesbare OpenAPI-Spezifikation.
Häufige Fragen
Was kann ich mit der CommentKeyword-API tun?
Du kannst Keyword-Trigger listen, anlegen, lesen, aktualisieren und löschen. Jedes Keyword umfasst Kommentarantworten, DM-Nachrichten, Match-Einstellungen und optional einen angehängten KI-Agenten. Zusätzlich gibt es einen Lese-Endpunkt für deine KI-Agenten, um IDs programmatisch nachzuschlagen.
Wie authentifiziere ich mich?
Mit einem Personal Access Token (PAT) aus deinen Workspace-Einstellungen. Du übergibst ihn im Authorization-Header als Bearer-Token. Tokens sind workspace-spezifisch und laufen nicht automatisch ab.
Kann ich per API einen KI-Agenten an ein Keyword hängen?
Ja. Übergib das Feld aiAgentId im POST oder PATCH. Der Wert muss die öffentliche ID eines Live-Agenten im selben Workspace sein. Alle Agenten-IDs bekommst du über GET /api/agents.
Gibt es schon einen MCP-Server?
Noch nicht, aber er steht auf der Roadmap. Ein MCP-Server ließe KI-Agenten direkt über das Model Context Protocol mit CommentKeyword sprechen – ohne rohe HTTP-Calls. Baust du gerade ein KI-System und das zählt für dich? Melde dich – das hilft bei der Priorisierung.
Brauche ich einen bezahlten Plan für die API?
Nein, die API gibt es in allen Plänen inklusive Gratis-Stufe. Free-Konten enthalten 300 automatisierte DMs pro Monat. Bezahlte Pläne schalten höhere Volumina, KI-Agenten und weitere Funktionen frei – ebenfalls per API steuerbar.
Gibt es ein Rate-Limit?
Die CommentKeyword-API ist pro Workspace-Token ratenlimitiert. Die Instagram-Zustellung wird je verbundenem professionellem Konto separat eingereiht und folgt Metas endpunktspezifischen Limits. Drosselt Meta einen Request, werden berechtigte Nachrichten und Antworten verzögert und automatisch wiederholt.
Einmal bauen. Den Rest übernimmt die API.
CommentKeyword gibt deinem Code – und deinen KI-Agenten – volle Kontrolle über Keyword-Trigger, Antworttexte und KI-Gesprächsrouting. Starte kostenlos und ergänze das API-Token aus deinen Workspace-Einstellungen.