Integrationer och kanaler (tekniskt)

Kanaler för in meddelanden från andra tjänster i samma agentpanel som webbplatschatten; integrationer skickar händelser till andra tjänster eller hämtar kunskap från dem. Den här sidan beskriver tekniken. Hur du hanterar dem i kontot beskrivs i Handboken.

Status: kanaler och de flesta integrationer har testats mot simulerade leverantörssvar, men ännu inte mot alla riktiga konton. Den signerade webhooken är färdig (med den begränsning som anges där); för alla andra leverantörer bör du kontrollera integrationens logg efter aktivering. Betrakta dem som beta.

Gemensamma regler

• Callbackadresser har formen https://reactive.chat/kanal/<kanal>/<SITE_KEY>. Webbplatsnyckeln finns i kontot under Projekt → Installation.
• Varje inkommande väg verifierar leverantörens signatur. Utan leverantörens hemlighet tas inget emot.
• Inloggningsuppgifter lagras krypterade och separat från den övriga konfigurationen.
• Svar från teamet går till leverantören via en utgående kö; en plattform som hänger sig fördröjer ingen chatt.
• Meddelandelängd: inkommande meddelanden som är längre än planens gräns kortas och märks med [...] (Gränser).
• Bilagor från kanaler (e-post, Telegram-foton) genomgår samma kontroll som i widgeten (typ, storlek, kvot). Avvisade filer visas i texten som ”[Bilagan godtas inte: …]”, på projektets standardspråk (de, en, pl, annars engelska).

WhatsApp, Messenger, Instagram

Ställ in dem i kontot under Integrationer. Du behöver en egen app i Meta Developer Dashboard; dina meddelanden går inte via ett konto som tillhör oss.

• Callback-URL: https://reactive.chat/kanal/whatsapp/SITE_KEY, …/kanal/messenger/SITE_KEY eller …/kanal/instagram/SITE_KEY
• Verify Token: en lång slumpmässig sträng som du anger identiskt hos Meta och hos oss (jämförelse i konstant tid).
• App Secret: vi använder den för att verifiera signaturen för varje callback. Utan App Secret tar den inkommande vägen inte emot något.
• Access Token: vi använder den för att skicka för din räkning.

Plattformsregler som gör att leveranser misslyckas utan synligt fel:

• WhatsApp: under 24 timmar efter kundens senaste meddelande får du svara fritt, därefter bara med en godkänd mall (typ UTILITY, exakt en platshållare {{1}}). Ange dess namn i konfigurationen; utanför tidsfönstret skickar vi inte fritt.
• Instagram: kunden måste skriva först.
• Messenger: av meddelandetaggarna återstår bara HUMAN_AGENT; andra avvisar vi.

Meta förväntar sig svar på en callback inom fem sekunder; vår inkommande väg tar bara emot och köar.

Telegram, SMS och e-post

Dessa kanaler hör till projektet och ställs in under Projekt → Kanaler.

• Telegram: en egen bot. När du sparar bot-token registrerar vi själva callbackadressen https://reactive.chat/kanal/telegram/SITE_KEY via setWebhook, med en slumpmässig secret_token som varje callback måste innehålla. Som standard svarar även assistenten.
• SMS: via ditt Twilio-konto (integrationen Twilio). För numret anger du https://reactive.chat/kanal/sms/SITE_KEY under ”A message comes in”; X-Twilio-Signature verifieras. Som standard svarar även assistenten.
• E-post: din brevlåda hämtas via IMAP varje minut, svar går via din SMTP (annars via vår sändningstjänst med Reply-To). Ingen gammal e-post hämtas vid aktivering. Koppling till konversationen via In-Reply-To/References, annars avsändare och ämne från de senaste 30 dagarna. Tas inte med: frånvaromeddelanden, leveransrapporter, e-postlistor, skräppostmarkerade meddelanden, fler än 20 meddelanden per avsändare och timme (300 per projekt). Som standard svarar assistenten inte på e-post; om den aktiveras märks dess svar med Auto-Submitted: auto-replied.

Känd lucka: om en leverans till leverantören misslyckas permanent (blockerat nummer, stängt tidsfönster) finns orsaken i integrationens logg, men ännu inte i konversationen.

Integrationer

Du slår på integrationer i kontot under Integrationer. Var och en har egna inloggningsuppgifter (nyckel, token, adress eller inloggning hos leverantören). Händelser (conversation.created, message.created, handoff.requested, csat.submitted, fehlerfall.erstellt) går via en kö med nya försök:

• upp till fem nya försök med ökande intervall (1 s till drygt 10 minuter),
• en kretsbrytare per leverantör och arbetsyta: efter 5 fel på 60 sekunder, 30 sekunders paus,
• händelser som är äldre än en timme levereras inte längre,
• en chatt väntar aldrig på en integration.

Leverantörer i koden:

• Händelser till egna system: webhooks (signerade, se Webhooks), Zapier, Make, n8n (via REST-hooks)
• Teamchatt: Slack, Microsoft Teams, Discord
• Ärenden och CRM: Zendesk, Freshdesk, HubSpot, Pipedrive, Jira, Linear, GitHub
• Butiker: Shopify, WooCommerce, Shopware, Stripe
• Kunskap: sökrobot för webbplatser, WordPress, Notion, Confluence, Google Drive
• Analys och fel: Google Analytics 4, Matomo, Plausible, Sentry
• Tidsbokning: Cal.com
• Kanaler: WhatsApp, Messenger, Instagram, Telegram, Twilio, e-post

Du kan inte registrera egna leverantörer. För egna kopplingar använder du webhooks, server-API:et eller MCP.

Butiksfunktioner i chatten (som ”Lägg i varukorg” för WooCommerce, Shopify och Shopware) aktiveras av reactive.chat per projekt; de fungerar bara på den registrerade butiksvärden och har inget eget JavaScript-API.

Mobilappar

För appar finns inget inbyggt SDK, men en inbäddningssida för WebViews: Mobilappar.

Nästa: Mobilappar