Question 1

Welche Integrationsmöglichkeiten bietet empirio.ai?

Accepted Answer

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.

Question 2

Für wen sind die Integrationen gedacht?

Accepted Answer

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.

Question 3

Welches Paket brauche ich für die Integrationen?

Accepted Answer

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

Question 4

Was ist die REST API und wofür brauche ich sie?

Accepted Answer

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.

Question 5

Wo erstelle ich einen API-Key?

Accepted Answer

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.

Question 6

Was sind Webhooks und wie nutze ich sie?

Accepted Answer

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".

Question 7

Was passiert, wenn mein Webhook-Endpunkt mal nicht erreichbar ist?

Accepted Answer

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.

Question 8

Was ist der MCP-Server?

Accepted Answer

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.

Question 9

Wie verbinde ich Claude oder ChatGPT mit empirio.ai?

Accepted Answer

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).

Question 10

Was ist die CLI und wann ist sie sinnvoll?

Accepted Answer

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.

Question 11

Welche Rate Limits gelten für die Integrationen?

Accepted Answer

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.

Question 12

Werden meine Daten bei der Nutzung der Integrationen sicher übertragen?

Accepted Answer

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.

Question 13

Wo finde ich die vollständige technische Dokumentation?

Accepted Answer

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.

Question 14

An wen wende ich mich bei technischen Fragen zur Integration?

Accepted Answer

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.

Hilfe-Center