Documentatie

Apps & integraties

Verbind de tools die je team al gebruikt — Stripe, Shopify, Mailchimp, MailerLite, Jira en Tracio. Geïnstalleerde apps tonen live klantdata als kaarten in het gesprekspaneel van de Inbox, direct naast de chat.

Overzicht#

De app-marktplaats vind je onder Instellingen → Apps. Apps worden één keer geïnstalleerd, voor de hele workspace: een admin verbindt de dienst met de eigen inloggegevens van de workspace, en elk teamlid met inboxtoegang ziet de resulterende kaart in het gesprekspaneel. Agents installeren zelf nooit iets — en AI-agents installeren ook nooit iets.

Installatie op workspace-niveau

Eén set inloggegevens per workspace. Een app installeren, bewerken of verwijderen raakt iedereen tegelijk.

Kaarten in de Inbox

Elke geïnstalleerde app tekent een kaart in het gesprekspaneel met live data over de persoon met wie je praat.

Geen opvulling

Alles in de catalogus kan vandaag worden geïnstalleerd — er is geen "binnenkort beschikbaar"-sectie. Via een aanvraagtegel laat je ons weten welke dienst ontbreekt.

Apps beheren vereist het recht Apps installeren en configureren (standaard inbegrepen in de rollen Owner en Admin, en toewijsbaar aan aangepaste rollen). Teamleden zonder dit recht zien de app-kaarten nog steeds in gesprekken — ze kunnen alleen niets installeren of herconfigureren.

De app-catalogus#

Er zijn vandaag zes apps beschikbaar:

AppCategorieWat agents in het gesprek zien
StripeBetalingenAbonnement en recente betalingen van de persoon met wie je praat
ShopifyCommerceRecente bestellingen met betaal- en fulfilmentstatus
MailchimpMarketingAbonnementsstatus, audience en tags van de persoon met wie je praat
MailerLiteMarketingAbonnementsstatus, groepen en aanmelddatum van de persoon met wie je praat
JiraIssue-trackingIssues gekoppeld aan dit gesprek, en één klik om er nog een aan te maken
TracioBeveiligingMens of bot: het oordeel van Tracio over de chatwidget-bezoeker

Zoek je een gewone link naar je eigen backoffice? Daar is geen account en geen token voor nodig, dus die staat onder Instellingen → Algemeen → Links naar je systemen in plaats van in de app-catalogus.

Een app installeren#

Open Instellingen → Apps, kies een tegel en vul de inloggegevens in waar de app om vraagt. Elk veld linkt naar de exacte pagina in het dashboard van de leverancier waar de waarde wordt aangemaakt of gevonden.

StapBeschrijving
1. Bekijk de previewVoordat je iets plakt, toont de configuratiepagina een voorbeeld van precies de kaart die je agents gaan zien — opgebouwd met verzonnen data, zodat je weet wat je met de workspace deelt voordat er een inloggegeven wordt opgeslagen.
2. Voer inloggegevens inPlak de API-sleutel of het token. Waarden worden automatisch getrimd — een spatie of regeleinde uit copy-paste breekt de installatie niet.
3. Opslaan & testenOpslaan bewaart de configuratie; de verbinding testen doet een echte aanroep naar de leverancier en is wat de statuschip groen maakt.

Elke app-tegel heeft een statuschip die vertelt waar de installatie staat:

StatusBetekenis
Niet getestInloggegevens zijn opgeslagen, maar de app heeft nog geen echt verzoek beantwoord.
VerbondenDe leverancier heeft daadwerkelijk geantwoord — de verbinding is geverifieerd, niet alleen opgeslagen.
Vereist aandachtDe leverancier heeft de opgeslagen inloggegevens afgewezen (ingetrokken of verlopen sleutel). Kaarten stoppen met de leverancier aan te roepen totdat een admin de app opnieuw opslaat of test.
FoutIets anders is misgegaan — zie de tooltip.
UitgeschakeldEen admin heeft de app uitgezet. De kaart verdwijnt uit de Inbox zonder dat de inloggegevens worden verwijderd.

Inloggegevens & beveiliging#

App-inloggegevens horen bij de workspace, en een paar regels houden ze veilig:

  • Versleuteld in rust. Geheime velden (API-sleutels, tokens) worden per sleutel versleuteld opgeslagen en na het opslaan nooit meer teruggetoond.
  • Minimale rechten waar de leverancier dat toelaat. Stripe hoort verbonden te worden met een beperkte sleutel die Customers, Subscriptions, Charges en Invoices kan lezen — plus schrijftoegang voor Refunds alleen als agents vanuit een gesprek moeten kunnen terugbetalen. Plak je toch een sleutel met volledige toegang, dan werkt die wel, maar de instellingenpagina adviseert je hem te vervangen.
  • Een bestemming verplaatsen vraagt opnieuw om het geheim. Het bewerken van een veld waar het inloggegeven aan gebonden is — het Shopify-winkeldomein, de Jira-site-URL — vereist dat je het token opnieuw invoert, zodat een opgeslagen inloggegeven nooit kan worden omgeleid naar een host waar het niet voor bedoeld was.
  • Intrekken raakt de hele workspace. Er is één installatie per app per workspace: roteer of trek je de sleutel in bij de leverancier, dan stopt de kaart van elk teamlid met werken totdat een admin hem bijwerkt in Instellingen → Apps.

App-kaarten in de Inbox#

Eenmaal geïnstalleerd verschijnt elke app als widget in het detailpaneel van een gesprek in de Inbox. Een gesprek openen haalt een live kaart op bij de leverancier: wie deze klant is in Stripe, zijn recente Shopify-bestellingen, zijn nieuwsbriefstatus, de Jira-issues gekoppeld aan de thread, of het oordeel van Tracio over de bezoeker. De meeste kaarten linken ook door naar het bijbehorende record in het dashboard van de leverancier zelf — het oordeel van Tracio leeft volledig in het paneel.

Kaarten zijn eerlijk als er niets te tonen is. Als de klant niet wordt gevonden — of het gesprek geen bruikbare identiteit heeft — zegt de kaart dat en legt uit waarom, in plaats van een leeg vak te renderen. Antwoorden worden kort gecachet en per app op een rate-budget gezet, zodat een open inbox de API-limieten van de leverancier niet opbrandt.

Kaarten volgen geverifieerde identiteit#

Stripe, Shopify, Mailchimp en MailerLite zoeken de klant op via e-mailadres — en alleen via een adres dat daadwerkelijk geverifieerd is: een adres gedekt door de ondertekende identiteit van de widget (identiteitsverificatie), of het Van-adres van een gesprek op het e-mailkanaal. Een adres dat een bezoeker slechts in de chat heeft getypt wordt helemaal niet voor lookups gebruikt — anders zou iedereen het e-mailadres van een echte klant kunnen typen en diens betaalgeschiedenis zien. In dat geval legt de kaart uit dat het adres niet door een geverifieerde identiteit wordt gedekt.

Jira en Tracio draaien niet op e-mail — Jira-kaarten horen bij de gekoppelde issues van het gesprek, en Tracio bij de widgetbezoeker — dus die werken ook als er geen geverifieerd adres bestaat.

Vindt het eigen adres van het gesprek niets, dan probeert Respondo ook het andere bekende adres van het contact (bijvoorbeeld na een contactsamenvoeging), en labelt de kaart met het adres dat is gebruikt.

Wat elke app toont#

Stripe#

Een read-only venster op de facturering van de klant: naam, e-mail, rekeningsaldo en een kopieerbaar klant-ID, plus het abonnement — statusbadge, plan, maandwaarde en startdatum — en recente betalingen met factuurnummers. Terugbetalingen zijn de enige optionele schrijfactie: een admin moet Terugbetalingen vanuit het gesprekspaneel toestaan aanzetten in de instellingen van de app (standaard uit), de operator heeft het recht Terugbetalingen en annuleringen uitvoeren nodig, en elke terugbetaling moet worden bevestigd door REFUND te typen — Stripe kan een terugbetaling niet terugdraaien zodra die is verstuurd.

Shopify#

Read-only recente bestellingen — ordernummer, datum, totaal, betaal- en fulfilmentstatus — met links naar elke bestelling en naar het klantrecord in je Shopify-admin. Verbonden met je winkeldomein en een Admin-API-token van een custom app met de scopes read_customers en read_orders.

Mailchimp#

De abonnee zoals Mailchimp hem ziet: statusbadge, audience, tags, engagement en recente campagneactiviteit (verzendingen, opens, kliks). Eén actie is beschikbaar: Uitschrijven, om een "stop met mailen"-verzoek te honoreren zonder het gesprek te verlaten. Via de API is dit onomkeerbaar — Mailchimp laat iemand alleen zelf weer aanmelden via een aanmeldformulier — dus het vereist een getypte bevestiging. Let op: Mailchimp-API-sleutels zijn niet gescopet: de sleutel die je verbindt kan alles in het account lezen en schrijven.

MailerLite#

Abonnementsstatus, groepen, aanmelddatum, engagement en recente campagneactiviteit. Twee acties: Uitschrijven (omkeerbaar — de API van MailerLite ondersteunt heraanmelden) en Opnieuw inschrijven, om iemand op eigen verzoek weer op de lijst te zetten.

Jira#

Een tweerichtingskoppeling tussen gesprekken en Jira Cloud-issues. De kaart toont de issues die aan dit gesprek zijn gekoppeld met hun huidige status, en biedt Issue aanmaken (aangemaakt in het project van je keuze, automatisch gekoppeld) en Bestaande koppelen / Ontkoppelen voor issues die al bestaan. Statuswijzigingen in Jira stromen terug via een webhook: de instellingenpagina van de app toont een geheim webhookadres om in je Jira-site te plakken, en de kaart spiegelt vanaf dat moment de live status van het issue. Issues worden aangemaakt als het Atlassian-account dat je verbindt, en de kaart ziet precies wat dat account ziet.

Elke actie vanuit het paneel wordt begrensd door rolrechten — App-acties gebruiken voor uitschrijven, opnieuw inschrijven en Jira-issues, en Terugbetalingen en annuleringen uitvoeren voor terugbetalingen. Waar een app daarnaast een workspace-brede capaciteitsschakelaar biedt — vandaag is dat Stripes Terugbetalingen vanuit het gesprekspaneel toestaan — bepaalt die schakelaar of de mogelijkheid überhaupt bestaat, en uitzetten blokkeert iedereen, inclusief de workspace-owner.

Tracio: mens of bot#

Tracio beantwoordt één vraag over een chatwidget-bezoeker: is dit een mens of een bot? De app installeren activeert de detectie-SDK van Tracio in je Respondo-chatwidget — nieuwe widgetgesprekken krijgen automatisch een oordeel, getoond als chip op de Tracio-kaart in het gesprekspaneel.

ChipBetekenis
MensDe serverside-check van Tracio vond geen botsignalen voor deze bezoeker.
Bot · 93%Bot gedetecteerd, met de zekerheid van Tracio. De kaart toont ook de signalen achter het oordeel.
Niet gechecktDe serverside-check van Tracio is nu niet beschikbaar — de kaart valt terug op het door de browser gerapporteerde oordeel en zegt dat erbij.
Vervalst IDHet bezoekers-ID dat de browser stuurde is onbekend bij Tracio — de claim lijkt vervalst.

Er worden twee sleutels verbonden: een publieke sleutel die de SDK in de widget activeert, en een geheime Data-API-sleutel voor de serverside-check van het oordeel. Zonder de serverside-check is de "geen bot"-claim van een browser op zichzelf niet te vertrouwen — en als de claim van de browser afwijkt van het serveroordeel, toont de kaart beide.

Tracio werkt alleen voor chatwidget-gesprekken. E-mail, Telegram en andere kanalen hebben geen bezoeker om te inspecteren, dus hun Tracio-kaart legt uit dat er niets te checken valt. Een ontbrekend oordeel is geen verdenking: adblockers schakelen de SDK voortdurend uit voor echte mensen, en oudere gesprekken die begonnen voordat Tracio was verbonden hebben ook geen oordeel.
De Tracio-SDK fingerprint de bezoekers van je site. Toestemming van bezoekers verkrijgen (via je CMP / cookiebanner) is jouw verantwoordelijkheid als site-eigenaar.

Beperkingen#

  • Stripe- en Shopify-kaarten zijn read-only — de enige schrijfactie in de hele Stripe-app is de optionele, expliciet ingeschakelde terugbetaalactie.
  • Apps op e-mailbasis (Stripe, Shopify, Mailchimp, MailerLite) hebben een geverifieerd e-mailadres nodig. Gesprekken van anonieme widgetbezoekers of kanalen zonder adres tonen een eerlijke "niets om op te zoeken"-kaart.
  • Jira-ondersteuning dekt alleen Jira Cloud.
  • Mailchimp biedt geen heraanmelding: eenmaal uitgeschreven kan alleen de persoon zelf zich weer aanmelden via een aanmeldformulier. Gebruik de heraanmelding van MailerLite als die flow voor jou belangrijk is.
  • Tracio-oordelen bestaan alleen voor widgetgesprekken met de SDK geladen — nooit voor e-mail- of messengerkanalen.