Question 1

Welke integratiemogelijkheden biedt empirio.ai?

Accepted Answer

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.

Question 2

Voor wie zijn de integraties bedoeld?

Accepted Answer

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.

Question 3

Welk pakket heb ik nodig voor de integraties?

Accepted Answer

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

Question 4

Wat is de REST-API en waarvoor heb ik die nodig?

Accepted Answer

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.

Question 5

Waar maak ik een API-sleutel aan?

Accepted Answer

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.

Question 6

Wat zijn webhooks en hoe gebruik ik ze?

Accepted Answer

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

Question 7

Wat gebeurt er als mijn webhook-endpoint tijdelijk niet bereikbaar is?

Accepted Answer

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.

Question 8

Wat is de MCP-server?

Accepted Answer

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.

Question 9

Hoe verbind ik Claude of ChatGPT met empirio.ai?

Accepted Answer

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

Question 10

Wat is de CLI en wanneer is het zinvol om die te gebruiken?

Accepted Answer

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.

Question 11

Welke limieten gelden er voor het aantal verzoeken bij de integraties?

Accepted Answer

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.

Question 12

Worden mijn gegevens veilig verzonden wanneer ik de integraties gebruik?

Accepted Answer

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.

Question 13

Waar vind ik de volledige technische documentatie?

Accepted Answer

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.

Question 14

Tot wie kan ik mij wenden met technische vragen over de integratie?

Accepted Answer

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.

Helpcentrum

Integraties

Helpcentrum

Integraties