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ă:

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ă):

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:

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 — site nou cu chatbot inclus în pachet
• Magazin WooCommerce — integrare chatbot cu produse și stoc
• Mentenanță site — suport tehnic continuu pentru WordPress și plugin