Integrationer, migrering och API-nycklar

Under Integrationer (/app/integrations) kopplar du reactive.chat till verktyg som teamet redan använder. Integrationer gäller för hela arbetsytan. Ägare och administratörer får konfigurera dem; en administratör som är begränsad till enskilda projekt får inte det.

Den här sidan beskriver vad integrationerna gör och hur du använder dem. Tekniska detaljer, till exempel om signering av webhookar, finns i delen Teknisk integration.

Ärligt om nuläget

Anslutningar till fler än 30 tjänster finns tillgängliga. De flesta har testats mot simulerade motparter men har ännu inte körts mot den verkliga tjänsten. Integrationssidan märker dem med ”Inte verifierad mot den verkliga tjänsten”; vissa har märkningen ”Pågår”. Webhookar och Slack saknar denna märkning. Konfigurera en overifierad integration, testa den med riktiga data och meddela oss via Skicka feedback om något inte stämmer.

Konfigurera en integration

1. Öppna Integrationer. Överst ser du hur många som är anslutna, har fel eller är pausade och om leveranser har misslyckats.
2. Sök i katalogen (Sök integrationer, filtret ”Alla” eller ”Inte anslutna”) och klicka på Konfigurera.
3. Ange de inloggningsuppgifter som tjänsten kräver, vanligen en API-nyckel eller en token från ditt konto där.
4. Anslut och aktivera kontrollerar anslutningen direkt och aktiverar integrationen. Med Spara utan att aktivera skjuter du upp det.

Senare kan du Redigera, Pausa, Återaktivera eller Ta bort en integration. Borttagning raderar de sparade inloggningsuppgifterna och kan inte ångras. Inloggningsuppgifter lagras krypterat.

En knapp för att logga in hos tjänsten finns bara för Google Drive. För alla andra anger du uppgifterna själv, för Slack till exempel uppgifterna för en egen Slack-app.

När en tjänst inte svarar

Varje integration arbetar via en kö. Om en tjänst inte svarar görs nya leveransförsök med allt längre mellanrum; efter upprepade fel pausas den tillfälligt (”Tillfälligt pausad: tjänsten svarade inte upprepade gånger …”). En händelse som inte har levererats efter ungefär en timme förkastas. De senaste misslyckade leveranserna visas i avsnittet Misslyckade leveranser, utan innehållet.

Ett chattmeddelande väntar aldrig på en integration. Om en tjänst hänger sig fortsätter chatten ostört.

Vad som finns

Aviseringar till teamet

• Slack – varje ny konversation visas som en tråd i en kanal. Du svarar i tråden och besökaren ser svaret i chatten. /rc visar status. Du kopplar Slack-användare till agenter.
• Microsoft Teams, Discord – aviseringar via en webhookadress.
• Telegram – aviseringar till en chatt via bottoken och chatt-ID.
• E-post – aviseringar till en gemensam e-postlåda för teamet.

Automatisering

• Webhookar – reactive.chat skickar signerade händelser till en valfri adress med https:// som protokoll: ny konversation, varje meddelande, begärd överlämning till en människa, lämnat betyg, nytt felfall. Även Zapier, Make och n8n ansluter på detta sätt. Du kan visa, kopiera och generera om Signeringshemligheten; en ny hemlighet gäller omedelbart och den gamla slutar gälla.
• Zapier – via gränssnittets REST-hooks. Det finns ännu ingen färdig app för Make och n8n; använd webhookar där.

Kontext i agentpanelen

Dessa integrationer visar kort om besökaren i agentpanelens kontextkolumn, till exempel beställningar eller CRM-kontakt, vissa med åtgärder:

• CRM – HubSpot, Pipedrive
• Butik – Shopify, Shopware 6, WooCommerce
• Betalningar – Stripe (med en begränsad läsnyckel)
• Webbplats – WordPress
• Analys – Matomo, Plausible, Google Analytics 4
• Fel – Sentry

Kortet markerar uppgifter som bygger på ett osignerat påstående från besökaren. Du utför åtgärder med Kör och en bekräftelse.

Ärenden, bokningar, telefon

• Zendesk, Freshdesk, Jira, Linear, GitHub – skapa ärenden från en konversation eller ett felfall.
• Cal.com – visa och boka lediga tider, även genom AI-assistenten.
• Twilio – SMS från agentpanelen och sändningsvägen för SMS-kanalen.

Kunskapskällor

• Notion, Confluence – ta in innehåll i kunskapsbasen.
• Google Drive – under kunskapsbasen, ”Filer och Google Drive” (se Kunskapsbas och hjälpcenter).
• KB-Crawler – inställningar för genomsökning av webbplatsen.

Kanaler

• WhatsApp Business, Facebook Messenger, Instagram Direct – se Kanaler.

Flytta från en annan leverantör

Under Migrering (/app/migration) tar du över data från ett annat chattverktyg:

• Intercom och Crisp – via deras gränssnitt eller en exportfil; för Crisp även hjälpartiklar som Markdown,
• Tidio – via en exportfil,
• Zendesk – via den fullständiga JSON-exporten och hjälpcentrets export.

Så går du till väga:

1. Starta en ny migrering och välj mål (Till vilket projekt?).
2. Anslut och se vad som finns – du ser befintligt innehåll och ett stickprov.
3. Vad ska följa med? – kontakter, konversationer, artiklar.
4. Starta migrering. Du kan Stoppa eller Förkasta jobb.

Det här bör du känna till:

• Importerade konversationer hamnar i agentpanelen som avslutade.
• Importerade kontakter räknas som overifierade.
• Känsliga uppgifter i texterna maskeras.
• Bilagor följer med som länk, inte som fil.
• En andra körning skapar inga dubbletter.
• Dina inloggningsuppgifter till den gamla leverantören raderas efter körningen.
• Leverantörernas gränssnitt har testats utan riktiga konton där; filimporterna har testats från början till slut med exempelfiler.

Med Byt ut inbäddningskoden översätter kontot befintlig Intercom- eller Crisp-kod till reactive.chat-kod. JavaScript-kommandona boot, open, identify och track behåller samma namn som i Intercom.

API-nycklar

Under API-nycklar (/app/api-keys, ägare och administratörer) skapar du nycklar för REST-gränssnittet. En nyckel visas exakt en gång; därefter lagrar reactive.chat bara ett fingeravtryck av den. Kopiera den därför genast till en säker plats.

När du skapar den väljer du vad nyckeln får göra:

• endast läsa
• läsa och skriva
• endast import av kunddata – för importen som beskrivs i Kunddata i chatten
• läsa + besökaruppgifter eller läsa, skriva + besökaruppgifter – bara med dessa ser nyckeln besökarnas namn, e-post och telefon

Listan visar namn, prefix, när och av vem nyckeln skapades och när den användes senast. Återkalla gäller omedelbart och kan inte ångras.

Med en nyckel kan du också koppla reactive.chat till AI-verktyg som använder Model Context Protocol (MCP); sidan visar exempel. Hur gränssnittet fungerar beskrivs i delen Teknisk integration.