Register över exportformat

1. Om registret

Detta register anger de format och datastrukturer som de uppgifter som kan exporteras från Gosoft Connect finns tillgängliga i, och de standarder som de följer. Det är det onlineregister som krävs enligt artikel 26 b i EU:s dataakt (förordning (EU) 2023/2854), och det omfattar de exporterbara uppgifterna i punkterna (a)-(g) i avsnitt 10.8 i användarvillkoren. Gosoft uppdaterar registret varje gång en export eller en lagrad datastruktur ändras; datumet Uppdaterad överst på denna sida är dagen för den senaste ändringen.

Namnen på fält och kolumner skrivs så som de står i filerna. Begäranden om export, och frågor om en export, skickas till support@gosoft.fi (avsnitt 7). Avsnitt 9 beskriver portalexporterna som gränssnitt för programvara (artikel 30.2 i dataakten) och avsnitt 10 avgifterna (artikel 29).

2. Exporter i portalen

Så länge en arbetsyta finns kan varje användare som har åtkomst till kundens organisation i portalen göra dessa exporter själv (avsnitt 10.3 i användarvillkoren).

2.1 Inskick från formulär och chatt (CSV)

• Filnamn: submissions-<de 8 första tecknen i arbetsytans id>-<ÅÅÅÅ-MM-DD>.csv, där datumet är exportdagen i UTC.
• Kodning: UTF-8 med byteordningsmarkering (BOM), kommaavgränsade värden och en rubrikrad. Varje rad slutar med ett radmatningstecken (LF), och även en radbrytning inuti ett värde är LF.
• Värden: varje värde utanför kolumnen test står inom dubbla citattecken, och ett dubbelt citattecken inuti ett värde dubbleras. Ett värde som saknas kan vara ett tomt fält utan citattecken. Ett värde som börjar med =, +, - eller @, bortsett från eventuella blanktecken före det, får en apostrof (') framför sig så att ett kalkylprogram inte kör det som en formel.
• Rader: en rad per inskick, de senaste 5 000, det senaste först. En fil kan begränsas till ett formulär (form_id), till en av källorna i kolumnen source och till riktiga poster eller till testposter.

Rubrikraden namnger dessa kolumner i denna ordning:

2.2 En konversation (JSON)

• Filnamn: conversation-<de 8 första tecknen i konversationens id>-<ÅÅÅÅ-MM-DD>.json, där datumet är exportdagen i UTC.
• Kodning: UTF-8, indraget med 2 blanksteg. Tidpunkter anges enligt ISO 8601 i UTC.
• Struktur: ett objekt med fem medlemmar:
  • conversation: id, workspace_id, visitor_id, channel (chat för AI-chatten, livechat för livechatt), status, summary, metadata, started_at, last_activity_at, is_test;
  • messages: en lista över meddelandena, det äldsta först, vart och ett med id, role, content, tool_calls, tool_name, metadata, created_at och ai_generated (true om AI:n har skrivit meddelandet helt eller delvis, annars false);
  • flags: en lista över konversationens modereringsflaggor, den senaste först, var och en med id, message_id, reason, source, status, categories och created_at;
  • ai_generated_fields: en lista över de fält som AI:n skrev: conversation.summary om konversationen har en sammanfattning, annars inga;
  • exported_at: när filen skapades.

2.3 En konversation (CSV)

• Filnamn: som i 2.2, med ändelsen .csv.
• Kodning: UTF-8 utan byteordningsmarkering, kommaavgränsade värden och en rubrikrad. Varje rad slutar med vagnretur och radmatning (CR LF); en radbrytning inuti ett värde är LF.
• Värden: varje värde står inom dubbla citattecken, och ett dubbelt citattecken inuti ett värde dubbleras. Ett värde som saknas är ett tomt fält utan citattecken. Apostrofregeln i 2.1 gäller.
• Rader: en rad per meddelande, det äldsta först.

Rubrikraden namnger dessa kolumner i denna ordning:

2.4 En fil som laddats upp med ett inskick

• Innehåll: filen så som den laddades upp, en fil i taget, med den medietyp som avsändarens webbläsare angav för den (application/octet-stream om webbläsaren inte angav någon eller angav en ogiltig).
• Filnamn: det lagrade filnamnet, där varje följd av andra tecken än ASCII-bokstäver, siffror, understreck, punkter och bindestreck har ersatts med ett understreck, högst 120 tecken.

2.5 QR-koden för ett Q-formulär

• Innehåll: Q-formulärets adress, https://gosoft.fi/<arbetsytans standardspråk>/q/<arbetsytans id>/<Q-formulärets id>, som en QR-kod med en tyst zon på en modul och felkorrigeringsnivå M, svart på vitt.
• PNG (image/png): 800 pixlar bred, laddas ned som qr-<Q-formulärets id>.png.
• SVG (image/svg+xml): 480 pixlar bred; det är bilden som visas i Q-formulärets redigerare och på dess utskriftssida.

3. Exporter på begäran

Övriga exporterbara uppgifter exporterar Gosoft på begäran (avsnitt 10.8 i användarvillkoren): inom övergångsperioden vid ett byte eller, utanför ett byte, inom 30 dagar från begäran. Gosoft tar inte ut någon avgift för detta (avsnitt 10.9).

• Format: en JSON-fil för varje slag av post nedan, i UTF-8: en lista över objekt vars nycklar är de fältnamn som anges här. Tidpunkter anges enligt ISO 8601 i UTC och kalenderdatum i formen ÅÅÅÅ-MM-DD. På begäran levererar Gosoft i stället CSV-filer med fältnamnen som rubrikrad.
• Filer: de lagrade filerna följer med posterna: filer som laddats upp med inskick så som de laddades upp, och bilder som de WebP-filer som Tjänsten sparar.

(a) Inskick

• Inskick: id, workspace_id, conversation_id, visitor_id, source, form_id, values (svaren per fält), files, user_agent, context, ai_summary, is_test, preview_session_id, created_at.
• files: en post per uppladdad fil, med field, name, size, mime (medietypen) och path (var filen lagras).
• context: url, landing, referrer, lang, widget (dess id och name) och path (de val som besökaren gjorde i widgeten före formuläret, vart och ett med q och a).
• Uppladdade filer: så som de laddades upp. En testpost som gjorts i en förhandsvisning på webbplatsen anger sina filer med discarded satt, och själva filerna har inte sparats. En fil som Tjänsten inte kunde lagra när inskicket kom in anges med discarded och failed satta och utan path.

(b) Konversationer och meddelanden

• Konversationer: id, workspace_id, visitor_id, visitor_profile_id, channel, status, summary, metadata, ai_category, is_test, started_at, last_activity_at, visitor_seen_at.
• Meddelanden: id, conversation_id, workspace_id, role, content, tool_calls, tool_name, metadata, created_at.
• Modereringsflaggor: id, workspace_id, conversation_id, message_id, reason, source, status, categories, reviewer_id, triaged_at, metadata, created_at.

(c) Leads, bokningar, besökare och analys

• Leads: id, workspace_id, conversation_id, visitor_id, visitor_profile_id, name, email, phone, message, metadata, status, created_at.
• Bokningar: id, workspace_id, submission_id, source, form_ref (formulärsteget eller Q-formuläret) och widget_id (widgeten) där tiden bokades, field, starts_at, ends_at, tz, summary, status, write_via (hur bokningen kom in i företagets kalender: skrevs in i den eller skickades som en inbjudan), external_uid, external_ref och external_error (händelsen som skrevs in i en ansluten kalender, eller varför det misslyckades), invited_refs (de medlemmar och verifierade e-postmottagare som fick inbjudan, med sina id:n), created_at.
• Besöksposter: workspace_id, visitor_id, created_at. Hashen av besökarens hemlighet är en inloggningsuppgift och exporteras inte.
• Besöksprofiler: id, workspace_id, visitor_id, facts, summary, last_seen_at, created_at, updated_at.
• Analyshändelser: id, workspace_id, visitor_id, kind (pageview, click, dwell eller conversion), url, referrer, lang, device_class, duration_ms, meta, created_at.
• Dagliga analyssummor: workspace_id, date, pageviews, unique_visitors, clicks, total_dwell_ms, conversions, conversations_started, messages_user, messages_assistant, submissions, ai_cost_cents, ai_prompt_tokens, ai_completion_tokens, computed_at.

(d) Inställningar

• Arbetsytor: id, name, domains, timezone, status, setup (läget i den guidade konfigureringen och resultatet av webbplatsskanningen), created_at, updated_at.
• Inställningsfiler: varje arbetsytas config.json och varje Q-formulärs qforms/<Q-formulärets id>.json, i Gosofts eget JSON-format (avsnitt 5). De nycklar på översta nivån i config.json som portalen sparar är name, domains, languages, defaultLang, langSource, langParam, theme, widgets, livechat, campaigns, attribution, constants, behaviors, retrieval, knowledge, runtime, schemaVersion, automations, intelligence, analytics och privacy. Ett calendar-block som sparades före kalenderuppdateringen den 5 oktober 2026 kan finnas kvar i filen tills kalenderanslutningen sparas eller tas bort i portalen (se Kalenderanslutningar nedan). Inloggningsuppgifterna i dem exporteras inte: kalenderlösenordet i ett sådant block, produktflödets webhookhemlighet och hemligheterna för webhookar och för en automations adress för andra system.
• Företagsuppgifter som AI-assistenten svarar utifrån (entity.json): company, contact, business_hours.
• Anslutningar till andra tjänster: id, workspace_id, provider, name, secret_hint, last_ok_at, last_error, created_by, created_at. Själva hemligheten exporteras inte.
• Kalenderanslutningar: workspace_id, provider (none, ics för en tillgänglighetslänk eller caldav för ett CalDAV-konto), settings (för CalDAV serverns adress, användarnamnet, den valda kalendern och händelsernas rubrik; för en tillgänglighetslänk dess värd), invite (om en bokning som inte skrivs in i en kalender skickas som en inbjudan), status, last_ok_at, last_error, updated_at, updated_by. CalDAV-lösenordet eller själva tillgänglighetslänken är en inloggningsuppgift och exporteras inte.
• Verifierade e-postmottagare: id, workspace_id, email, lang, verified_at, verified_via, created_by, created_at.
• Kunskapskällor: id, workspace_id, kind, url, status, pages, failures, cadence, added_at, last_checked_at, last_change_at, last_result.
• Organisationen: dess namn och faktureringsuppgifter; dess abonnemang (paket, pris, faktureringsperiod och betalningssätt, status, deras datum och den version av användarvillkoren som godkändes vid en fakturabeställning); och dess godkännanden av personuppgiftsbiträdesavtalet och användarvillkoren (versionerna, det språk som visades, namn och roll för den som godkände, tidpunkten och IP-adressen).

(e) Kunskapsbas, produktflöden och bilder

• Dokument: id, workspace_id, type, kind, source_type, source_ref, parent_id, title, content (den extraherade texten), content_hash, language, metadata, context_summary, status, ingested_at, updated_at. Produkter i ett produktflöde är dokument av slaget product, med pris, lagersaldo och varianter i metadata. Av ett dokument som laddats upp till kunskapsbasen sparas endast den extraherade texten, med originalfilens namn och medietyp i metadata, inte originalfilen.
• Textavsnitt (de delar av dokumenten som AI:n söker i): id, document_id, workspace_id, chunk_index, content, tokens, embedding (en textinbäddning med 1 024 tal som Tjänstens inbäddningsmodell har beräknat, i dag bge-m3), content_tsv (textavsnittets ord för nyckelordssökning, i PostgreSQL:s textform för en tsvector), metadata, created_at.
• Importjobb som läser en webbplats eller ett flöde, och som sparas högst 14 dagar efter att de avslutats: id, workspace_id, kind, key, payload, progress, result, attempts, last_error, created_at, started_at, done_at.
• Bilder i mediabiblioteket: WebP-filer som är högst 1 024 pixlar breda. En bild som är bredare än 400 pixlar har dessutom en kopia som är hälften så bred och vars namn slutar på -sm.webp.
• Organisationens bilder (medlemmarnas profilbilder): WebP-filer som är högst 512 pixlar breda.

(f) Medlemmar och åtkomst

• Medlemmar: user_id, display_name, email, title, avatar_url (profilbilden), role, livechat_agent, created_at (när de gick med) och en livechattagents egna tillgänglighetstider (availability).
• Väntande inbjudningar: id, email, role, purpose, created_by, created_at, expires_at.
• Granskningslogg: id, user_email, workspace_id, workspace_name, action, subject, subject_id, metadata, ip_address, created_at.

(g) Andra uppgifter som Tjänsten sparar om kundens användning

• Rapporten om luckor i kunskapsbasen: workspace_id, generated_at, source_count, gaps (en lista över ämnen, vart och ett med topic, sample_question och count).
• Sammanställningar: id, workspace_id, kind, period_start, period_end, language, conversation_count, digest, created_at.
• Poster om AI-användning: id, workspace_id, provider, model, prompt_tokens, completion_tokens, total_tokens, cached_tokens, cache_write_tokens, reasoning_tokens, cost_cents, duration_ms, finish_reason, error, purpose, created_at, samt conversation_id och message_id så länge de finns. cached_tokens och cache_write_tokens ingår i prompt_tokens och reasoning_tokens i completion_tokens; vart och ett är tomt om det inte har rapporterats.
• Automationskörningar: id, workspace_id, event_type, source, event, bag (värdena och variablerna i en körning som inte har avslutats), status, step_count, scheduled_at, started_at, finished_at, error, created_at; och deras steg: id, run_id, workspace_id, node_id, kind, status, output, summary, error, ms, created_at.
• Aviseringsposter (aviseringar till medlemmarna om inskick och andra händelser samt kampanjperioder som har börjat eller slutat): id, workspace_id, event_type, rule, status, recipients, detail, created_at.
• Svar som endast skickats per e-post: arbetsytan och tidpunkten för varje svar (workspace_id, created_at), utan innehåll, som sparas i 62 dagar för att räkna svaren mot gränserna för dem.
• Meddelanden som skickats om arbetsytan (till exempel om användningen av kvoten för AI-samtal): workspace_id, key, period, sent_at.
• Rapporter om laddningsfel (widgetar som inte kunde laddas på kundens webbplats): id, workspace_id, stage, message, page_host, user_agent, created_at.
• Kollega-trådar: id, workspace_id, user_id (medlemmen), created_at, updated_at; och deras meddelanden: id, thread_id, role, content, sources, proposal, proposal_state, created_at.
• Överlämningar av arbetsytor (en arbetsyta som har överlämnats till en annan organisation): id, workspace_id, source_org_id, customer_org_name, target_email, status, created_by, created_at, expires_at, accepted_at, accepted_by, target_org_id. Överlämningsnyckeln är en inloggningsuppgift och exporteras inte.
• Sessioner för förhandsvisning på webbplatsen: id, workspace_id, user_id (den medlem som öppnade sessionen), origin, focus (de widgetar som förhandsvisades), lang, visitor_id, created_at, expires_at, revoked_at. Sessionens nyckel är en inloggningsuppgift och exporteras inte.

4. Uppgifter som inte är exporterbara

Som avsnitt 10.8 i användarvillkoren anger är följande inte exporterbara uppgifter:

• Gosofts programvara och eget innehåll.
• Gosofts instruktioner till AI-modellerna.
• Uppgifter enligt avsnitt 5.5 i användarvillkoren, som varken identifierar kunden eller någon person.
• Lösenord, nycklar och andra inloggningsuppgifter, till exempel hashen av en besökares hemlighet, hemligheterna för anslutna tjänster och kalendrar, nycklar för inloggning, inbjudningar, överlämningar och förhandsvisningar samt nycklarna för push-prenumerationer.
• Andra kunders uppgifter.

5. Standarder

• CSV: RFC 4180, med de skillnaderna att filen med inskick (2.1) börjar med en byteordningsmarkering och avslutar sina rader med radmatning (LF), och att ett värde som börjar med =, +, - eller @ får en apostrof framför sig i båda CSV-exporterna.
• JSON: RFC 8259. Text: UTF-8 (RFC 3629). Tidpunkter: ISO 8601, i UTC.
• Bilder: PNG (ISO/IEC 15948), SVG 1.1 (W3C) och WebP (RFC 9649). QR-koder: ISO/IEC 18004.
• Filer som laddats upp med inskick är i det format som de laddades upp i.
• Inställningar: inställningarna för widgetar, Q-formulär och automationer (config.json, qforms/<Q-formulärets id>.json) är i Gosofts eget JSON-format, som ingen öppen standard omfattar; en annan tjänst kan inte nödvändigtvis använda dem som sådana.

6. Kända begränsningar

• Portalen exporterar högst 5 000 inskick per fil, och konversationer och uppladdade filer en i taget; på begäran exporterar Gosoft alla på en gång.
• Originalfilen till ett dokument som laddats upp till kunskapsbasen sparas inte, endast den text som extraherats ur den.
• Bilder i mediabiblioteket sparas som WebP-filer som är högst 1 024 pixlar breda och medlemmarnas profilbilder som WebP-filer som är högst 512 pixlar breda, inte i det format och den storlek som de laddades upp i.
• Textinbäddningar är knutna till den modell som beräknade dem; en annan tjänst måste i regel beräkna egna utifrån texten.
• Testposter som gjorts i en förhandsvisning på webbplatsen raderas efter 14 dagar, och filer som laddats upp i en förhandsvisning sparas inte.
• Uppgifter som redan har raderats, av kunden, enligt lagringstiderna eller enligt avsnitt 10.4 i användarvillkoren, exporteras inte, inte heller det som finns kvar av dem i säkerhetskopiorna tills dessa roteras bort.
• Svar på ett formulär som endast skickar dem per e-post, vilket alla formulär i gratispaketet gör, sparas inte och kan därför inte exporteras.

7. Så begär du en export

Skriv till support@gosoft.fi och ange de berörda arbetsytorna. Ett byte till en annan leverantör eller till kundens egna system, och tidsplanen för det, följer avsnitt 10.6-10.9 i användarvillkoren.

8. Var uppgifterna finns

Var Tjänstens servrar och säkerhetskopior finns, vilken lag som gäller för de uppgifter som finns på dem och vilka åtgärder Gosoft vidtar mot att myndigheter i stater utanför unionen får tillgång till dem anges i avsnitt 10.10 i användarvillkoren (artikel 28.1 i dataakten).

9. Gränssnitt

Portalexporterna i avsnitt 2 är HTTP-gränssnitt under https://connect.gosoft.fi/portal/api/ som varje medlem i kundens organisation kan anropa när den är inloggad, utan kostnad. Den nya leverantör som kunden flyttar Tjänsten till kan få ett medlemskonto för att använda dem (avsnitt 10.7 i användarvillkoren). I sökvägarna är {organisation}, {arbetsyta}, {konversation} och {Q-formulär} de id:n som syns i portalens egna adresser, och {inskick} är submission_id i 2.1.

• GET orgs/{organisation}/workspaces/{arbetsyta}/submissions.csv: filen i 2.1. Den tar parametrarna form_id, source och test (real för endast riktiga poster, only för endast testposter; båda om parametern utelämnas).
• GET orgs/{organisation}/workspaces/{arbetsyta}/submissions/{inskick}/files/{n}: filen i 2.4, där n är filens plats i inskickets files, räknat från 0.
• GET orgs/{organisation}/workspaces/{arbetsyta}/conversations/{konversation}/export: filen i 2.2 eller, med format=csv, filen i 2.3.
• GET orgs/{organisation}/workspaces/{arbetsyta}/qforms/{Q-formulär}/qr.png och qr.svg: bilderna i 2.5.
• GET orgs/{organisation}/audit, för organisationens administratörer: organisationens granskningslogg över åtkomst till personuppgifter som ett JSON-objekt vars entries är loggens poster, den senaste först, med fälten i granskningsloggen i avsnitt 3 (f) utom id och workspace_name. Den tar parametrarna limit (500 om den utelämnas, högst 5 000) och since (en tidpunkt; endast poster från och med den).

10. Avgifter

Gosoft tar inte ut någon avgift för byte, för exporter på begäran eller för hämtning av uppgifter (avsnitt 10.9 i användarvillkoren), och det finns inga avgifter eller viten för att avtalet upphör i förtid. Avgifter som redan har betalats återbetalas inte när ett abonnemang eller avtalet upphör under en faktureringsperiod, utom i de fall som avsnitt 9.6 anger. Under övergångsperioden fortsätter kundens paket till sitt vanliga pris, om inte kunden ber att det ska upphöra tidigare (avsnitt 10.7). Paketens priser finns i prislistan.