Referenca
Slovar
Definicije ključnih izrazov in konceptov, ki se uporabljajo v celotnem HelpStack. Vsak vnos je povezan z navodili ali integracisjko dokumentacijo, ki ga podrobneje obravnava.
Agent (vloga)#
Član ekipe z vlogo AGENT. Agenti lahko upravljajo pogovore (odgovarjajo, dodelijo, spremenijo status, dodajo opombe), a imajo dostop samo za branje do nastavitev. Glejte ../guides/09-team-and-roles.md.
Orodje agenta#
Zmogljivost AI po meri, ki jo definirate, da model lahko izvaja dejanja onkraj odgovarjanja. Orodje je bodisi SERVER_SIDE (HelpStack pokliče vaš HTTPS končno točko) ali CLIENT_SIDE (deluje v brskalniku obiskovalca prek widgeta). Vsako orodje ima ime, opis, ki ga LLM prebere, da odloči, kdaj ga poklicati, in parametre JSON-Schema. Orodja se lahko uvozijo iz specifikacije OpenAPI, vsak klic pa se zabeleži. Glejte ../guides/08-agent-tools.md.
AI ponudnik#
Konfigurirana LLM povezava — OpenAI, Anthropic, Azure OpenAI ali Ollama — z nastavitvami modela, temperature in max-tokens. En ponudnik je privzeti za organizacijo; sistemski poziv je nastavljen po kanalu, ne na ponudniku. Glejte ../guides/07-ai-providers.md.
AI odgovor#
AI-ustvarjen osnutek odgovora na dohodno sporočilo. Njegov kontekst vključuje nedavno zgodovino pogovora, prejšnje zaprte pogovore z isto stranko, priložene skupine baze znanja (RAG), sistemski poziv kanala, identifikator stranke in vsa orodja agenta. Osnutek odgovora čaka v čakalni vrsti za odgovor na odobritev agenta, razen če je kanal nastavljen na samodejno odobravanje. Glejte ../guides/03-ai-replies.md.
Dodelitev#
Dejanje prilaganja pogovora določenemu uporabniku, ki postane zanj odgovoren. Obseg obvestil ASSIGNED_ONLY omejuje opozorila na pogovore, dodeljene vam. Glejte ../guides/02-conversations.md.
Samodejni odgovor (način kanala)#
Nastavitev po kanalu, ki nadzoruje, kako AI osnutki odgovorov na dohodna sporočila. Načini: off (brez samodejnega osnutka), prepare (AI samodejno ustvari osnutek, agent odobri pred pošiljanjem) in auto-approve (AI ustvari osnutek in pošlje brez pregleda agenta). Glejte ../guides/03-ai-replies.md.
Kanal#
Priključen vir pogovorov. Vrste: EMAIL, FACEBOOK, INSTAGRAM, WHATSAPP in WEBSITE_CHAT. (TELEGRAM obstaja v shemi, a še ni na voljo v UI.) Glejte ../guides/04-channels.md.
Pogovor#
Nit stranke, ki združuje sporočila znotraj kanala. Pogovor ima status (OPEN → PENDING → CLOSED), je lahko dodeljen uporabniku, nosi interne opombe in ima zaznani jezik. Glejte ../guides/02-conversations.md.
Privzeti ponudnik#
Edini AI ponudnik, označen kot privzeti za organizacijo. Uporablja se za AI odgovore in prevajanje, razen če je preglašen. Glejte ../guides/07-ai-providers.md.
Pogosto vprašanje (FAQ)#
Par vprašanje-odgovor (Vprašanje ≤280 znakov, Odgovor ≤2000 znakov), definiran splošno za organizacijo ali po kanalu WEBSITE_CHAT. Pogosta vprašanja se prikazujejo kot žetoni, na katere je mogoče klikniti, v pozdravnem sporočilu widgeta. Razlikujejo se od baze znanja: pogosta vprašanja poganjajo pozdrav widgeta, medtem ko baza znanja utemeljuje AI odgovore. Glejte ../guides/06-faqs.md.
Podpis HMAC#
Kriptografski podpis, poslan z dohodnimi koristnimi obremenitvami webhook (npr. iz Facebook/Instagram/WhatsApp), ki ga HelpStack preveri, da potrdi pristnost in nespremenjenost zahteve. Glejte ../integrations/webhooks.md.
Mapa prejetih#
Enotni pogled vseh pogovorov na vsakem kanalu, kjer agenti berejo, filtrirajo, dodelujejo in odgovarjajo. Glejte ../guides/02-conversations.md.
Interna opomba#
Zasebni komentar, dodan k pogovoru samo za vašo ekipo. Opombe nikoli niso dostavljene stranki. Glejte ../guides/02-conversations.md.
Baza znanja#
Zbirka člankov, ki se uporabljajo za utemeljitev AI odgovorov prek RAG. Članki so MANUAL, URL-strgani ali FILE-naloženi, in prehajajo skozi statuse PROCESSING → READY/ERROR. Članki so organizirani v skupiny, ki jih priložite kanalom. Glejte ../guides/05-knowledge-base.md.
Skupina baze znanja#
Poimenovan nabor člankov baze znanja. Prilaganje skupine kanalu naredi te članke na voljo AI-ju kot kontekst RAG za odgovore tega kanala. Glejte ../guides/05-knowledge-base.md.
Sporočilo#
Posamezno sporočilo v pogovoru. Smer je INBOUND (od stranke) ali OUTBOUND (od vas). Sporočilo lahko nosi translatedContent in AI-ustvarjen osnutek, ki čaka na odobritev. Glejte ../guides/02-conversations.md.
Obvestila#
Opozorila za dogodke NEW_CONVERSATION, NEW_MESSAGE, ASSIGNED in STATUS_CHANGED, dostavljena prek IN_APP, PUSH, EMAIL, SLACK, TEAMS, SMS, WEBHOOK ali DISCORD. Vsak dogodek ima preklop po kanalu in obseg (ALL ali ASSIGNED_ONLY). Glejte ../guides/10-notifications.md.
Organizacija#
Koren najemnika. Vsak podatek — kanali, pogovori, uporabniki, ponudniki — je omejen na organizacijo. Uporabniki pripadajo eni organizaciji z vlogo. Glejte ../guides/01-getting-started.md.
RAG (Retrieval-Augmented Generation)#
Tehnika pridobivanja ustreznih člankov baze znanja in njihovega posredovanja LLM-u, da so AI odgovori utemeljeni v vaši lastni vsebini in ne v splošnem znanju modela. Glejte ../guides/05-knowledge-base.md.
ResponseQueue#
Čakalna vrsta, ki hrani AI-ustvarjene odgovore, ki čakajo na odobritev agenta. Ko je kanal nastavljen na samodejno odobravanje, osnutki preskočijo čakalno vrsto in se pošljejo samodejno. Glejte ../guides/03-ai-replies.md.
Vloga#
Raven dovoljenj uporabnika znotraj organizacije: OWNER (poln dostop plus zaračunavanje), ADMIN (poln dostop brez dejanj zaračunavanja), AGENT (upravljanje pogovorov, nastavitve samo za branje) ali VIEWER (pogovori in analitika samo za branje). Na ravni platforme obstaja SUPERADMIN za osebje HelpStack. Glejte ../guides/09-team-and-roles.md.
Obseg (ALL / ASSIGNED_ONLY)#
Nastavitev obvestil, ki nadzoruje, kateri pogovori sprožijo opozorila. ALL obvesti ob vsakem ujemajočem se dogodku v organizaciji; ASSIGNED_ONLY obvesti samo za pogovore, dodeljene vam. Glejte ../guides/10-notifications.md.
Sistemski poziv#
Navodila po kanalu, ki oblikujejo ton, persono in pravila AI-ja pri ustvarjanju odgovorov za ta kanal. Nastavljeno na kanalu, ne na AI ponudniku. Glejte ../guides/03-ai-replies.md.
Dopolnitev#
Enkratni nakup dodatnih žetonov, ločen od ponavljajočega se načrta. Kot vsa dejanja zaračunavanja so dopolnitve na voljo samo OWNER. Glejte ../guides/12-billing.md.
Prevajanje#
Samodejno ravnanje z jezikom: HelpStack zazna jezik stranke, prevede dohodna sporočila v jezik agenta in odhodna sporočila v jezik stranke. Kratka sporočila (manj kot 6 besed) podedujejo jezik pogovora. Izvedeno interno prek OpenAI/Anthropic in/ali Google Cloud Translation. Glejte ../guides/02-conversations.md.
VisitorId#
Edinstveni identifikator, ki ga widget ohrani v brskalnikovem localStorage, da prepozna vračajočega se obiskovalca spletnega mesta prek sej. Glejte ../integrations/widget-embed.md.
Žeton za preverjanje#
Skupna skrivnost, ki se uporablja med nastavitvijo webhook platforme (Facebook, Instagram, WhatsApp), da potrdi, da HelpStack lastniši končno točko, ko ponudnik pošlje izziv za preverjanje. Nastavljeno prek okoljskih spremenljivk, kot so FACEBOOK_VERIFY_TOKEN, WHATSAPP_VERIFY_TOKEN in INSTAGRAM_VERIFY_TOKEN. Glejte ../integrations/webhooks.md.
Widget#
Vgradljivi spletni klepet, naložen z <script src="https://helpstack.eu/widget.js?id=CHANNEL_ID" async></script>. Ohrani visitorId v localStorage, komunicira v realnem času prek Socket.IO in izpostavi programski nadzor prek window.ChatWidget.{init, open, close, toggle}. Ni JS API-ja za registracijo orodij na strani odjemalca. Glejte ../integrations/widget-embed.md.