Referenca
Odpravljanje težav in pogosta vprašanja
Pogosti problemi in kako jih odpraviti, razvrščeni po tem, kdo se z njimi srečuje. Vsak vnos ponuja konkretno rešitev in povezavo na podrobno dokumentacijo, ko jo potrebujete. Ogradne vrednosti v VELIKIH ČRKAH zamenjajte s svojimi vrednostmi. Produkcijska domena je helpstack.eu.
Agenti in skrbniki#
Član ekipe ne vidi Nastavitev ali ne more spremeniti konfiguracije
Njegova vloga je verjetno AGENT ali VIEWER. Agenti imajo dostop do nastavitev samo za branje, gledalci pa so samo za branje pri pogovorih in analitiki. Prosite OWNER ali ADMIN, da mu spremenijo vlogo. Glejte ../guides/09-team-and-roles.md.
Ne prejemljem obvestil o novih pogovorih
Preverite nastavitve obvestil za dogodek (NEW_CONVERSATION / NEW_MESSAGE / ASSIGNED / STATUS_CHANGED) in kanal (IN_APP, EMAIL, PUSH itd.). Če je obseg ASSIGNED_ONLY, prejemate opozorila samo za pogovore, dodeljene vam — preklopite na ALL, da ste obveščeni o vsem. Glejte ../guides/10-notifications.md.
Pogovor je izginil iz moje mape prejetih
Preverite njegov status. Pogovori se premikajo OPEN → PENDING → CLOSED, vaš filter mape prejetih pa morda skriva CLOSED (ali PENDING) niti. Počistite ali razširite filter statusa. Glejte ../guides/02-conversations.md.
Moja interna opomba je bila poslana stranki
Interne opombe so zasebne za vašo ekipo in nikoli niso dostavljene stranki — če je stranka prejela besedilo, je bilo dodano kot odgovor OUTBOUND, ne kot opomba. Prepričajte se, da uporabljate polje za opombo, ne polje za odgovor. Glejte ../guides/02-conversations.md.
AI in baza znanja#
AI odgovori so generični, nejasni ali napačni
Dve stvari utemeljujeta AI: sistemski poziv in znanje. Najprej napišite jasen sistemski poziv po kanalu, ki določi persono, ton in pravila. Nato priložite ustrezne skupine baze znanja kanalu, da so odgovori utemeljeni v vaši lastni vsebini prek RAG. Brez priloženih skupin KB ima model samo splošno znanje. Glejte ../guides/03-ai-replies.md in ../guides/05-knowledge-base.md.
Možnosti AI odgovorov ni nikjer
Potrebujete vsaj enega konfiguriranega AI ponudnika (OpenAI, Anthropic, Azure OpenAI ali Ollama) z nastavljenim modelom in enega ponudnika, označenega kot privzeti za organizacijo. Dodajte ponudnika v nastavitvah in ga označite kot privzetega. Glejte ../guides/03-ai-replies.md.
Artikel baze znanja je obtičal ali prikazuje napako
Artikli se premikajo PROCESSING → READY/ERROR. Če artikel ostane v PROCESSING, pustite čas za zaključek strganja/nalaganja; če prikazuje ERROR, izvorni URL morda ni dosegljiv ali naložena datoteka ni podprta — znova ga dodajte z veljavnim virom. Za RAG se uporabljajo samo artikli READY. Glejte ../guides/05-knowledge-base.md.
AI prezre mojo bazo znanja
Potrdite, da je skupina baze znanja, ki vsebuje te artike, dejansko priložena kanalu, ki obravnava pogovor, in da so artikli READY (ne PROCESSING/ERROR). Utemeljevanje KB je po kanalu prek priloženih skupin. Glejte ../guides/05-knowledge-base.md.
Žetoni s pogostimi vprašanji se ne prikazujejo v widgetu, a KB izgleda v redu
Pogosta vprašanja in baza znanja sta različni funkciji. Pogosta vprašanja (Vprašanje ≤280 znakov, Odgovor ≤2000 znakov) poganjajo žetone v pozdravnem sporočilu widgeta in morajo biti definirana splošno za organizacijo ali na tem kanalu WEBSITE_CHAT. Baza znanja utemeljuje AI odgovore in ne ustvarja pozdravnih žetonov. Glejte ../guides/06-faqs.md.
Osnutki se nikoli ne pošiljajo sami
Način samodejnega odgovarjanja kanala je verjetno off ali prepare. prepare ustvari osnutek odgovora, a čaka, da ga agent odobri; samo auto-approve pošlje brez pregleda. Nastavite način na auto-approve, če želite pošiljanje brez posredovanja. Glejte ../guides/03-ai-replies.md.
Kanali in sporočanje#
Sporočila Facebook ne prihajajo
Preverite po vrstnem redu:
- Neujemanje žetona za preverjanje — žeton v vaši aplikaciji Facebook se mora natančno ujemati z
FACEBOOK_VERIFY_TOKEN, sicer izziv za preverjanje ne uspe in webhook nikoli ni naročen. - Napaka pri podpisu —
FACEBOOK_APP_SECRETmora biti pravilno nastavljen, da HelpStack lahko potrdi podpis HMAC pri dohodnih koristnih obremenitvah; napačna skrivnost tiho zavrne dogodke. - Naročnina na stran — potrdite, da je stran Facebook naročena na vaš webhook aplikacije z omogočenimi polji za sporočanje.
Glejte ../integrations/webhooks.md.
Sporočila Instagram ali WhatsApp ne prihajajo
Enak kontrolni seznam kot pri Facebooku, z ustreznimi okoljskimi spremenljivkami: INSTAGRAM_VERIFY_TOKEN za Instagram in WHATSAPP_VERIFY_TOKEN za WhatsApp. Potrdite, da se žeton za preverjanje ujema, da je podpis/skrivnost pravilna in da je račun/številka naročena na webhook. Glejte ../integrations/webhooks.md.
Ne najdem možnosti za kanal Telegram
TELEGRAM obstaja v shemi, a še ni na voljo v UI. Uporabite EMAIL, FACEBOOK, INSTAGRAM, WHATSAPP ali WEBSITE_CHAT. Glejte ../guides/04-channels.md.
Widget za spletno stran#
Widget se ne prikazuje na moji strani
Preverite po vrstnem redu:
- CHANNEL_ID —
idv URL-ju skripte mora biti vaš ID kanalaWEBSITE_CHAT:<script src="https://helpstack.eu/widget.js?id=CHANNEL_ID" async></script>. - Seznam dovoljenih domen — domena strani mora biti dovoljena za ta kanal.
- Umestitev skripte — prepričajte se, da je odrezek prisoten v posredovanem HTML (ni ga odstranil upravljalnik oznak ali CSP) in da se naloži.
Glejte ../integrations/widget-embed.md.
Kako odpreti ali zapreti widget s svojim gumbom?
Uporabite programski API: window.ChatWidget.open(), .close(), .toggle() in .init(). Te povežite z upravljalnikom klikanja vašega gumba. Glejte ../integrations/widget-embed.md.
Vračajoči se obiskovalci niso prepoznani
Widget shrani visitorId v brskalnikov localStorage. Če obiskovalci počistijo shrambo, uporabijo zasebni/inkognito način ali zamenjajo brskalnik/napravo, dobijo novo identiteto. Glejte ../integrations/widget-embed.md.
Ali lahko registriram orodje JavaScript po meri v widgetu?
Ne. V widgetu ni JS API-ja za registracijo orodij na strani odjemalca. Orodja agenta na strani odjemalca so definirana v HelpStack kot orodja agenta CLIENT_SIDE in se izvajajo v brskalniku obiskovalca prek widgeta. Glejte ../guides/08-agent-tools.md in tehnično referenco v ../integrations/custom-agent-tools.md.
Webhooks in integracije#
Preverjanje webhooks nenehno ne uspe
Ponudnik med nastavitvijo pošlje izziv, ki mora odjaviti vaš žeton za preverjanje. Prepričajte se, da se žeton, konfiguriran pri ponudniku, natančno ujema z ustrezno okoljsko spremenljivko (FACEBOOK_VERIFY_TOKEN, INSTAGRAM_VERIFY_TOKEN, WHATSAPP_VERIFY_TOKEN). Glejte ../integrations/webhooks.md.
Dohodne webhook zahteve so zavrnjene kot nepooblaščene
HelpStack preveri podpis HMAC pri dohodnih koristnih obremenitvah. Potrdite, da je skrivnost aplikacije (npr. FACEBOOK_APP_SECRET) pravilno nastavljena in da nobena posredniška naprava ne prepiše surovega telesa zahteve preden ga HelpStack prebere — preverjanje podpisa se izvede nad točnimi prejetimi bajti. Glejte ../integrations/webhooks.md.
Ali obstaja API ključ, ki ga lahko uporabim za klicanje API-ja?
Ne. Ni zunanjega sistema z API-ključem. Nadzorna plošča in API uporabljata avtentikacijo seje NextAuth, omejeno na vašo organizacijo. Končne točke widgeta in webhooks so javne, a omejene po hitrosti in preverjene s podpisom. Glejte ../integrations/api-reference.md.
Orodje agenta AI nikoli ne pokliče
Model odloča, ali poklicati orodje, na podlagi njegovega opisa. Preoblikujte opis, da jasno navede, kaj orodje počne in kdaj ga uporabiti, ter zagotovite, da so parametri JSON-Schema natančni. Klici so zabeleženi, zato preverite dnevnik klicev orodja, da ugotovite, ali je bil poskus izveden. Glejte ../guides/08-agent-tools.md za pregled in ../integrations/custom-agent-tools.md za podrobnosti o končni točki, shemi in časovni omejitvi.
E-poštni kanal#
E-pošte se ne uvažajo
Preverite po vrstnem redu:
- Poverilnice IMAP — gostitelj nabiralnika, vrata, uporabniško ime in geslo/geslo aplikacije morajo biti pravilni, račun pa mora dovoljevati dostop prek IMAP.
- Namenski nabiralnik ali zastavica — uporabite namenski nabiralnik (ali konfigurirano zastavico), da HelpStack ve, katera sporočila potegniti, in ne tekmuje z drugim odjemalcem.
EMAIL_MAX_AGE_DAYS— sporočila, starejša od tega okna, so preskočena; povečajte to vrednost, če pričakujete uvoz starejše pošte.
Glejte ../guides/04-channels.md.
Odhodna e-pošta ni dostavljena
Odhodni sistemski mail je odvisen od nastavitev SMTP_*. Potrdite, da so gostitelj SMTP, vrata in poverilnice veljavne in da je vaša domena za pošiljanje pooblaščena za posredovanje. Glejte ../guides/04-channels.md.
Zaračunavanje in žetoni#
Ne morem spremeniti načrta, kupiti dopolnitve ali odpreti zaračunavanja
Dejanja zaračunavanja so na voljo samo OWNER. Prosite lastnika organizacije, da upravlja načrt ali kupi dopolnitev prek portala strank Stripe. Glejte ../guides/12-billing.md.
Zmanjkuje mi žetonov
Poraba se meri v žetonih. Nadgradite načrt (Free / Starter / Growth / Enterprise) ali kupite enkratno dopolnitev. Oboje stori OWNER prek portala strank Stripe. Glejte ../guides/12-billing.md.
Prevajanje#
Prevodi kratkih sporočil so napačni
Kratka sporočila (manj kot 6 besed) podedujejo jezik pogovora namesto neodvisnega zaznavanja, kar lahko napačno označi kratek odgovor, kot sta "ok" ali "hvala". Nastavite rezervni/pričakovani jezik za pogovor, da se kratka sporočila pravilno razrešijo. Glejte ../guides/02-conversations.md.
Obvestila#
Potisna obvestila ne delujejo na mojem iPhoneu
Na iOS spletni push zahteva, da je stran dodana na začetni zaslon (nameščena kot PWA) in odprta prek Safarija — push ne bo deloval iz navadne zavihka Safarija. Dodajte HelpStack na začetni zaslon, odprite od tam in dovolite obvestila. Glejte ../guides/10-notifications.md.