empirio.ai lässt sich auf vier Wegen mit anderen Systemen verbinden: * REST API – Umfragen verwalten und Antworten per HTTPS abrufen. * Webhooks – Neue Antworten in Echtzeit an dein eigenes System pushen lassen. * MCP-Server – KI-Agenten wie ChatGPT oder Claude direkt mit deinen Umfragen und Antworten arbeiten lassen. * CLI – Das Kommandozeilen-Tool @empirio-ai/cli für Skripte, Automatisierungen oder schnelle Aktionen aus dem Terminal. Alle Integrationen sind aktuell in der Beta – Endpunkte und Verhalten können sich noch ändern. Weitere Informationen findest du unter https://www.empirio.ai/integrations inkl. einer vollständigen Entwickler Dokumentation.

Für alle, die empirio.ai nicht nur über die Weboberfläche nutzen, sondern in eigene Systeme oder Workflows einbinden möchten. Typische Anwendungsfälle: Entwickler:innen, die Umfragen automatisiert erstellen oder Antworten in eigene Tools (CRM, Data Warehouse, BI-Tools) übernehmen wollen. Unternehmen, die Umfrage-Antworten direkt in interne Systeme einspielen möchten – etwa nach jeder Antwort eine Slack-Nachricht senden oder Daten ins Reporting übergeben. Datenanalyst:innen, die Antworten regelmäßig in SPSS, R oder Python weiterverarbeiten und Exporte automatisieren wollen. Teams, die mit KI-Agenten arbeiten und ihren Agenten direkten Zugriff auf empirio.ai geben möchten – über den MCP-Server.

Die Integrationen sind ab dem Pro-Paket verfügbar. Für umfangreiche oder unternehmensweite Nutzung gibt es zusätzlich ein Enterprise-Paket mit erweiterten Limits und Konditionen. Hierzu kontaktiere bitte das Support-Team unter info@empirio.ai

Die REST API ist die klassische Schnittstelle für die programmatische Verwaltung von Umfragen. Über HTTPS kannst du: * Umfragen erstellen, bearbeiten, veröffentlichen, duplizieren und löschen * Antworten abrufen, filtern, exportieren und auswerten * Aggregate, Statistiken und Kreuztabellen berechnen * Charts in verschiedenen Formaten exportieren (PowerPoint, PDF, Word, PNG) Du authentifizierst dich entweder mit einem API-Key (für Server-zu-Server-Anwendungen) oder per OAuth 2.1 (für Anwendungen, die im Namen von Nutzer:innen agieren). Basis-URL: https://platform.empirio.ai/rest/v1 Vollständige Endpoint-Doku findest du in der Entwickler-Dokumentation.

Im empirio.ai-Dashboard unter "Integrationen". Mit einem Klick generierst du einen neuen Key. Wichtig: Der Key wird nur einmal angezeigt – speichere ihn direkt sicher ab (zum Beispiel in einem Passwort-Manager oder Secret-Store). API-Keys haben Scopes – surveys für Umfrage-Operationen, responses für den Zugriff auf Antworten. Du kannst beim Erstellen festlegen, welche Berechtigungen der Key haben soll.

Webhooks sind das Gegenstück zur API: Statt dass du Daten regelmäßig abfragst, schickt empirio.ai dir die Daten aktiv zu, sobald etwas passiert. Konkret: Sobald eine Person eine Umfrage abschließt, sendet empirio.ai eine signierte JSON-Payload an deine konfigurierte URL. Du kannst sofort darauf reagieren – zum Beispiel automatische Folgemails verschicken, Daten in dein CRM schreiben oder Echtzeit-Dashboards füttern. Pro Umfrage kannst du bis zu drei Webhook-Endpunkte registrieren. Eingerichtet werden Webhooks unter "Integrationen".

Bei einem Fehler (Timeout, Server-Fehler, ungültige Antwort) versucht empirio.ai die Zustellung bis zu drei Mal mit ansteigenden Abständen: sofort, dann nach 1 Minute, dann nach 10 Minuten. Wichtig: Webhooks werden mit At-least-once-Garantie ausgeliefert. Im Zweifel kommt eine Nachricht also lieber zweimal an als gar nicht. Nutze den Header X-Empirio-Delivery-Id, um Duplikate auf deiner Seite zu erkennen und zu ignorieren.

MCP steht für Model Context Protocol – ein Standard, mit dem KI-Agenten direkt auf externe Systeme zugreifen können. Mit unserem MCP-Server kannst du ChatGPT, Claude oder andere kompatible KI-Hosts mit deinen empirio.ai-Daten verbinden. Konkrete Beispiele, was dein KI-Agent dann kann: „Zeig mir die Antworten meiner letzten Kundenzufriedenheits-Umfrage." „Erstelle eine 5-Fragen-NPS-Umfrage für unser neues Produkt und veröffentliche sie." „Exportiere die Antworten von Umfrage X als PowerPoint-Deck." „Lösche die letzten 10 unvollständigen Antworten." Der Agent ruft dann automatisch die richtigen Tools auf und liefert dir das Ergebnis. Server-URL: https://platform.empirio.ai/mcp. Authentifizierung läuft über OAuth 2.1 mit PKCE und wird automatisch ausgehandelt – du musst nichts manuell konfigurieren.

Für Claude: Geh in den Einstellungen zu „Connectors", füg empirio.ai als Remote-MCP-Server hinzu mit der URL https://platform.empirio.ai/mcp. Die Authentifizierung läuft automatisch. Für ChatGPT (über die Responses-API): Verwende den MCP-Server-Eintrag in deiner Tool-Konfiguration mit derselben URL. Sobald die Verbindung steht, hat der KI-Agent Zugriff auf alle Funktionen, für die du ihm die nötigen Berechtigungen gibst (Scopes: surveys und/oder responses).

Das Kommandozeilen-Tool @empirio-ai/cli ist eine npm-installierbare Schnittstelle für Entwickler:innen, die lieber im Terminal arbeiten oder empirio.ai in Skripte und CI-Pipelines integrieren wollen. Installation: npm install -g @empirio-ai/cli Die CLI deckt alle REST-API-Operationen ab. Authentifizierung läuft entweder über empirio login (OAuth, für interaktive Nutzung) oder per Umgebungsvariable EMPIRIO_API_KEY (für CI- und Automatisierungs-Szenarien). Voraussetzung: Node.js Version 20 oder neuer.

Damit unsere Plattform für alle stabil bleibt, gibt es klare Limits: * Lese-Operationen: 60 Anfragen pro Minute pro Key bzw. Nutzer:in. * Schreib-Operationen: 20 Anfragen pro Minute pro Key bzw. Nutzer:in. *Umfragen erstellen: zusätzlich maximal 10 pro Stunde und 50 pro Tag pro Account. Wenn du ein Limit überschreitest, antwortet die API mit einem 429-Status und einem Retry-After-Header, der dir sagt, wie lange du warten musst. Für Enterprise-Kunden mit besonders hohen Anforderungen können wir individuelle Limits vereinbaren.

Ja. Die Integrationen folgen denselben Sicherheitsstandards wie der Rest der Plattform: Nur HTTPS: Unverschlüsselte Verbindungen werden abgelehnt. Bearer-Token-Authentifizierung: API-Keys oder OAuth-Token mit klar abgegrenzten Scopes. Signierte Webhooks: Jede Webhook-Zustellung ist HMAC-signiert und auf Authentizität prüfbar. Rate Limits und Idempotenz-Schlüssel: Schützen vor versehentlichen Doppelausführungen und missbräuchlicher Nutzung. EU-Hosting: Auch die Integrations-Endpunkte laufen über unsere EU-basierte Infrastruktur.

Die komplette Entwickler-Dokumentation – mit allen Endpunkten, Beispielen, Webhook-Payloads und Fehler-Codes – findest du unter empirio.ai/docs. Dort siehst du auch, welche Fragetypen von der API unterstützt werden, wie Antworten strukturiert sind und wie du Filter, Aggregate und Exporte aufrufst.

Schreib uns an info@empirio.ai. Bei API- oder Integrations-Fragen helfen wir gerne weiter – am besten direkt mit: Was du erreichen möchtest Welche Endpunkte du nutzt Den genauen Fehler-Code und die Fehler-Meldung (falls vorhanden) So können wir den Fall schnell nachvollziehen.