Integratie: technische referentie voor ontwikkelaars

Deze referentie is voor ontwikkelaars die reactive.chat in een website, app of backend inbouwen. Ze beschrijft interfaces en verlopen zoals die in de code zijn geïmplementeerd — met namen, typen, standaardwaarden en foutgevallen.

Hoe u uiterlijk, teksten, startscherm, regels, tours, A/B-tests en de AI-persona instelt, staat onder Aanpassing. Hoe u uw account en het agentenpaneel gebruikt, staat in het Handboek.

In één overzicht

Your visitors' browser                      reactive.chat                         your server
----------------------                      -------------                         -----------
loader.js  --(trigger)-->   core.<hash>.js  cdn.reactive.chat
   window.ReactiveChat (API, events)
   WebSocket rc.v1  <------------------->   ws.reactive.chat/rc_wss/
   HTTP fallback (SSE/Poll) <----------->   ws.reactive.chat/rc_wss/h/
                                            chat server  --- POST (signed) ---->  customer data endpoint
                                                         --- POST (signed) ---->  webhook receiver
                                            reactive.chat/v1  <--- Bearer -----  REST API / MCP
identify(userHash)  <-------------------------------------- HMAC-SHA256 ------  identity secret

Aan de clientkant sluit u een scripttag in en bestuurt u de widget optioneel via window.ReactiveChat. Aan de serverkant ondertekent u de identiteit van aangemelde gebruikers, beantwoordt u zo nodig klantgegevensopvragingen, ontvangt u webhooks en gebruikt u de REST-API.

Hoofdstukken

Basis

• Architectuur en verloop — de onderdelen, hun samenwerking, versies en distributie
• Snel aan de slag — insluiten, domein invoeren, CSP, controleren

In de browser

• Referentie van de scripttag — alle data-rc-*-attributen en configuratiebronnen
• JavaScript-API — alle opdrachten van ReactiveChat(…)
• Gebeurtenissen — on/off en DOM-gebeurtenissen
• Bezoekers identificeren en context doorgeven — identify, userHash, exp, track
• Single-page-apps en paginawisselingen
• Beveiliging en Content Security Policy

Verbinding en distributie

• Eigen domein en first-party proxy — nginx, Apache, Caddy
• Transport: WebSocket, HTTP-fallback, opnieuw verbinden — protocol, fout- en sluitcodes

Op uw server

• Klantgegevensendpoint — bestellingen ophalen en importeren
• Webhooks — gebeurtenissen, handtekening, herhalingen, REST-hooks
• Server-API (REST v1) en MCP
• Integraties en kanalen — WhatsApp, Messenger, Instagram, Telegram, sms, e-mail

Andere plekken om te integreren

• Mobiele apps — de chat in een WebView
• Smart Answer — AI-antwoord in uw websitezoekfunctie

Beheer

• Privacyintegratie — toestemming, opslag, privacytekst
• Limieten en quota
• Problemen oplossen en checklist

Verdere pagina’s over dit onderwerp

• De widget insluiten — de korte versie
• Technische details — metingen van grootte, toegankelijkheid en contrast
• De chat openen vanuit een eigen link of knop
• De promotiekaart in de chat
• Klantgegevens in de chat
• Eigen domein (first-party)
• HTTP-fallback
• De privacytekst automatisch invoegen

Begrippen

• Sitesleutel — de openbare sleutel van een project (24 tekens), opgenomen in het fragment. Geen geheim.
• Project — een website of app met eigen instellingen; meerdere projecten vormen een werkruimte.
• Agentenpaneel — de interface waarin uw team antwoordt.
• Bevestigde gebruiker — een bezoeker van wie uw server de identiteit via userHash heeft ondertekend.
• Loader / core — het kleine laadonderdeel loader.js en het daarna geladen hoofdonderdeel core.<hash>.js.

Alle onderdelen van de documentatie in één overzicht: Documentatie.