Integration: teknisk referens för utvecklare

Den här referensen är till för utvecklare som bygger in reactive.chat i en webbplats, en app eller en backend. Den beskriver gränssnitt och flöden så som de är implementerade i koden – med namn, typer, standardvärden och felfall.

Hur du ställer in utseende, texter, startskärm, regler, rundturer, A/B-tester och AI-persona beskrivs under Anpassning. Hur du använder kontot och agentpanelen beskrivs i Handboken.

Överblick

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

På klientsidan bäddar du in en skripttagg och styr vid behov widgeten via window.ReactiveChat. På serversidan signerar du inloggade användares identitet, besvarar vid behov anrop om kunddata, tar emot webhooks och använder REST-API:et.

Kapitel

Grunder

• Arkitektur och flöde – delarna, hur de samverkar, versioner och distribution
• Snabbstart – bädda in, ange domänen, CSP, kontrollera

I webbläsaren

• Referens för skripttaggen – alla data-rc-*-attribut och konfigurationskällor
• JavaScript-API – alla kommandon i ReactiveChat(…)
• Händelser – on/off och DOM-händelser
• Identifiera besökare och skicka kontext – identify, userHash, exp, track
• Ensidesappar och sidbyten
• Säkerhet och Content Security Policy

Anslutning och distribution

• Egen domän och förstapartsproxy – nginx, Apache, Caddy
• Transport: WebSocket, HTTP-reserv, återanslutning – protokoll, fel- och stängningskoder

På din server

• Slutpunkt för kunddata – hämta och importera beställningar
• Webhooks – händelser, signatur, nya försök, REST-hooks
• Server-API (REST v1) och MCP
• Integrationer och kanaler – WhatsApp, Messenger, Instagram, Telegram, SMS, e-post

Andra ställen att bygga in det på

• Mobilappar – chatten i en WebView
• Smart Answer – AI-svar i din webbplatssökning

Drift

• Integrera integritetsskydd – samtycke, lagring, integritetstext
• Gränser och kvoter
• Felsökning och checklista

Fler sidor om ämnet

• Bädda in widgeten – den korta versionen
• Tekniska detaljer – mätningar av storlek, tillgänglighet och kontrast
• Öppna chatten från egen länk eller knapp
• Reklamkortet i chatten
• Kunddata i chatten
• Egen domän (förstapart)
• HTTP-reserv
• Infoga integritetstexten automatiskt

Begrepp

• Webbplatsnyckel – ett projekts offentliga nyckel (24 tecken), som finns i kodsnutten. Ingen hemlighet.
• Projekt – en webbplats eller app med egna inställningar; flera projekt bildar en arbetsyta.
• Agentpanel – gränssnittet där teamet svarar.
• Bekräftad användare – en besökare vars identitet din server har signerat via userHash.
• Laddare / kärna – den lilla laddningsdelen loader.js och huvuddelen core.<hash>.js som laddas därefter.

Alla delar av dokumentationen i en överblick: Dokumentation.