Live Chat Документација - Jetweb API референца

Pregled

Jetweb Live Chat pruža kompletnu podršku za korisnike u realnom vremenu za WordPress sajtove. Vidžet za ćaskanje povezuje posetioce sa vašim timom podrške kroz WebSocket poruke sa trenutnim isporukama i indikatorima kucanja.

Sve poruke se automatski prevode između jezika posetioca i agenta koristeći AI prevodjenje. Sistem uključuje potpuno opremljen agent panel, unapred pripremljene odgovore, istoriju razgovora i integrisani sistem tiketa za offline podršku.

Funkcije

Poruke u Realnom Vremenu

WebSocket instant poruke sa indikatorima kucanja i potvrdama isporuke.

Agent Panel

Potpuno opremljen panel sa upravljanjem redovima, rutiranjem razgovora i timskom saradnjom.

Prilagodljiv Vidžet

Ugradljiv vidžet za ćaskanje sa prilagodljivim temama, kontrolom pozicije i optimizacijom za mobilne uređaje.

Sistem Tiketa

Integrisani sistem tiketa za offline poruke sa praćenjem statusa i email obaveštenjima.

AI Translation

Automatski prevod poruka između 46 jezika koristeći AI-powered translation engine.

Canned Responses

Unapred definisani šabloni odgovora sa skraćenicama za brže odgovore agenta.

Chat Widget

The Live Chat widget je lagana, ugradljiva komponenta koja se može dodati na bilo koji vebsajt. Povezuje se sa Jetweb WebSocket serverom za real-time messaging.

Customization Options

Podešavanje	Opis	Podrazumevano
Position	Položaj vidžeta na stranici	Bottom Right
Theme Color	Primarna boja za korisnički interfejs vidžeta	#00D4FF
Welcome Message	Početna poruka dobrodošlice prikazana posetiocima	Hi! How can we help?
Offline Mode	Ponašanje kada nema dostupnih agenata	Show Ticket Form

Kontrolna tabla agenta

Kontrolna tabla agenta na agents.jetweb.app pruža kompletan interfejs za upravljanje razgovorima sa klijentima, pregled reda čekanja i saradnju sa članovima tima.

Funkcije kontrolne table

Red razgovora u realnom vremenu sa informacijama o posetiocima i vremenima čekanja

Automatsko i ručno usmeravanje razgovora između agenata

Kompletna istorija razgovora sa mogućnostima pretrage i filtriranja

Interni timski ćaskanje za komunikaciju između agenata

Upravljanje unapred pripremljenim odgovorima sa kategorijama i prečicama

Osnovna analitika uključujući vremena odgovora i metrike razgovora

Sistem tiketa

Kada nema dostupnih agenata, posetioci mogu kreirati tikete za podršku. Tiketi se prate sa ažuriranjima statusa i obaveštenjima putem e-pošte.

Statusi tiketa

Otvoren

Novi tiket koji čeka odgovor agenta

U toku

Agent radi na tiketu

Rešen

Problem je rešen

Zatvoren

Tiket je zatvoren i arhiviran

WordPress Plugin

Jetweb Live Chat WordPress plugin integriše chat vidžet na vaš WordPress sajt jednostavnim procesom podešavanja.

Instalacija

Preuzmite plugin sa vašeg Jetweb kontrolnog panela u sekciji Live Chat > WordPress Plugin.

U WordPress, idite na Plugins > Add New > Upload Plugin i odaberite ZIP fajl.

Kliknite Activate nakon završetka instalacije.

U WordPress administraciji, idite na Settings > Jetweb Live Chat.

Unesite vaš API key i site token iz Jetweb kontrolnog panela.

Podešavanja plugina

Podešavanje	Opis	Podrazumevano
API Key	Vaš Jetweb API ključ za autentifikaciju	Obavezno
Site Token	Jedinstveni identifikator za vaš chat kanal	Obavezno
Widget Position	Pozicija chat vidžeta na stranici	Доње десно
Аутоматско отварање	Аутоматски отвори виџет након одређеног временског одлагања	Онемогућено
Тикети ван мреже	Прикажи формулар за тикете када оператери нису доступни	Омогућено

REST API

Live Chat REST API вам омогућава програмски управљање разговорима, слање порука и креирање тикета. Сви API захтеви захтевају аутентификацију преко API кључа.

Започни разговор

                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]"
}

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

Пошаљи поруку

                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..."
}

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

Преузми разговоре

                GET /chat/conversations
                
              

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

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

Креирај тикет

                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..."
}

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

Ограничења брзине

Ограничења брзине API-ја и квоте планова за Live Chat услугу.

План	Оператери	Истовремени разговори	Историјат разговора
Početni	1	5	30 dana
Pro	5	25	90 dana
Biznis	Neograničeno	Neograničeno	Neograničeno

Kodovi grešaka

Kod	Greška	Opis
400	Loš zahtev	Nevažeće telo zahteva ili nedostaju obavezna polja.
401	Neovlašćeno	Nedostaje ili je nevažeći API ključ.
403	Zabranjeno	API ključ nema dozvolu za ovu radnju.
404	Nije pronađeno	Razgovor ili tiket nije pronađen.
429	Previše zahteva	Prekoračeno ograničenje brzine. Pokušajte ponovo nakon određenog vremena.
500	Interna greška servera	Neočekivana greška. Kontaktirajte podršku ako se nastavi.

FAQ

Live Chat koristi WebSocket konekcije preko Socket.io za trenutnu isporuku poruka. Widget uspostavlja trajnu vezu sa našim WebSocket serverom, omogućavajući razmenu poruka u realnom vremenu sa indikatorima kucanja i potvrdama isporuke.

Poruke se automatski prevode između jezika posetioca i agenta koristeći naš AI motor za prevođenje. Sistem detektuje jezik posetioca iz podešavanja njihovog pretraživača i prevodi poruke u oba smera u realnom vremenu.

Kada su svi agenti offline, widget automatski prelazi u režim tiketa. Posetioci mogu poslati tiket za podršku sa svojom porukom, i agenti će biti obavešteni putem e-pošte. Posetilac dobija link za praćenje tiketa.

Da! Iako pružamo WordPress plugin za jednostavnu integraciju, chat widget se može ugraditi na bilo koji vebsajt koristeći jednostavnu oznaku skripte. Samo treba da uključite JavaScript widget i konfigurišete ga sa tokenom vašeg sajta.

Live Chat