Integraties, migratie en API-sleutels

Onder Integraties (/app/integrations) koppelt u reactive.chat aan tools die uw team al gebruikt. Integraties gelden voor de hele werkruimte. Eigenaren en beheerders mogen ze instellen; een beheerder die tot afzonderlijke projecten is beperkt, mag dat niet.

Deze pagina beschrijft wat de integraties voor u doen en hoe u ze gebruikt. De technische details, bijvoorbeeld over het ondertekenen van webhooks, staan in het onderdeel Technische integratie.

Eerlijk over de huidige stand

Er zijn koppelingen met meer dan 30 diensten beschikbaar. De meeste zijn getest met gesimuleerde tegenpartijen, maar hebben nog niet met de echte dienst gewerkt. Op de integratiepagina staat daarbij “Niet geverifieerd tegen de live dienst”; sommige zijn gemarkeerd als “In ontwikkeling”. Webhooks en Slack hebben deze melding niet. Stel een niet-geverifieerde integratie in, test deze met echte gegevens en laat het ons via Feedback sturen weten als iets niet klopt.

Een integratie instellen

1. Open Integraties. Bovenaan ziet u hoeveel koppelingen verbonden zijn, hoeveel een fout hebben of gepauzeerd zijn en of afleveringen zijn mislukt.
2. Doorzoek de catalogus (Integraties zoeken, filter “Alle” of “Niet verbonden”) en klik op Instellen.
3. Voer de toegangsgegevens in die de dienst vraagt, meestal een API-sleutel of token uit uw account bij die dienst.
4. Verbinden en activeren controleert de verbinding direct en schakelt de integratie in. Met Opslaan zonder activeren bewaart u dit voor later.

Later kunt u een integratie Bewerken, Pauzeren, Opnieuw activeren of Verwijderen. Verwijderen wist de opgeslagen toegangsgegevens en kan niet ongedaan worden gemaakt. Toegangsgegevens worden versleuteld opgeslagen.

Alleen voor Google Drive bestaat een knop om bij de dienst aan te melden. Bij alle andere voert u zelf de toegangsgegevens in; voor Slack bijvoorbeeld de gegevens van een eigen Slack-app.

Wanneer een dienst niet antwoordt

Elke integratie werkt via een wachtrij. Als een dienst niet antwoordt, wordt de aflevering meermaals met steeds langere tussenpozen opnieuw geprobeerd; na herhaalde fouten wordt de integratie een tijd opgeschort (“Tijdelijk opgeschort: de dienst heeft herhaaldelijk niet geantwoord …”). Een gebeurtenis die na ongeveer een uur nog niet is afgeleverd, wordt verworpen. De recentste mislukte afleveringen ziet u in het gedeelte Mislukte afleveringen, zonder hun inhoud.

Een chatbericht wacht nooit op een integratie. Als een dienst vastloopt, blijft de chat ongestoord werken.

Wat beschikbaar is

Notificaties aan uw team

• Slack — elk nieuw gesprek verschijnt als thread in een kanaal. U antwoordt in de thread en de bezoeker ziet het antwoord in de chat. /rc toont de status. U koppelt Slack-gebruikers aan medewerkers.
• Microsoft Teams, Discord — notificaties via een webhookadres.
• Telegram — notificaties naar een chat via een bottoken en chat-ID.
• E-mail — notificaties naar een teammailbox.

Automatisering

• Webhooks — reactive.chat stuurt ondertekende gebeurtenissen naar een adres met https:// naar keuze: nieuw gesprek, elk bericht, overdracht aan een persoon aangevraagd, beoordeling gegeven, nieuwe foutzaak. Ook Zapier, Make en n8n worden op deze manier gekoppeld. U kunt het Ondertekeningsgeheim tonen, kopiëren en opnieuw genereren; een nieuw geheim geldt meteen en het oude is niet meer geldig.
• Zapier — via de REST-hooks van de interface. Voor Make en n8n bestaat nog geen kant-en-klare app; gebruik daar webhooks.

Context in het agentenpaneel

Deze integraties tonen kaarten over de bezoeker in de contextkolom van het agentenpaneel, bijvoorbeeld bestellingen of het CRM-contact, sommige met acties:

• CRM — HubSpot, Pipedrive
• Webshop — Shopify, Shopware 6, WooCommerce
• Betalingen — Stripe (met een beperkte leessleutel)
• Website — WordPress
• Analyse — Matomo, Plausible, Google Analytics 4
• Fouten — Sentry

De kaart markeert gegevens die op een niet-ondertekende verklaring van de bezoeker berusten. Acties voert u uit met Uitvoeren en een bevestiging.

Tickets, afspraken, telefoon

• Zendesk, Freshdesk, Jira, Linear, GitHub — tickets of issues aanmaken vanuit een gesprek of foutzaak.
• Cal.com — beschikbare afspraken tonen en boeken, ook via de AI-assistent.
• Twilio — sms vanuit het agentenpaneel en de verzendroute voor het sms-kanaal.

Kennisbronnen

• Notion, Confluence — inhoud opnemen in de kennisbank.
• Google Drive — onder de kennisbank, “Bestanden & Google Drive” (zie Kennisbank en helpcentrum).
• KB-Crawler — instellingen voor het crawlen van uw website.

Kanalen

• WhatsApp Business, Facebook Messenger, Instagram Direct — zie Kanalen.

Overstappen van een andere aanbieder

Onder Migratie (/app/migration) neemt u gegevens over uit een andere chattool:

• Intercom en Crisp — via hun interface of een exportbestand; voor Crisp ook hulpartikelen als Markdown,
• Tidio — via een exportbestand,
• Zendesk — via de volledige JSON-export en de export van het helpcentrum.

Zo gaat u te werk:

1. Een nieuwe migratie starten en het doel kiezen (Naar welk project?).
2. Verbinden en bekijken wat er is — u ziet wat er bestaat, plus een steekproef.
3. Wat moet worden meegenomen? — contacten, gesprekken, artikelen.
4. Migratie starten. U kunt Stoppen of Taak verwerpen.

Wat u moet weten:

• Geïmporteerde gesprekken komen gesloten in het agentenpaneel terecht.
• Geïmporteerde contacten gelden als niet-geverifieerd.
• Gevoelige gegevens in de teksten worden gemaskeerd.
• Bijlagen worden als link overgenomen, niet als bestand.
• Een tweede uitvoering maakt geen dubbele gegevens aan.
• Uw toegangsgegevens voor de oude aanbieder worden na de uitvoering verwijderd.
• De interfaces van de aanbieders zijn getest zonder echte accounts bij die diensten; de bestandsimports zijn van begin tot eind getest met voorbeeldbestanden.

Met Het insluitfragment vervangen zet het account een bestaand Intercom- of Crisp-fragment om in een reactive.chat-fragment. De JavaScript-opdrachten boot, open, identify en track behouden dezelfde namen als in Intercom.

API-sleutels

Onder API-sleutels (/app/api-keys, eigenaren en beheerders) maakt u sleutels voor de REST-interface aan. Een sleutel wordt precies één keer getoond; daarna bewaart reactive.chat alleen een vingerafdruk ervan. Kopieer de sleutel dus meteen naar een veilige plek.

Bij het aanmaken kiest u wat de sleutel mag doen:

• alleen lezen
• lezen en schrijven
• alleen import van klantgegevens — voor de import beschreven in Klantgegevens in de chat
• lezen + bezoekersgegevens of lezen, schrijven + bezoekersgegevens — alleen daarmee krijgt de sleutel toegang tot naam, e-mail en telefoonnummer van bezoekers

De lijst toont naam, prefix, wanneer en door wie de sleutel is aangemaakt en wanneer deze voor het laatst is gebruikt. Intrekken werkt meteen en kan niet ongedaan worden gemaakt.

Met een sleutel kunt u reactive.chat ook koppelen aan AI-tools die het Model Context Protocol (MCP) ondersteunen; de pagina toont voorbeelden. Hoe de interface werkt, staat in het onderdeel Technische integratie.