empirio.ai kan op vier manieren met andere systemen worden verbonden: * REST API – enquêtes beheren en antwoorden via HTTPS ophalen. * Webhooks – nieuwe antwoorden in realtime naar je eigen systeem laten pushen. * MCP-server – KI‑agenten zoals ChatGPT of Claude direct met je enquêtes en antwoorden laten werken. * CLI – de commandline-tool @empirio-ai/cli voor scripts, automatisering of snelle acties vanuit de terminal. Alle integraties bevinden zich momenteel in de bètafase – endpoints en gedrag kunnen nog veranderen. Meer informatie vind je op https://www.empirio.ai/integrations, inclusief volledige documentatie voor ontwikkelaars.

Voor iedereen die empirio.ai niet alleen via de webinterface wil gebruiken, maar ook in eigen systemen of workflows wil integreren. Typische gebruikssituaties: Ontwikkelaars die enquêtes geautomatiseerd willen aanmaken of antwoorden willen overnemen in eigen tools (CRM, datawarehouse, BI-tools). Bedrijven die enquête-antwoorden direct in interne systemen willen inlezen – bijvoorbeeld na elk antwoord een Slack-bericht sturen of gegevens doorgeven aan de rapportage. Data-analisten die antwoorden regelmatig in SPSS, R of Python verder verwerken en exports willen automatiseren. Teams die met AI-agenten werken en hun agenten directe toegang tot empirio.ai willen geven – via de MCP-server.

De integraties zijn beschikbaar vanaf het Pro-pakket. Voor uitgebreide of organisatiebrede inzet is er daarnaast een Enterprise-pakket met ruimere limieten en voorwaarden. Neem hiervoor contact op met het supportteam via info@empirio.ai

De REST API is de klassieke interface voor de programmatische beheer van enquêtes. Via HTTPS kun je: * enquêtes aanmaken, bewerken, publiceren, dupliceren en verwijderen * antwoorden ophalen, filteren, exporteren en analyseren * totalen, statistieken en kruistabellen berekenen * grafieken in verschillende formaten exporteren (PowerPoint, PDF, Word, PNG) Je authenticeert jezelf met een API-sleutel (voor server-naar-server-toepassingen) of via OAuth 2.1 (voor toepassingen die namens gebruikers handelen). Basis-URL: https://platform.empirio.ai/rest/v1 De volledige endpointdocumentatie vind je in de ontwikkelaarsdocumentatie.

In het empirio.ai-dashboard onder "Integraties". Met één klik genereer je een nieuwe key. Belangrijk: de key wordt maar één keer getoond – sla hem direct veilig op (bijvoorbeeld in een wachtwoordmanager of secret store). API-keys hebben scopes – surveys voor bewerkingen met enquêtes, responses voor toegang tot antwoorden. Bij het aanmaken kun je instellen welke rechten de key moet hebben.

Webhooks zijn het tegenstuk van een API: in plaats van dat jij regelmatig gegevens ophaalt, stuurt empirio.ai de gegevens actief naar je toe zodra er iets gebeurt. Concreet: zodra iemand een enquête afrondt, stuurt empirio.ai een ondertekende JSON-payload naar jouw geconfigureerde URL. Je kunt daar direct op reageren – bijvoorbeeld door automatische follow-upmails te versturen, gegevens in je CRM te schrijven of realtime dashboards te voeden. Per enquête kun je tot drie webhook-endpoints registreren. Webhooks stel je in onder "Integraties".

Bij een fout (timeout, serverfout, ongeldige reactie) probeert empirio.ai de levering tot drie keer opnieuw met oplopende tussenpozen: direct, daarna na 1 minuut en vervolgens na 10 minuten. Belangrijk: webhooks worden geleverd met een at-least-once-garantie. In geval van twijfel wordt een bericht dus liever twee keer afgeleverd dan helemaal niet. Gebruik de header X-Empirio-Delivery-Id om duplicaten aan jouw kant te herkennen en te negeren.

MCP staat voor Model Context Protocol – een standaard waarmee AI-agents direct toegang kunnen krijgen tot externe systemen. Met onze MCP-server kun je ChatGPT, Claude of andere compatibele AI-hosts verbinden met je empirio.ai-data. Concrete voorbeelden van wat je AI-agent dan kan doen: "Laat me de antwoorden zien van mijn laatste klanttevredenheidsenquête." "Maak een NPS-enquête met 5 vragen voor ons nieuwe product en publiceer deze." "Exporteer de antwoorden van enquête X als PowerPoint-deck." "Verwijder de laatste 10 onvolledige antwoorden." De agent roept vervolgens automatisch de juiste tools aan en levert je het resultaat. Server-URL: https://platform.empirio.ai/mcp. Authenticatie verloopt via OAuth 2.1 met PKCE en wordt automatisch afgehandeld – je hoeft niets handmatig te configureren.

Voor Claude: Ga in de instellingen naar „Connectors", voeg empirio.ai toe als Remote-MCP-server met de URL https://platform.empirio.ai/mcp. De authenticatie verloopt automatisch. Voor ChatGPT (via de Responses-API): Gebruik de MCP-serververmelding in je toolconfiguratie met dezelfde URL. Zodra de verbinding tot stand is gebracht, heeft de AI-agent toegang tot alle functies waarvoor jij hem de benodigde rechten geeft (scopes: surveys en/of responses).

De commandline-tool @empirio-ai/cli is een via npm te installeren interface voor ontwikkelaars die liever in de terminal werken of empirio.ai in scripts en CI-pijplijnen willen integreren. Installatie: npm install -g @empirio-ai/cli De CLI dekt alle REST-API-bewerkingen af. Authenticatie verloopt ofwel via empirio login (OAuth, voor interactieve gebruiksscenario’s) of via de omgevingsvariabele EMPIRIO_API_KEY (voor CI- en automatiseringsscenario’s). Vereiste: Node.js versie 20 of hoger.

Om ons platform voor iedereen stabiel te houden, hanteren we duidelijke limieten: * Leesbewerkingen: 60 verzoeken per minuut per key of gebruiker. * Schrijfbewerkingen: 20 verzoeken per minuut per key of gebruiker. * Enquêtes aanmaken: daarnaast maximaal 10 per uur en 50 per dag per account. Als je een limiet overschrijdt, reageert de API met een 429-status en een Retry-After-header die aangeeft hoelang je moet wachten. Voor enterprise-klanten met bijzonder hoge eisen kunnen we individuele limieten afspreken.

Ja. De integraties volgen dezelfde beveiligingsstandaarden als de rest van het platform: Alleen HTTPS: Onversleutelde verbindingen worden geweigerd. Bearer-token-authenticatie: API-sleutels of OAuth-tokens met duidelijk afgebakende scopes. Ondertekende webhooks: Elke webhook-levering is HMAC-ondertekend en controleerbaar op authenticiteit. Rate limits en idempotency-sleutels: Beschermen tegen onbedoelde dubbele uitvoeringen en misbruik. EU-hosting: Ook de integratie-endpoints draaien op onze EU-gebaseerde infrastructuur.

De volledige ontwikkelaarsdocumentatie – met alle endpoints, voorbeelden, webhook-payloads en foutcodes – vind je op empirio.ai/docs. Daar zie je ook welke vraagtypen door de API worden ondersteund, hoe antwoorden zijn opgebouwd en hoe je filters, aggregaties en exports aanroept.

Schrijf ons op info@empirio.ai. Bij vragen over de API of integraties helpen we je graag verder – het is het handigst als je meteen aangeeft: Wat je wilt bereiken Welke endpoints je gebruikt De exacte foutcode en foutmelding (indien beschikbaar) Zo kunnen we je situatie snel begrijpen en oplossen.