Live Chat Dokumentácia - Jetweb API Referencia

Prehľad

Jetweb Live Chat poskytuje kompletnú podporu zákazníkov v reálnom čase pre stránky WordPress. Chatový widget spája návštevníkov s vaším tímom podpory cez WebSocket správy s okamžitým doručením a indikátormi písania.

Všetky správy sú automaticky prekladané medzi jazykom návštevníka a agenta pomocou AI prekladu. Systém obsahuje plne vybavený panel agenta, predpripravené odpovede, históriu konverzácií a integrovaný systém tiketov pre offline podporu.

Funkcie

Správy v reálnom čase

Okamžité správy cez WebSocket s indikátormi písania a potvrdeniami o doručení.

Panel agenta

Plnohodnotný panel so správou fronty, smerovaním konverzácií a spoluprácou tímu.

Prispôsobiteľný widget

Vložiteľný chatový widget s prispôsobením témy, ovládaním pozície a optimalizáciou pre mobil.

Systém tiketov

Integrovaný systém tiketov pre offline správy so sledovaním stavu a e-mailovými notifikáciami.

AI Preklad

Automatický preklad správ medzi 46 jazykmi pomocou AI-poháňaného prekladového nástroja.

Predpripravené odpovede

Preddefinované šablóny odpovedí s možnosťou rýchleho vloženia pre rýchlejšie odpovede agentov.

Chatovací widget

Widget Live Chat je ľahká, vložiteľná komponenta, ktorú možno pridať na akúkoľvek webovú stránku. Pripája sa k serveru WebSocket Jetweb pre správanie v reálnom čase.

Možnosti prispôsobenia

Nastavenie	Popis	Predvolené
Pozícia	Umiestnenie widgetu na stránke	Vpravo dole
Farba motívu	Primárna farba pre používateľské rozhranie widgetu	#00D4FF
Uvítacia správa	Počiatočný pozdrav zobrazený návštevníkom	Ahoj! Ako vám môžeme pomôcť?
Offline režim	Správanie, keď nie sú k dispozícii žiadni agenti	Zobraziť formulár tiketu

Agent Dashboard

Agent dashboard na adrese agents.jetweb.app poskytuje kompletný rozhranie na správu konverzácií so zákazníkmi, zobrazenie fronty a spoluprácu s členmi tímu.

Funkcie Dashboardu

Fronta konverzácií v reálnom čase s informáciami o návštevníkoch a časoch čakania

Automatické a manuálne smerovanie konverzácií medzi agentmi

Kompletná história konverzácií s možnosťami vyhľadávania a filtrovania

Interný tímový chat pre komunikáciu medzi agentmi

Správa predpripravených odpovedí s kategóriami a skratkami

Základné analýty vrátane časov odozvy a metrík konverzácií

Ticket System

Keď nie sú k dispozícii žiadni agenti, návštevníci môžu vytvoriť support tickets. Tickets sú sledované s aktualizáciami stavu a emailovými notifikáciami.

Stavy Ticketov

Open

Nový ticket čakajúci na odpoveď agenta

In Progress

Agent pracuje na tickete

Resolved

Problém bol vyriešený

Closed

Ticket je uzavretý a archivovaný

WordPress Plugin

Plugin Jetweb Live Chat WordPress integruje chat widget do vášho webu WordPress s jednoduchým procesom nastavenia.

Inštalácia

Stiahnite si plugin z vášho dashboardu Jetweb v sekcii Live Chat > WordPress Plugin.

V WordPress prejdite na Pluginy > Pridať nový > Nahrať plugin a vyberte súbor ZIP.

Po dokončení inštalácie kliknite na Aktivovať.

V administrácii WordPress prejdite na Nastavenia > Jetweb Live Chat.

Zadajte váš API kľúč a token stránky z dashboardu Jetweb.

Nastavenia pluginu

Nastavenie	Popis	Predvolené
API kľúč	Váš API kľúč Jetweb na overenie	Povinné
Token stránky	Jedinečný identifikátor pre váš chat kanál	Povinné
Pozícia widgetu	Pozícia chat widgetu na stránke	Pravý dolný roh
Automatické otvorenie	Automaticky otvorí widget po oneskorení	Vypnuté
Offline tikety	Zobraziť formulár tiketu, keď nie sú k dispozícii žiadni agenti	Povolené

REST API

REST API Live Chat vám umožňuje programovo spravovať konverzácie, odosielať správy a vytvárať tikety. Všetky požiadavky API vyžadujú autentifikáciu prostredníctvom API kľúča.

Začať konverzáciu

                POST /chat/start
                
              

                POST https://livechat.api.jetweb.app/chat/start
Authorization: Bearer YOUR_API_KEY

{
  "site_token": "lc_abc123...",
  "visitor_name": "John",
  "visitor_email": "[email protected]"
}

# Odpoveď
{
  "success": true,
  "conversation_id": "conv_xyz...",
  "socket_url": "wss://livechat.api.jetweb.app"
}
              

Odoslať správu

                POST /chat/message
                
              

                POST https://livechat.api.jetweb.app/chat/message
Authorization: Bearer YOUR_API_KEY

{
  "conversation_id": "conv_xyz...",
  "message": "Hello, I need help with..."
}

# Odpoveď
{
  "success": true,
  "message_id": "msg_abc...",
  "timestamp": "2026-01-15T10:30:00Z"
}
              

Získať konverzácie

                GET /chat/conversations
                
              

                GET https://livechat.api.jetweb.app/chat/conversations?status=active
Authorization: Bearer YOUR_API_KEY

# Odpoveď
{
  "conversations": [
    {
      "id": "conv_xyz...",
      "visitor_name": "John",
      "status": "active",
      "agent": "Agent Smith"
    }
  ]
}
              

Vytvoriť tiket

                POST /tickets
                
              

                POST https://livechat.api.jetweb.app/tickets
Authorization: Bearer YOUR_API_KEY

{
  "site_token": "lc_abc123...",
  "name": "John",
  "email": "[email protected]",
  "subject": "Need help with setup",
  "message": "I am having trouble..."
}

# Odpoveď
{
  "success": true,
  "ticket_id": "TKT-1234",
  "tracking_url": "https://tickets.jetweb.app/TKT-1234"
}
              

Obmedzenia rýchlosti

Obmedzenia rýchlosti API a kvóty plánov pre službu Live Chat.

Plán	Agenti	Súčasné chaty	História chatu
Začiatočník	1	5	30 dní
Pro	5	25	90 dní
Business	Neobmedzene	Neobmedzene	Neobmedzene

Kódy chýb

Kód	Chyba	Popis
400	Nesprávna požiadavka	Neplatné telo požiadavky alebo chýbajúce povinné polia.
401	Neoprávnený	Chýbajúci alebo neplatný API kľúč.
403	Zakázané	API kľúč nemá oprávnenie pre túto akciu.
404	Nenájdené	Konverzácia alebo ticket nebol nájdený.
429	Príliš veľa požiadaviek	Prekročený limit požiadaviek. Skúste znova po uplynutí určeného času.
500	Interná chyba servera	Neočakávaná chyba. Ak pretrváva, kontaktujte podporu.

FAQ

Live Chat používa WebSocket pripojenia cez Socket.io pre okamžité doručenie správ. Widget vytvára trvalé pripojenie k nášmu WebSocket serveru, čo umožňuje správanie v reálnom čase s indikátormi písania a potvrdeniami o doručení.

Správy sú automaticky prekladané medzi jazykom návštevníka a agenta pomocou nášho AI prekladového nástroja. Systém rozpozná jazyk návštevníka z nastavení jeho prehliadača a prekladá správy oboma smermi v reálnom čase.

Keď sú všetci agenti offline, widget sa automaticky prepne do režimu ticketov. Návštevníci môžu odoslať svoju správu ako podporný ticket a agenti budú upozornení e-mailom. Návštevník dostane odkaz na sledovanie ticketu.

Áno! Hoci poskytujeme plugin pre WordPress pre jednoduchú integráciu, chat widget je možné vložiť na akúkoľvek webovú stránku pomocou jednoduchého script tagu. Stačí zahrnúť JavaScript widgetu a nakonfigurovať ho s tokenom vašej stránky.

Live Chat