# Chatbot AI

> Plugin WordPress chatbot AI cu RAG, integrare WooCommerce, suport OpenAI, Claude, Gemini. Voice STT/TTS.

# Plugin Chatbot AI WordPress — RAG, integrare WooCommerce și provideri multipli


Plugin WordPress profesional pentru chatbot AI ancorat strict în conținutul site-ului tău prin tehnologia RAG (Retrieval-Augmented Generation). Suport pentru OpenAI (ChatGPT), Anthropic Claude și Google Gemini — alegi tu provider-ul preferat. Integrare nativă cu WooCommerce pentru produse, prețuri, stoc și atribute. Voice input/output prin Web Speech API, widget flotant plus shortcode embedded.


 


## Ce face plugin-ul diferit față de chatbot-urile generice


Majoritatea plugin-urilor de chatbot WordPress sau soluțiilor SaaS au limitări fundamentale pe care le rezolvăm la nivel de arhitectură.


**Tu păstrezi controlul costurilor.** Alegi singur provider-ul AI (OpenAI, Claude, sau Gemini) și plătești direct în contul tău. Vezi exact ce consumi, ai control total. Nu există markup ascuns în prețul nostru.


**RAG real, nu doar prompt simplu.** Sistem complet de embedding și retrieval cu vector search MySQL nativ. Chatbot-ul caută în conținutul tău indexat înainte de a genera răspuns — reducând semnificativ riscul de halucinații.


**Integrare WooCommerce nativă.** Indexează automat produse, prețuri, SKU, stoc, categorii și atribute vizibile. Clientul poate întreba „aveți rochii albastre mărimea M" și primește răspuns bazat pe stocul real, nu generic.


**Voice input/output gratuit prin browser.** Web Speech API e disponibil nativ în browsere moderne. Plugin-ul folosește STT (speech-to-text) și TTS (text-to-speech) fără cost suplimentar pentru tine sau client — nu plătești la ElevenLabs sau Google Cloud TTS separat (decât dacă vrei calitate premium pe Premium).


**Securitate OWASP la nivel de plugin.** Protecție prompt injection prin filtru dedicat, rate limiting per IP, chei API criptate în baza de date sau definite în wp-config.php, sanitizare strict input, hash SHA-256 pentru IP-uri (zero PII în logs).


####  


## Tehnologia RAG explicată — răspunsuri ancorate strict în conținutul tău


RAG (Retrieval-Augmented Generation) e diferența între un chatbot care „inventează" și un asistent care răspunde pe baza informației tale aprobate.


**Cum funcționează concret:**


**Pas 1 — Indexare automată conținut WordPress** La activare, plugin-ul indexează automat: paginile publicate, postările blog, produsele WooCommerce (cu prețuri, stoc, atribute), categoriile și etichetele. Folosește vector search MySQL nativ — nu necesită Pinecone, Weaviate sau alt vector database extern.


**Pas 2 — Embedding inteligent cu task-type optimization** Conținutul tău e împărțit în chunks semantice și transformat în vectori numerici (embeddings). Pentru Gemini, folosim parametrul `task_type=RETRIEVAL_DOCUMENT` la indexare și `RETRIEVAL_QUERY` la căutare — optimizare asimetrică conform documentației Google pentru calitate maximă a căutării.


**Pas 3 — Retrieval semantic la fiecare întrebare** Când utilizatorul pune o întrebare, sistemul caută în chunks-urile indexate cele cu cea mai mare similaritate semantică. Pragul de similaritate e configurabil per provider (default 0.5 pentru Gemini, optimal pe baza testelor).


**Pas 4 — Generare răspuns ancorată în surse** Provider-ul AI primește ca context strict chunks-urile relevante găsite în pasul 3. Generează răspuns bazat pe acel context. Riscul de derivă (răspunsuri în afara conținutului tău) e redus semnificativ.


**Pas 5 — Afișare surse** Plugin-ul afișează utilizatorului care pagini sau produse au generat răspunsul. Transparență totală.


**Reindexare automată la modificări:**




- Hook `save_post` — modificare pagină/postare declanșează reindex

- Hook `edited_term` — modificare categorie/etichetă reindexează postările asociate (cap 50/edit)

- Hook `woocommerce_product_set_stock` — schimbare stoc declanșează reindex

- Hook `woocommerce_variation_set_stock` — variațiile cu stoc nou declanșează reindex pe părinte



Nu trebuie să reindexezi manual când actualizezi conținutul — sistemul se ocupă automat.


####  


## Integrare nativă WooCommerce — produse, stoc, prețuri


Pentru magazinele WooCommerce, plugin-ul oferă integrare nativă completă:


**Indexare produse:**




- Nume produs

- Descriere și descriere scurtă

- Preț (regular + sale)

- SKU

- Stoc curent (in stock, out of stock, on backorder)

- Categorii și etichete

- Atribute vizibile (mărime, culoare, material, etc.)

- Variațiile produsului cu stoc separat



**Funcționalități pentru utilizator:**




- „Aveți rochii albastre mărimea M?" → răspuns cu produse reale, stoc real, preț real

- „Cât costă ochelarii Ray-Ban?" → preț actual din magazin

- „Mai aveți produsul X?" → status stoc instant

- „Ce categorii de produse aveți?" → listă categorii din magazinul tău



**Actualizare automată:** Când schimbi stocul, prețul sau atributele unui produs din admin WooCommerce, indexul chatbot-ului se actualizează automat. Clientul vede mereu informații corecte.


####  


## Cei 3 provideri AI suportați — OpenAI, Claude, Gemini


Plugin-ul suportă 3 dintre cei mai mari provideri AI din lume. Tu alegi care.


**OpenAI (ChatGPT)**




- Modele suportate: GPT-4o, GPT-4o-mini, GPT-4-turbo, GPT-3.5-turbo

- Embedding: text-embedding-3-small, text-embedding-3-large

- Caracteristică: cel mai cunoscut, calitate ridicată generală

- Cost tipic: 0,03-0,06 EUR per conversație medie

- Credite gratuite la înscriere pentru testare



**Anthropic Claude**




- Modele suportate: Claude 3.5 Sonnet, Claude 3.5 Haiku, Claude 3 Opus

- Caracteristică: excelent pe limba română, nuanțe contextuale subtile, conversații lungi

- Cost tipic: 0,01-0,03 EUR per conversație

- Plan gratuit limitat la înscriere



**Google Gemini**




- Modele suportate: Gemini 2.0 Flash, Gemini 2.5 Pro, Gemini 1.5 Pro

- Embedding: gemini-embedding-001 (cu task_type optimization)

- Caracteristică: **cel mai generos plan gratuit** — recomandat pentru testare și volume mici

- Cost tipic: 0,005-0,02 EUR per conversație

- Plan gratuit: ~60 requests/minut, suficient pentru multe site-uri



**Recomandare pricing pe provider:**




- **Testare și site-uri mici**: Gemini (plan gratuit suficient pentru 50-200 conversații/zi)

- **Conversații complexe sau limba română nuanțată**: Claude

- **Cazuri generale**: OpenAI



**Cum se configurează:**




- Mergi la `Chatbot AI > Provideri AI` în admin WordPress

- Introduci cheia API (recomandat: definește-o în `wp-config.php` cu `define('WSCHAT_OPENAI_KEY', 'sk-...');`)

- Apesi „Testează cheia" pentru validare

- Selectezi modelul preferat din dropdown



####  


## Funcționalități widget — voice, teme, descărcare conversație


Widget-ul afișat pe site-ul tău include funcționalități moderne pe ambele versiuni Basic și Premium.


**Voice input (STT — Speech-to-Text)** Utilizatorul apasă butonul microfon, vorbește, mesajul e transcris automat. Folosește Web Speech API nativ în Chrome, Edge, Safari (cu permisiune microfon). Pe Premium: auto-send mesaj după ce încetează vorbirea (configurabil).


**Voice output (TTS — Text-to-Speech)** Chatbot-ul „vorbește" răspunsul cu vocea browserului. Configurabil per utilizator (poate dezactiva).


**Teme light și dark** Switch instant între temă luminoasă și întunecată. Salvat per utilizator în localStorage.


**Descarcă conversația** Utilizatorul poate descărca toată conversația ca fișier text. Util pentru referință personală sau pentru trimitere către echipa ta de suport.


**Resetează conversația** Buton pentru a începe conversație nouă fără a păstra context vechi.


**Afișare surse** Pentru fiecare răspuns generat, plugin-ul afișează care pagini/produse au fost folosite ca sursă. Transparență totală pentru utilizator.


**Widget flotant + shortcode**




- Widget flotant: apare automat ca buton chat pe toate paginile (configurabil să apară doar pe anumite categorii)

- Shortcode embedded: `[wschat_chatbot]` pe orice pagină pentru chat inline (de exemplu, pe pagina de contact)



**Personalizare**




- Nume chatbot personalizabil (pe Basic și Premium)

- Culoare principală cu color picker plus input hex (pe Basic și Premium)

- Logo widget personalizat (doar Premium)

- Eliminare branding „Powered by WebSimplu" (doar Premium)



**Responsive mobile-friendly** Widget-ul se adaptează automat pe mobile, cu interface optimizat pentru ecrane mici.


####  


## Securitate și conformitate GDPR


Plugin-ul implementează best practices OWASP la nivel WordPress profesional.


**Protecție prompt injection** Filtru dedicat care detectează tentative de „jailbreak" — utilizatori care încearcă să modifice comportamentul chatbot-ului prin instrucțiuni ascunse. Sistem prompt cu reguli stricte anti-injection.


**Rate limiting per IP** Default: 20 mesaje/minut, 200/oră per IP. Configurabil din admin. Previne abuz și consum necontrolat al API-ului tău.


**Chei API criptate** Cheile API se stochează criptat în baza de date WordPress. Recomandare: definire în `wp-config.php` pentru securitate maximă:






 

 




php

`define('WSCHAT_OPENAI_KEY', 'sk-...');
define('WSCHAT_CLAUDE_KEY', 'sk-ant-...');
define('WSCHAT_GEMINI_KEY', 'AIza...');`


**Sanitizare input strict** Toate input-urile utilizatorului sunt sanitizate cu funcțiile WordPress native (sanitize_text_field, wp_kses, etc.) plus filtre custom.


**Hash SHA-256 pentru IP-uri** În tabela de logs, IP-urile sunt stocate ca hash SHA-256 — zero PII (Personally Identifiable Information). Conform GDPR cu pseudonimizare.


**Nonce verification REST** Toate endpoint-urile REST API folosesc WordPress nonces pentru protecție CSRF.


**GDPR — opt-in pentru logare conversații** By default, conversațiile nu sunt logate. Utilizatorul poate accepta logarea (pentru îmbunătățire suport) prin consimțământ explicit. Conform Regulament UE 2016/679 (GDPR).


**Politica de retenție configurabilă** Setezi câte zile păstrezi logurile (default 30 zile). Cronjob automat șterge conversațiile mai vechi.


 
## Procesul de instalare în 5 pași


**Pas 1 — Cumpărare și download** Cumperi si primești prin email arhiva ZIP a plugin-ului plus cheia de activare.


**Pas 2 — Upload în WordPress** În admin WordPress: `Plugins > Add New > Upload Plugin`. Selectezi arhiva ZIP. Click „Install Now" apoi „Activate".


**Pas 3 — Configurare provider AI** Navighezi la `Chatbot AI > Provideri AI`. Introduci cheia API pentru provider-ul ales (OpenAI, Claude sau Gemini). Recomandare: definire în `wp-config.php` pentru securitate.


**Pas 4 — Indexare conținut** Mergi la `Chatbot AI > Indexare` și apesi „Reindexează tot". Sistemul procesează automat în fundal toate paginile, postările și produsele WooCommerce. Durează 5-30 minute în funcție de mărimea site-ului.


**Pas 5 — Verificare și go-live** Plugin-ul afișează automat widget flotant pe toate paginile. Testezi din site-ul tău cu câteva întrebări. Ajustezi setări (nume chatbot, culoare, comportament) din `Chatbot AI > Setări`.


**Documentație completă:** disponibilă la `https://websimplu.ro/docs/plugin-chatbot-ai/` cu screenshots și video tutoriale pentru fiecare pas.


####  


## Costurile API pe care le suportă clientul


**Important: tu plătești direct la providerii AI, transparent.**


Estimări realiste pentru cost lunar (la 1.000 conversații/lună):






Provider
Cost mediu/lună
Plan gratuit




**Gemini**
5-20 EUR
Generos — 60 req/min gratuit, suficient pentru ~1.500 conv/zi


**Claude (Haiku/Sonnet)**
10-30 EUR
Limitat la înscriere


**OpenAI (GPT-4o-mini)**
15-40 EUR
$5 credite gratuite la înscriere


**OpenAI (GPT-4o)**
30-60 EUR
Inclus în credite gratuite




**Pentru WooCommerce cu volume mai mari (5.000+ conversații/lună):**




- Gemini: 25-100 EUR/lună (cel mai economic)

- Claude Haiku: 50-150 EUR/lună

- OpenAI GPT-4o-mini: 75-200 EUR/lună



**Pentru voice STT/TTS:**




- Web Speech API (browser): gratuit (inclus în Basic)

- ElevenLabs/Google Cloud TTS premium (opțional pe Premium): 0,02-0,05 EUR per conversație cu voice



**Estimare conservativă lunară**: pentru un site cu volum mediu (500-2.000 conversații), costurile API totale sunt 20-80 EUR/lună la provider. Asta plus prețul one-time al plugin-ului.


**Comparație cu SaaS competitori:**




- Intercom Conversational AI: de la 74 EUR/lună/seat × 12 luni = 888 EUR/an minimum

- HubSpot Conversational AI: de la 800 EUR/lună = 9.600 EUR/an

- Drift: de la 2.500 EUR/lună = 30.000 EUR/an

- Plugin nostru Premium: 1.999 EUR plată unică + 30-80 EUR/lună la providers = mult sub competitori pe termen lung



####  


## Întrebări frecvente


**Pot folosi cheile API gratuit?** Toate cele 3 providere (OpenAI, Claude, Gemini) sunt plătite, dar oferă credite gratuite la înscriere. Gemini are cel mai generos plan gratuit — suficient pentru multe site-uri mici și testare extinsă.


**Cum protejez cheia API?** Recomandăm definirea cheii în `wp-config.php`:






 

 




php

`define('WSCHAT_OPENAI_KEY', 'sk-...');`


Astfel nu apare în baza de date și nu poate fi citită prin alte plugin-uri compromise.


**Suportă WooCommerce?** Da, complet. Indexează produse, prețuri, SKU, stoc, categorii și atribute vizibile. Reindex automat la modificare stoc sau preț.


**Funcționează pe orice versiune WordPress?** Cerințe minime: WordPress 6.4+ și PHP 8.1+. Testat până la WordPress 6.7.


**Pot trece de la Basic la Premium ulterior?** Da. Plătești diferența (1.500 EUR) plus servicii de migrare configurare (incluse gratuit la upgrade în primul an). Datele existente sunt păstrate.


**Cât durează implementarea?** Pe Basic, instalare în sub 30 minute dacă ai cheia API pregătită. Pe Premium cu integrări CRM și multi-channel, 1-3 zile pentru configurare completă.


**Cum gestionez costurile dacă chatbot-ul devine popular?** Rate limiting per IP previne abuz. Plus, în admin ai dashboard cu consum AI real-time. Poți seta budget caps per zi/lună prin provider (toate cele 3 oferă această funcționalitate în dashboard-urile lor).


**Plugin-ul funcționează cu site multi-language WPML?** Pe Basic: limba română. Pe Premium: 6 limbi (română, engleză, germană, franceză, italiană, spaniolă) cu detectare automată. Compatibil WPML și Polylang pentru routing per limbă.


 


#### Soluții complementare


**
**Pentru ecosistemul tău complet:**




- **[Creare site WordPress](https://websimplu.ro/servicii/creare-site-wordpress/)** — site nou cu chatbot inclus în pachet

- **[Magazin WooCommerce](https://websimplu.ro/servicii/magazin-online-woocommerce/)** — integrare chatbot cu produse și stoc

- **[Mentenanță site](https://websimplu.ro/servicii/mentenanta-site/)** — suport tehnic continuu pentru WordPress și plugin

---

Source: https://websimplu.ro/chatbot-ai/
Format: markdown mirror al continutului HTML, pentru AI/LLM extraction si indexare.