Adatformátumok

1. Hogyan töltheted le

A munkaterület adminisztrátora a kezelőfelületen, az Előfizetés → Számlázás → Adataid kártyán bármikor, bármelyik csomagon kérhet adatexportot. Az export néhány perc alatt elkészül, és 7 napig tölthető le. A szerződés megszűnése után még legalább 30 napig letölthető (ÁSZF 15.4). Az adatletöltés díjmentes.

Egy látogató adatait (beszélgetései és üzenethagyásai) külön is letöltheted és törölheted a Munkaterület → Biztonság → Adatvédelem oldalon.

2. A fájl

Az export egy ZIP-fájl, amelynek formátumverziója „zuppor-export/1”. A gyökérben lévő README.txt magyarul és angolul leírja a szerkezetet, és felsorolja azokat a fájlokat, amelyeket a készítéskor nem sikerült beolvasni.

Közös szabályok: a JSON-fájlok UTF-8 kódolású tömbök, táblánként egy, soronként egy objektummal. Az időpontok ISO 8601 formátumúak, UTC-ben. Az azonosítók UUID-k, a hivatkozások (például egy üzenet session_id mezője) ezekre mutatnak. A CSV-fájlok UTF-8 kódolásúak (BOM-mal, hogy a táblázatkezelők helyesen nyissák meg), vesszővel elválasztva, az első sorban a mezők nevével.

3. Tartalom

• data/workspace.json - A munkaterület és minden beállítása (widget, nyitvatartás, belépőkapu, proaktív megszólítás, csomag, számlázási adatok). Legalább ezek a mezők: id, name, widget_config, business_hours, timezone, identity_gate_fields, proactive_config, system_prompt, subscription_plan, billing_name, billing_tax_id, created_at.
• data/team.json - Munkatársak. Legalább ezek a mezők: id, email, first_name, last_name, role, permissions, is_active, locale, created_at.
• data/invites.json - Függő meghívók. Legalább ezek a mezők: id, email, role, expires_at.
• data/documents.json - Tudásbázis-dokumentumok. Legalább ezek a mezők: id, filename, source_type, source_url, status, created_at.
• data/qa_rules.json - Kérdés-válasz szabályok. Legalább ezek a mezők: id, question, answer.
• data/canned_responses.json - Gyorsválaszok. Legalább ezek a mezők: id, shortcut, content.
• data/widget_flows.json - Beszélgetési folyamatok. Legalább ezek a mezők: id, status, version, graph, layout.
• data/conversations.json - Beszélgetések. Legalább ezek a mezők: id, visitor_name, visitor_email, started_at, last_message_at, message_count.
• data/messages.json, data/messages.csv - Üzenetek. Legalább ezek a mezők: id, session_id, role (customer, ai, operator), content, rating, created_at.
• data/attachments.json - A beszélgetések csatolmányai. Legalább ezek a mezők: id, conversation_id, kind, content_type, size_bytes, original_name.
• data/offline_messages.json, data/offline_messages.csv - Üzenethagyások. Legalább ezek a mezők: id, conversation_id, name, email, message, created_at.
• data/legal_acceptances.json - A feltételek elfogadásai. Legalább ezek a mezők: id, event, accepted_at, documents, health_related.
• data/payments.json - Fizetések. Legalább ezek a mezők: id, amount, currency, status, plan, created_at.
• data/product_recommendations.json - A csevegőablak termékajánlásai: a vevő mondata, a szűrő, a találatok száma és a mutatott termékek. Legalább ezek a mezők: id, conversation_id, created_at, message, filter, total, shown.
• data/product_recommendation_clicks.json - Kattintások a termékkártyákra. Legalább ezek a mezők: recommendation_id, product_id, position, clicked_at.
• files/documents/<azonosító>/<fájlnév> - A feltöltött dokumentumok eredetiben (PDF), a weboldalakból kinyert szöveg szövegfájlként.
• files/attachments/<beszélgetés>/<azonosító>-<név> - A beszélgetések képei és videói eredetiben.

4. Ami nem tölthető le

A Szolgáltatás belső működéséhez tartozó adatok (ÁSZF 15.10): a tudásbázisból képzett vektoros beágyazások, a rendszer- és biztonsági naplók, valamint a titkok - jelszó-hash, meghívó- és bankkártya-token, és a fizetési szolgáltató nyers válaszai. Ezek nélkül a letöltött adatok teljes értékűen használhatók.

5. Változások

Ha a formátum úgy változik, hogy egy korábban értelmezett fájl másként olvasandó, a formátumverziót megemeljük, és ezen az oldalon jelezzük. Új mező vagy új fájl megjelenése nem változtat a verzión.