NikolicWP Asistent (кратко NWP Asistent) је додатак за WordPress који на сајт ставља облачић за ћаскање са AI асистентом. Посетилац постави питање, додатак изабере делове ваших страница који се тичу питања и пошаље их, заједно са питањем, AI сервису који сте изабрали: Anthropic (Claude), OpenAI (GPT), Google (Gemini) или било ком сервису са OpenAI-компатибилним API-јем. Одговор се прикаже у прозору, а цео разговор остаје на вашем сајту, у администрацији.

Пре прве поруке посетилац оставља мејл адресу (мејл капија), а лимити по адреси, по дану и по разговору држе трошкове познатим. Кључ сервиса је ваш, чува се на вашем серверу и плаћа се по потрошњи.

Ова документација описује верзију 1.0.5 (октобар 2026). Аутор додатка је NikolicWP (https://www.nikolicwp.rs).

Укратко:

• Било који AI сервис: Anthropic (Claude), OpenAI (GPT), Google (Gemini) или други OpenAI-компатибилан API (Mistral, Groq, DeepSeek, OpenRouter, Ollama на сопственом серверу). Ваш кључ, „Провери везу“ и предлози модела.
• Знање из ваших страница: изаберете странице, чланке, производе и документацију; уз свако питање се шаљу само делови који му одговарају, у оквиру буџета. Ништа се не шаље унапред.
• Мејл капија: мејл адреса пре прве поруке, без привремених адреса, по жељи име и код за потврду; регистровани корисници се препознају по адреси.
• Лимити: питања по мејл адреси, по интернет адреси и за цео сајт дневно, по разговору, најдужа порука и пауза између порука.
• Разговори у администрацији: ко је питао, шта, шта је одговорено и колико је коштало; белешке, блокирање адресе, CSV.
• Изглед као и код осталих NikolicWP додатака: Ник, иконица или ваша слика, боје, анимације, текстови, са прегледом уживо; облачић се сам измиче тракама на дну екрана.
• Где се приказује: све странице, почетна, изабране, све осим изабраних или врсте страница; никад у корпи и на плаћању; гости или пријављени; телефони или рачунари.
• Viber, WhatsApp, Telegram, мејл и телефон као дугмад у прозору, по жељи.
• Пречица [nwp_asistent] за ћаскање унутар странице, класа nwp-asistent-open за отварање из менија, филтер nwp_asistent_show.

1. За кога је NikolicWP Asistent

За сваки сајт на коме посетиоци постављају иста питања изнова:

• Продавнице: достава, плаћање, повраћај, величине, рокови, све из ваших страница, без чекања на мејл.
• Сајтови са документацијом или услугама: асистент одговара из упутстава, ценовника и услова, а вама остају само права питања.
• Подршка купцима: регистровани купци се препознају по мејл адреси, а сваки разговор можете да прочитате и наставите мејлом.
• Сајтови који желе AI, али не и непознат рачун: лимити по адреси и по дану, мејл капија и ваш кључ, па је месечни трошак увек познат.

Asistent не захтева кодирање, ради са сваком темом и градитељем страница, на рачунару и телефону.

↑ Садржај

2. Како асистент ради

1. Посетилац кликне на облачић у углу екрана. Ако је мејл капија укључена, остави мејл адресу (и име, ако га тражите) и потврди сагласност.
2. Напише питање. Додатак упореди речи питања са деловима знања (изабране странице и додатни текст) и изабере делове који му најбоље одговарају, у оквиру буџета знакова. Ћирилица и латиница се рачунају као исто писмо.
3. Ваша упутства, изабрани делови знања, последњих неколико порука разговора и питање одлазе AI сервису, са вашим кључем, са вашег сервера.
4. Одговор се прикаже у прозору. Питање, одговор, број токена и време одговора уписују се у разговор који видите у администрацији.
5. Када се достигне неки лимит, посетилац добија љубазну поруку и друге канале (Viber, WhatsApp, мејл), а сервису се ништа не шаље.

Asistent одговара само из знања које сте му дали и ваших упутстава. Када не зна, каже то и упути посетиоца на ваш контакт; не измишља цене, рокове ни могућности. То је намерно: асистент за подршку не сме да обећава.

↑ Садржај

3. Захтеви и инсталација

Инсталација:

1. Додаци → Додај нови → Отпреми додатак → изаберите ZIP фајл који сте преузели из свог налога на nikolicwp.rs → Инсталирај → Укључи.
2. После укључивања отвара се чаробњак за лиценцу. Налепите кључ из налога и потврдите.
3. У менију се појављује NWP Asistent.

Додатак не учитава ништа са других сервера осим позива AI сервису који сте изабрали: једна скрипта и један стил су у самом додатку, без jQuery-ја.

↑ Садржај

4. Лиценца

Asistent почиње да ради када се лиценца активира. Чаробњак за лиценцу се отвара одмах после укључивања додатка; кључ је у вашем налогу на nikolicwp.rs и у мејлу после куповине.

• Док лиценца важи добијате нове верзије (у WordPress-у, као и за остале додатке) и подршку.
• Када истекне, асистент ради као и до тада, са свим подешавањима; без нових верзија и подршке. Обнова их враћа.
• Опозвана лиценца зауставља асистента.
• Селидба сајта на нову адресу не прекида рад; активирајте кључ на новој адреси да бисте даље добијали ажурирања.
• Деактивација на сајту (NWP Asistent → Лиценца → Деактивирај на овом сајту) ослобађа место за други сајт и закључава асистента док се лиценца поново не активира.

Број сајтова зависи од пакета (1, 5 или 10). Локални и тест сајтови (localhost, staging, dev) не троше место.

↑ Садржај

5. Први кораци

Четири корака и асистент одговара:

1. AI сервис: изаберите сервис, налепите API кључ и кликните „Провери везу“. Зелени одговор значи да кључ и модел раде.
2. Знање: изаберите странице из којих асистент учи: документацију, производе, цене, услове доставе и плаћања, честа питања, о нама, контакт. У „Додатно знање“ упишите оно што на страницама не пише (радно време, ко се јавља на телефон).
3. Изглед: аватар, боје и текстови; преглед уживо приказује сваку измену пре чувања.
4. Преглед → Провера: када Ник јави „Све је спремно!“, отворите сајт. Облачић је у углу. Са „Испробај на сајту“ можете га видети и док је искључен за посетиоце.

Препоручена подешавања су већ унета: мејл капија укључена, код за потврду искључен, лимити постављени, корпа и плаћање прескочени.

↑ Садржај

6. Екран додатка

На врху сваке картице је заглавље са иконицом, називом и ознакама: стање асистента (Укључен / Искључен), верзија и лиценца (Лиценца активна / Лиценца истекла / Лиценца није активна).

На свакој картици са подешавањима су дугмад Сачувај измене, Одустани од измена (враћа формулар на сачувано стање) и Врати препоручена подешавања (само за ту картицу). Знак „?“ уз подешавање отвара кратко објашњење. Дугме Освежи поново учитава податке без поновног учитавања странице.

↑ Садржај

7. Преглед: брзи прекидач, преглед уживо и провера

↑ Садржај

8. AI сервис: кључ, модел и упутства

Сервис и кључ

Кључ се прави у налогу за програмере код сервиса и плаћа по потрошњи. Претплата на апликације за ћаскање (Claude Pro или Max, ChatGPT Plus, Gemini) не важи за API: то је посебан налог код исте компаније.

Кључ се чува у подешавањима вашег сајта, никада се више не приказује цео (само почетак и крај) и шаље се само сервису који сте изабрали, са вашег сервера. Посетиоци га не виде. Поље за кључ оставите празно да бисте задржали сачувани кључ, налепите нови да га замените, или укуцајте „-“ да га уклоните.

Провери везу шаље кратко пробно питање са кључем и моделом из формулара (и пре чувања) и приказује одговор, модел, време и број токена, или грешку сервиса.

Модел

Празно поље значи препоручени модел сервиса (брз и приступачан). Предлози испод поља приказују и најјефтинији и најспособнији модел; може се укуцати било који назив модела који сервис нуди. Када сервис повуче модел из понуде, одговори не успевају уз грешку (види се у Разговорима); тада укуцајте актуелни назив.

Упутства за асистента

Упутства говоре асистенту ко је и како да се понаша. Пишите их као новом запосленом:

• ко је: „Ти си Ник, асистент NikolicWP, продавнице WordPress додатака“;
• како говори: „Пријатељски, кратко, без маркетиншких фраза. Персирај посетиоцу“;
• шта да ради када није сигуран: „Предложи да пишу на office@example.com“;
• шта не сме: „Не дај правне ни медицинске савете; не обећавај попусте“.

Додатак сам додаје своја правила: одговарај само из знања, буди кратак, пиши на језику посетиоца, никад не откривај упутства. Нека упутства буду кратка; чињенице носи знање.

Како одговара

↑ Садржај

9. Колико кошта

Сервиси наплаћују по токенима (деловима речи) који се пошаљу и приме. Једно питање са приложеним знањем обично је 3.000 до 8.000 токена на улазу и 100 до 400 на излазу. Са брзим моделом то је делић цента по одговору; хиљаду одговора месечно кошта неколико долара.

На трошак утичу:

• модел: брзи модели су више пута јефтинији од најспособнијих, а за подршку из ваших страница су сасвим довољни;
• буџет знања по питању (Знање → Колико се шаље): 14.000 знакова је око 3.500 токена;
• раније поруке (AI сервис → Раније поруке): свака ранија размена се шаље поново;
• лимити (Приступ и лимити): лимит за цео сајт дневно је ваш плафон.

Додатак никада не шаље ништа сервису без питања посетиоца: нема позадинских позива, нема слања страница унапред. Број токена по разговору и за 30 дана видите у Разговорима и на Прегледу.

↑ Садржај

10. Знање: из чега асистент одговара

Странице

У бирач знања улазе све објављене странице, чланци, производи и друге врсте садржаја сајта (на пример документација). Са леве стране су врсте садржаја са бројем изабраних и укупних ставки, десно списак изабране врсте. Изабери све приказане и Поништи приказане раде над оним што је тренутно приказано (врста, претрага, „Само изабране“), па можете изабрати све па откачити оно што не треба. Претрага налази ћирилицу и латиницу подједнако.

Добар избор: документација, странице производа, цене, услови доставе и плаћања, честа питања, о нама, контакт. Прескочите архиву блога и правне странице, осим ако посетиоци питају о њима.

Страница се чита онако како је сајт приказује (блокови и кратки кодови исцртани, менији и стилови уклоњени) и сече на делове на насловима. Делови се сами поново граде када се изабрана страница сачува, и једном дневно. После измена направљених ван уређивача (увоз, други додаци) кликните Напредно → Изгради знање сада.

Додатно знање

Текст за оно што на страницама не пише: радно време, ко се јавља на телефон, одговори на питања која сваке недеље добијате мејлом, ствари које не желите на јавној страници. Ред који почиње са ## је наслов који дели текст на делове, на пример:

## Radno vreme
Ponedeljak do petak, 9 do 17.

## Dostava
Kurirskom službom, 2 do 4 radna dana.

Колико се шаље

Картица „Знање сада“ приказује колико делова и знакова знање има у овом тренутку.

↑ Садржај

11. Капија: мејл адреса пре прве поруке

Сваки одговор вас кошта. Без капије, бот или докон посетилац може да постави стотине питања. Мејл адреса наводи човека да размисли, омогућава вам да касније прочитате разговор и каже вам ко је питао.

Регистровани корисник сајта који није пријављен препознаје се по адреси: у прозору и у Разговорима има ознаку Регистрован. Пријављени корисник се води под својим налогом.

Осим капије, додатак има поље-мамац за ботове (невидљиво поље које човек не попуњава), временску проверу (формулар послат за мање од две секунде се одбија) и лимит од 10 започетих разговора по интернет адреси дневно.

Када је капија искључена, свако (и ботови) може да ћаска; лимити по адреси и по сајту и даље важе. Избор „Само пријављени корисници“ (Где и када → Ко га види) је најстрожа капија: мејл се не тражи, налог је капија, а посетиоци без налога не виде ни облачић.

↑ Садржај

12. Лимити

Када се лимит достигне, посетилац добија љубазну поруку и друге канале (ако су укључени); сервису се ништа не шаље. Бројачи се ресетују у поноћ (UTC).

Интернет адреса се не чува: чува се само њен хеш, довољан за бројање, не и за препознавање.

Адресе

Чување разговора

Обриши разговоре старије од (дана): разговори се бришу једном дневно после задатог броја дана (препоручено 365; 0 значи заувек). Наведите период у политици приватности.

↑ Садржај

13. Разговори у администрацији

Картица Разговори приказује сваки разговор: мејл адресу и име посетиоца, ознаку Регистрован или Нерегистрован, прво питање, страницу на којој је разговор почео, број порука, токене и последњу активност. Неуспели одговори су означени црвеном ознаком са бројем грешака.

Клик на разговор отвара поруке, као у прозору: питања посетиоца, одговори, токени и време по одговору, а код неуспелог одговора и грешка сервиса (погрешан кључ, потрошено стање, повучен модел). Са десне стране су подаци о посетиоцу (адреса, име, налог на сајту, страница, сервис и модел, језик прегледача, уређај, да ли је адреса потврђена кодом) и радње:

• Белешка: само за вас, шта је урађено, шта треба испратити.
• Затвори разговор: означава разговор као затворен за вас; посетилац може да настави да пише.
• Блокирај адресу: адреса иде у Приступ и лимити → Блокиране адресе и више не може да започне разговор.
• Обриши: разговор са свим порукама, неповратно.

↑ Садржај

14. Изглед: облачић и прозор

Преглед уживо са десне стране прати формулар пре чувања. Дугме „Телефон“ приказује прозор као на телефону (цео екран); „Као посетилац“ приказује прво капију, „Као пријављени корисник“ одмах ћаскање.

Облачић

Прозор

Празна текстуална поља користе преведене подразумеване текстове (на језику сајта). Ник се у прозору појављује само ако га изаберете за аватар; на страницама сајта, у корпи и у мејловима остаје само ваш бренд.

↑ Садржај

15. Где и када се облачић приказује

У уређивачу сваке странице, чланка или производа постоји кутија NikolicWP Asistent са прекидачем „Не приказуј асистента на овој страници“.

Облачић се никад не приказује у уређивачима градитеља страница, у Цустомизер-у, у фидовима ни у REST API-ју.

↑ Садржај

16. Канали: Viber, WhatsApp, Telegram, мејл и телефон

Дугмад у прозору за посетиоце који би радије разговарали са човеком: приказују се пре капије и када се достигне лимит. Попуните само оно што користите.

↑ Садржај

17. Напредно: обликовање, кеш, CSS и дневник

↑ Садржај

18. Ћаскање унутар странице и отварање из менија

• Пречица [nwp_asistent] приказује ћаскање унутар странице (страница „Помоћ“ или „Подршка“), без облачића на тој страници. Висина: [nwp_asistent height="520"].
• Линк са класом nwp-asistent-open (или href="#nwp-asistent") отвара прозор: „Питајте асистента“ у менију или на дугмету.

↑ Садржај

19. Приватност и подаци

Шта се чува на вашем сајту: мејл адреса и име које посетилац да, поруке, страница на којој је разговор почео, хеш интернет адресе (не сама адреса) и назив прегледача. Разговори се чувају у две табеле у бази сајта и бришу после задатог броја дана.

Шта одлази AI сервису: ваша упутства, изабрани делови знања, последњих неколико порука разговора, питање, наслов странице на којој посетилац пита, име посетиоца (ако га је дао) и да ли је регистрован. Мејл адреса посетиоца се не шаље сервису. Сервис обрађује поруке под својим условима.

У прегледачу посетиоца: ознака разговора и унета адреса (да би разговор могао да се настави) и податак да је прозор затворен у овој картици. Ништа од тога не иде трећим странама.

Наведите асистента и сервис у политици приватности, линкујте политику испод капије (Приступ и лимити → Линк ка политици приватности) и поставите период чувања. Сајт на HTTPS-у је препоручен, да мејл адресе путују шифровано.

↑ Садржај

20. Теме, градитељи страница и приступачност

• Ради са сваком темом (тестирано са Blocksy, Astra, Hello Elementor и Twenty Twenty-Five) и са уређивачем блокова, Elementor-ом, Bricks-ом, Диви-јем и другим градитељима; у њиховим уређивачима се не приказује.
• Једна скрипта (без jQuery-ја) и један стил, учитавају се само на страницама где се облачић приказује.
• Облачић се сам измиче тракама за колачиће и другим кутијама фиксираним уз дно екрана, из било ког додатка.
• На телефону прозор заузима цео екран, уз сигурне зоне екрана (safe area).
• Приступачност: облачић и дугмад су права дугмад са описом за читаче екрана, прозор се затвара типком Esc, поруке се најављују читачу екрана, анимације поштују „смањи покрете“.
• Са NikolicWP Pismo цео прозор прати изабрано писмо; поруке посетилаца се не пресловљавају.

↑ Садржај

21. Ажурирање, деактивација и брисање

• Ажурирање: нова верзија се појави у WordPress-у (Контролна табла → Ажурирања) док је лиценца активна. Подешавања и разговори остају.
• Деактивација: облачић нестаје, подешавања и разговори остају.
• Брисање: подешавања, запис о лиценци и разговори остају за каснију инсталацију, осим ако је укључено Напредно → „Обриши све податке када се додатак обрише“. Слика аватара остаје у медијатеци.

↑ Садржај

22. За програмере

Филтери и догађаји

REST API

Руте су под /wp-json/nwp-asistent/v1/: start (почетак разговора, мејл капија), verify (код за потврду), message (питање и одговор), history (раније поруке), а за администраторе test (пробни позив сервиса) и pages (списак садржаја за бирач знања). Разговор се идентификује потписаним токеном; token не открива ништа о посетиоцу.

CSS

Корен .nwp-as, облачић .nwp-as-launch и .nwp-as-bubble, прозор .nwp-as-win, заглавље .nwp-as-head, поруке .nwp-as-msg (--user, --bot), капија .nwp-as-gate. Боје и размаци су CSS променљиве на корену (--nwp-as-color, --nwp-as-accent, --nwp-as-header, --nwp-as-x, --nwp-as-y, --nwp-as-lift).

База

Табеле {prefix}nwp_asistent_conversations и {prefix}nwp_asistent_messages. Подешавања су у опцији nwp_asistent_settings.

↑ Садржај

23. Решавање проблема

„Асистент још није подешен“

Није унет API кључ (или, за други сервис, основна адреса API-ја). Унесите га у AI сервис и кликните „Провери везу“. Администратор у прозору види и дугме које води на ту картицу.

Посетилац добија резервну поруку уместо одговора

Сервис је вратио грешку. Отворите Разговори → разговор: уз неуспели одговор је грешка сервиса. Најчешће: погрешан или истекао кључ, потрошено стање на налогу код сервиса, повучен модел (укуцајте актуелни назив), прекратко чекање. Напредно → дневник грешака бележи последњих 100.

Одговори су нетачни или асистент каже да не зна

Проверите да ли су праве странице изабране у Знању и да ли је буџет довољан; додајте „Додатно знање“ за оно што на страницама не пише. У упутствима реците како да одговара када не зна. Креативност држите на 0 до 3.

Облачић се не види

Проверите брзи прекидач на Прегледу, „Где и када“ (изабране странице, ко га види, уређаји, „Не за администраторе“), кутију на самој страници и „Никад на овим адресама“. „Испробај на сајту“ приказује облачић само вама, без обзира на све.

Облачић покрива траку за колачиће или дугме

Укључите „Измакни изнад трака на дну екрана“ (Изглед). Ако траку не хвата сам, додајте њен CSS селектор у „Други елементи изнад којих да стоји“, или повећајте размак од дна (посебан за телефоне).

Посетилац не добија код за потврду

Мејл иде подешавањима поште вашег сајта. Проверите слање мејла са сајта (SMTP додатак), фасциклу за нежељену пошту и да ли адреса уопште прима мејл. Код се може поново послати после минута.

Регистровани купац није означен као регистрован

Ознака се даје по мејл адреси: адреса коју посетилац унесе мора бити иста као адреса његовог налога на сајту.

Промена се не види на сајту

Испразните кеш сајта (Напредно → укључено пражњење после чувања) и кеш хостинга или CDN-а. Промена странице из знања важи одмах; после увоза или измена ван уређивача кликните „Изгради знање сада“.

Лиценца

„Лиценца није активна“: унесите кључ на картици Лиценца. „Лиценца истекла“: асистент ради, без нових верзија и подршке; обновите у свом налогу. „Опозвана лиценца“: асистент је заустављен; пишите подршци.

↑ Садржај

24. Честа питања

Шта ми треба за асистента?

API кључ сервиса по вашем избору (Anthropic, OpenAI, Google или други компатибилан сервис), који се плаћа по потрошњи. Претплата на апликације за ћаскање, као што су Claude или ChatGPT Plus, не важи за API.

Да ли асистент види мој налог, пројекте или разговоре код сервиса?

Не. API кључ отвара модел без приступа вашем налогу, пројектима и разговорима у апликацијама. Asistent зна само изабране странице, додатни текст и ваша упутства.

Колико кошта?

Са брзим моделом делић цента по одговору; хиљаду одговора месечно кошта неколико долара. Лимити држе дневни трошак познатим (поглавље 9).

Да ли асистент одговара на српском?

Да. Подразумевано одговара на језику којим посетилац пише, и истим писмом (ћирилица или латиница). Claude и GPT модели пишу добар српски.

Да ли се моје странице шаљу сервису унапред?

Не. Странице се читају на вашем серверу; уз свако питање одлазе само делови који му одговарају, заједно са питањем. Ништа се не чува ван вашег сајта.

Шта спречава ботове да троше кредите?

Мејл капија, поље-мамац, временска провера, лимити по адреси, по интернет адреси и по сајту, пауза између порука, најдужа порука и, по жељи, код за потврду адресе.

Могу ли да искључим мејл капију?

Да, али тада свако може да ћаска; лимити и даље важе. За затворени круг купаца изаберите „Само пријављени корисници“ или „Само ови домени“.

Како да асистент помаже само мојим купцима?

Где и када → Ко га види → Само пријављени корисници, или Приступ и лимити → Само ови домени (домен ваше фирме).

Могу ли да користим свој лого уместо Ника?

Да: Изглед → Аватар → Ваша слика (квадратна, најмање 160 × 160 px). Или иконица у боји по избору.

Како да ставим ћаскање на страницу „Подршка“?

Пречица [nwp_asistent] у садржају странице; облачић се на тој страници не приказује.

Како да искључим асистента на једној страници?

У уређивачу те странице, кутија NikolicWP Asistent → „Не приказуј асистента на овој страници“, или адреса у „Никад на овим адресама“.

Да ли ради са WooCommerce-ом?

Да. Корпа и плаћање су прескочени (препоручено), производи могу у знање, а регистровани купци се препознају по адреси.

Да ли ради са Elementor-ом и другим градитељима страница?

Да; у њиховим уређивачима се не приказује.

Могу ли да прочитам шта су посетиоци питали?

Да, сваки разговор је у Разговорима, са порукама, токенима и грешкама; може се преузети као CSV.

Могу ли да наставим разговор са посетиоцем?

Asistent не шаље мејлове посетиоцима; адреса је у разговору, па му пишете мејлом. Белешка у разговору служи да забележите шта је урађено.

Шта се дешава када лиценца истекне?

Asistent ради као и до тада, са свим подешавањима. Без активне лиценце не добијате нове верзије и подршку; обновом их враћате.

На колико сајтова могу да користим лиценцу?

Зависно од пакета: на 1, 5 или 10 сајтова. Локални и тест сајтови не троше место.

↑ Садржај

25. Брза референца

NikolicWP Asistent је производ бренда NikolicWP (nikolicwp.rs). Документација важи за верзију 1.0.5, ажурирано 29. октобра 2026.