Widget de chat #

Ghid de integrare a widgetului de chat pe site #

Adăugați un widget de chat ușor de utilizat pe site-ul dvs., care permite vizitatorilor să comunice direct prin interfața site-ului. Procesul de integrare este simplu și va oferi site-ului dvs. capabilități de mesagerie integrate.

Crearea și configurarea widgetului de chat #

Cum ajungi acolo:

1. Dă clic pe Setări (Settings) în partea de jos a barei laterale din stânga. (Pe telefon, atinge mai întâi pictograma de meniu ☰ din colțul de sus pentru a deschide bara laterală.)
2. În coloana din stânga a setărilor, sub Canale (Channels), dă clic pe Canale (Channels).
3. Găsește cardul Widget de chat pentru site-ul web (Website chat widget).
4. Dacă nu ai încă un widget, dă clic pe Conectare (Connect) pentru a crea unul cu un nume de afișare și un mesaj de bun venit.
5. Odată creat, dă clic pe Gestionare (Manage) oricând pentru a deschide panoul complet de configurare.

Modificările pe care le salvezi se aplică automat widgetului tău activ — nu este nevoie să lipești din nou codul de instalare după efectuarea unei modificări.

O Previzualizare live se află chiar lângă setări: o pagină web demonstrativă cu widgetul tău real rulând pe ea, afișându-ți culorile, poziția, logo-ul, pictograma de lansare și fereastra pop-up proactivă exact așa cum le vor vedea vizitatorii. Aceasta urmărește modificările pe măsură ce le faci, deci nu trebuie să salvezi pentru a vedea cum arată o schimbare de culoare sau de temă. Poți chiar să dai clic pe butonul de chat din interiorul previzualizării pentru a deschide widgetul și a-l testa.

Ce poți personaliza #

Panoul de gestionare este organizat în patru secțiuni.

Aspect #

• Temă de stil: Restilizează întregul widget dintr-un singur clic. Șase teme stabilesc aspectul, culorile, colțurile și fontul împreună: Classic (aspectul solid original — o bară de antet colorată pe un panou plat), Glass (un panou mat, translucid, care estompează ușor pagina din spatele său, cu antetul și caseta de mesaje plutind ca niște carduri rotunjite în interior), Midnight (Glass în culori închise), Bloom (roz pal, extra-rotunjit), Ember (Glass portocaliu cald) și Mono (alb-negru, colțuri ascuțite). O temă este un punct de plecare — după ce alegi una, poți schimba în continuare orice culoare sau setare individual. Widgeturile noi pornesc cu Glass; comutarea este instantanee peste tot unde widgetul este încorporat, fără modificări de cod pe site-ul tău.
• Colțuri și font: Două setări de stil independente. Colțuri stabilește cât de rotunjite sunt panoul, bulele și butoanele (Rotunjit, Moale sau Ascuțit), iar Font alege tipul de caractere pe care îl văd vizitatorii (Implicit, Serif, Rotunjit sau Mono) — fonturile provin din cele deja existente pe dispozitivul vizitatorului, deci nu se încarcă nimic suplimentar pe site-ul tău.
• Nume afișat: Afișat în antetul widgetului.
• Logo: Încarcă o imagine care apare în partea de sus a chatului. Folosește logo-ul companiei tale sau o fotografie prietenoasă.
• Pictogramă lansator: Pictograma de pe butonul plutitor de chat. Alege una dintre pictogramele încorporate (bulă de chat, avion de hârtie, semn de întrebare și altele), refolosește logo-ul încărcat sau încarcă o imagine separată — util dacă dorești o fotografie a unui membru real al echipei care întâmpină vizitatorii.
• Culori: Cinci culori, fiecare denumind partea din widget pe care o colorează. Culoarea mărcii este pentru butonul plutitor, antet și propriile mesaje ale vizitatorului, cu Textul mărcii pentru textul care stă deasupra acestuia. Bula botului este fundalul răspunsurilor botului tău și al indicatorului de scriere, cu Textul bulei botului pentru cuvintele din interiorul acestora și punctele animate de scriere. Fereastra de chat este panoul din spatele tuturor mesajelor. Alege o culoare pentru bula botului care să fie clar diferită de culoarea mărcii tale — dacă cele două se potrivesc, ambele părți ale conversației vor avea aceeași culoare și vizitatorii nu vor putea distinge răspunsurile botului de ale lor. O bulă de bot gri deschis cu text închis lângă culoarea mărcii tale este combinația sigură.
• Poziție: Plasează butonul plutitor de chat în colțul dreapta-jos sau stânga-jos, cu decalaj orizontal și vertical (în pixeli) dacă se suprapune peste altceva pe pagina ta.
• Întrebări de început: Sugestii de răspuns rapid (jetoane pe care se poate da clic) afișate în chat, astfel încât vizitatorii să poată începe cu o singură atingere în loc să tasteze — de exemplu „Care sunt prețurile voastre?” sau „Oferiți asistență?” — până la 10.
• Linie de subsol: O mică linie opțională cu propriul tău text sub caseta de mesaje, de exemplu „Powered by Your Agency”. Este dezactivată implicit și nu se afișează nimic sub caseta de mesaje cât timp este oprită. Activează-o, scrie textul (până la 40 de caractere) și, dacă dorești, adaugă un link care începe cu https://; vizitatorii care dau clic pe text deschid acea pagină într-o filă nouă. Agențiile o folosesc pentru a-și pune propriul nume pe widgeturile pe care le creează pentru clienți.

Comportament #

• Mesaj de întâmpinare: Primul mesaj pe care îl văd vizitatorii când deschid chatul (de exemplu, „Cu ce vă pot ajuta?”).
• Sunet: Redă un sunet când sosește un mesaj nou în chat.
• Solicită permisiunea pentru notificări: Solicită opțional vizitatorilor să permită notificările din browser, astfel încât să fie alertați cu privire la răspunsuri chiar și atunci când au schimbat tab-urile.
• Balon pop-up proactiv: Un mic balon opțional care apare lângă butonul de chat pentru a invita utilizatorii. Activează-l pentru a seta mesajul acestuia, textul butoanelor de acceptare/respingere și numărul de secunde de așteptare înainte ca acesta să apară. Balonul se închide singur după 20 de secunde dacă vizitatorul nu dă clic pe el. Acesta este singurul text pe care widgetul îl afișează lângă butonul de chat: nu există nicio setare pentru o etichetă permanentă lângă buton.
• Viteza de răspuns AI: Un glisor între Mai lent (mai uman — AI-ul ia o pauză înainte de a răspunde) și Viteză maximă (mai robotic — răspunsurile vin cât mai rapid posibil). Echilibrat se află la mijloc. Primul mesaj al unui răspuns sosește cu întârzierea setată de glisor, indicatorul de scriere apărând cu puțin timp înainte.
• Afișează o notă de ocupat în timp ce AI-ul lucrează: Dezactivat implicit. Când un răspuns durează mai mult de câteva secunde, de exemplu pentru că agentul tău caută ceva într-un alt sistem, vizitatorii văd un scurt rând lângă punctele de scriere: „Lucrez la răspunsul tău” după 5 secunde, „Caut asta pentru tine” după 15, apoi „Încă lucrez la asta, aproape gata” și scuze pentru așteptare dacă durează mai mult. Răspunsurile rapide afișează în continuare doar punctele. Rândul respectă limba widgetului și apare doar în timp ce AI-ul tău lucrează efectiv la un răspuns, niciodată când AI-ul este oprit pentru acel chat sau când o persoană a preluat conversația.

Limbi #

Widgetul este multilingv în mod nativ — nu trebuie să activați nimic.

• Alege automat limba vizitatorului. Mai întâi verifică limba pe care pagina ta o declară în HTML (<html lang="it">), apoi revine la limba browserului vizitatorului. Dacă niciuna nu este o limbă pe care o acceptăm, etichetele widgetului vor fi afișate în limba în care ai scris mesajul de întâmpinare, iar mesajul de întâmpinare, fereastra pop-up și întrebările de început vor apărea exact așa cum le-ai scris.

• O limbă a paginii care contrazice salutul tău nu este luată în considerare. Unii constructori de site-uri pun lang="en" pe fiecare pagină, indiferent de limba site-ului. Când pagina declară o limbă, iar tu ai scris mesajul de întâmpinare în alta, widgetul tratează valoarea paginii ca pe o setare implicită a constructorului: urmează limba browserului vizitatorului, iar dacă aceasta nu este o limbă pe care o acceptăm, folosește limba în care ai scris. O pagină care își schimbă valoarea lang atunci când vizitatorul alege o limbă pe site-ul tău este întotdeauna urmată. Dacă preferi să nu depinzi de acest lucru, fixează limba în secțiunea Comportament.

• Sau alege una singură. Câmpul Limba widgetului din secțiunea Comportament este setat implicit pe Auto, ceea ce reprezintă detectarea menționată mai sus. Alege o limbă acolo și etichetele widgetului (câmpurile Prenume, Email și Telefon din formularul vizitatorului și textul lor exemplificativ, notificarea de confidențialitate, butoanele) vor rămâne în acea limbă, indiferent de ceea ce indică pagina sau browserul. Folosește această opțiune atunci când constructorul site-ului tău nu declară limba corectă sau când dorești o limbă fixă pentru fiecare vizitator.

• Limbi acceptate: engleză, olandeză, germană, franceză, spaniolă, italiană, portugheză, română, poloneză, arabă, finlandeză, filipineză, slovenă, thailandeză, bengaleză, japoneză, norvegiană (Bokmål) și turcă. Aceasta este lista pentru butoanele și etichetele widgetului.

• Limbile scrise de la dreapta la stânga sunt afișate corespunzător. Pentru vizitatorii care folosesc araba, ebraica, persana și urdu, întreaga fereastră de chat se oglindește: antetul, bulele de mesaj, punctele de scriere, formularul vizitatorului și caseta de mesaje încep toate din dreapta. Butonul bulei rămâne în colțul ales de tine. Vizitatorii care folosesc ebraica, persana și urdu văd etichetele în engleză (sau în limba pe care ai fixat-o), dar aspectul urmează totuși limba lor. Un mesaj scris într-o direcție diferită, cum ar fi un răspuns în engleză într-un chat în arabă, se citește în continuare în ordinea corectă.

• Mesajele tale sunt traduse pentru tine. De fiecare dată când salvezi, mesajul de întâmpinare, fereastra pop-up proactivă și întrebările de început sunt traduse în toate cele optsprezece limbi de mai sus. Le scrii o singură dată, în orice limbă preferi: limba în care ai scris este recunoscută din textul propriu-zis, acea versiune este păstrată cuvânt cu cuvânt, iar fiecare altă limbă este o traducere a acesteia. Nu contează în ce limbă este setat contul tău.

• Scrie propria versiune pentru o limbă. Secțiunea Traduceri din panoul Gestionare, chiar sub Comportament, îți permite să înlocuiești traducerea automată cu propriile formulări, de exemplu spaniola formală („usted”) acolo unde traducerea automată este informală. Alege o limbă sub Limbă, apoi completează oricare dintre următoarele: Mesaj de întâmpinare, Mesaj pop-up, Text acceptare și Text refuz pentru pop-up (afișate în timp ce bula pop-up este activă) și Întrebări de început. Fiecare câmp afișează traducerea automată cu gri; Începe de la traducerea automată o copiază pentru a putea edita de acolo. Orice lași necompletat păstrează traducerea automată. Limbile pe care le-ai scris tu sunt listate primele, marcate cu Propria ta formulare, iar Elimină formularea mea (limbă) revine la traducerea automată pentru acea limbă. Formularea ta este păstrată atunci când editezi ulterior textul original; doar traducerile automate sunt refăcute.

• Butoanele pop-up sunt și ele traduse. Butoanele Acceptare și Refuz ale bulei pop-up proactive sunt traduse împreună cu celelalte mesaje ale tale, astfel încât un vizitator spaniol nu mai vede butoane în engleză.

• Scrie fiecare mesaj într-o singură limbă. Dacă pui două limbi în același câmp — de exemplu, un rând în engleză și unul în italiană — totul este tratat ca un singur mesaj și tradus ca atare, astfel încât un vizitator italian va ajunge să vadă aceeași propoziție de două ori. Scrie-l o singură dată, în orice limbă preferi.

• AI-ul răspunde în limba vizitatorului. Indiferent de limba în care scrie cineva, agentul tău răspunde în aceeași limbă, indiferent de limba în care sunt afișate etichetele widgetului. Dacă preferi ca acesta să răspundă întotdeauna într-o limbă fixă, specifică acest lucru în instrucțiunile agentului tău.

• Setează limba per pagină în codul de încorporare. Rulezi un widget pe un site în engleză și o copie tradusă a acestuia? Adaugă data-lang la eticheta script a widgetului pe fiecare pagină. data-lang="es" afișează widgetul în spaniolă pe acea pagină, indiferent de ceea ce spune browserul; data-lang="page" îl face să urmeze propria valoare <html lang="..."> a paginii (deci lang="es-MX" oferă spaniola), chiar și atunci când mesajul tău de întâmpinare este scris în altă limbă. Aceasta prevalează asupra câmpului Limba widgetului, care la rândul său prevalează asupra detecției automate. De exemplu:

<script src="https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID" data-lang="page" defer></script>

Păstrează codul de încorporare din panoul Gestionare așa cum este și adaugă doar atributul data-lang. Pentru un panou de chat inline, pune data-lang pe <div data-chat-widget="…"> în schimb.

Sfat: dacă site-ul dvs. nu setează un atribut lang pe eticheta <html>, adăugați unul. Este cel mai puternic semnal pe care îl avem pentru a alege limba corectă, în special pentru vizitatorii care navighează din străinătate.

Captarea de lead-uri și confidențialitate #

• Colectare informații vizitator: Dezactivat implicit. Când este activat, vizitatorilor li se cere numele și adresa de e-mail (și opțional numărul de telefon) înainte de începerea conversației, astfel încât să poți captura lead-ul chiar dacă aceștia părăsesc chatul la mijloc.
• Titlu formular și Subtitlu formular: Personalizează titlul și scurta explicație afișate deasupra formularului.
• Colectare număr de telefon: Activează pentru a solicita și un număr de telefon; dezactivat colectează doar numele și adresa de e-mail.
• Colectare nume de familie: Dezactivat implicit. Activează pentru a adăuga un câmp obligatoriu Nume de familie imediat după Prenume. Acesta este salvat în contact ca nume de familie, astfel încât AI-ul tău și orice caută acesta în propriile sisteme să aibă numele complet încă de la primul mesaj. Vizitatorilor care au completat deja formularul înainte de a activa această opțiune nu li se va mai cere din nou.
• E-mailuri cu răspunsuri necitite către vizitatori: un vizitator care a lăsat o adresă de e-mail și nu a văzut răspunsul tău după 15 minute primește un e-mail care îl direcționează înapoi către chat. Dezactivează din Setări → Notificări → Vizitatori widget chat. Vezi E-mailuri către vizitatorii widgetului de chat.

Un vizitator a lăsat un număr de telefon și a părăsit site-ul — pot continua pe WhatsApp? Da. Deschide conversația acestuia și alege Continuă pe WhatsApp din meniul cu trei puncte (WhatsApp Web sau WhatsApp Business trebuie să fie conectat). Your AI Connector creează o conversație WhatsApp legată pentru aceeași persoană, copiază numele, adresa de e-mail și detaliile acesteia, iar AI-ul preia ceea ce a spus pe site-ul tău, astfel încât nimeni nu trebuie să repete informațiile. Chat-ul de pe site rămâne unde este, iar ambele conversații indică una către cealaltă în secțiunea Conversații legate din panoul de contact. Vezi Interfața de chat.

Un vizitator și-a lăsat adresa de e-mail, dar nu a finalizat nicio rezervare — pot să îi trimit un e-mail de follow-up? Da, folosind o automatizare. Un pas de Creare contact cu Canal setat pe E-mail transformă adresa lăsată de vizitator într-un contact de e-mail pe Canalul de e-mail conectat, iar un pas de Trimitere mesaj ulterior va trimite e-mailul; răspunsurile vor ajunge în Chat-uri pentru agentul tău de e-mail. Rețeta completă, inclusiv modul de a opri secvența odată ce aceștia confirmă rezervarea, se află în Automatizări → Exemplu: e-mailuri de follow-up pentru lead-urile din chat-ul site-ului.

Poate agentul AI să ofere singur trecerea la WhatsApp? Da, și nu are nevoie de nicio funcționalitate suplimentară — un singur rând în instrucțiunile agentului este suficient. Creează un Link scurt pentru numărul tău de WhatsApp cu un mesaj precompletat, cum ar fi „Bună, discutam pe site-ul vostru și aș dori să continuăm aici”, apoi spune-i agentului când să îl trimită, de exemplu: „Dacă vizitatorul trebuie să plece, dorește să continue mai târziu sau întreabă de WhatsApp, oferă-te să continuați acolo și trimite acest link: (link-ul tău scurt)”. Link-urile din widget pot fi accesate prin atingere, astfel încât vizitatorul ajunge pe WhatsApp cu numărul tău selectat și mesajul deja scris, iar primul său mesaj deschide o conversație WhatsApp în căsuța ta de primire. Dacă vizitatorul a lăsat numărul de telefon de pe care scrie (cu prefixul țării) în formularul widget-ului, Your AI Connector leagă automat cele două conversații, iar AI-ul de pe WhatsApp cunoaște deja chat-ul de pe site, exact ca în cazul Continuă pe WhatsApp. Dacă nu a fost colectat niciun număr de telefon, cele două chat-uri nu sunt legate, așa că asigură-te că mesajul precompletat este suficient de specific pentru ca agentul de pe WhatsApp să știe de unde provine persoana respectivă.

• Solicită acceptarea politicii de confidențialitate: Opțional, solicită vizitatorilor să accepte politica ta de confidențialitate înainte de a începe chat-ul și setează URL-ul către care trimite aceasta.

Ce stochează widgetul în browserul unui vizitator și trebuie să îl plasez în spatele unui banner de cookie-uri? Nu se stochează nimic doar prin încărcarea unei pagini. Widgetul nu scrie niciun cookie și nu utilizează stocarea în browser până când vizitatorul alege să inițieze o conversație: trimite un prim mesaj, completează formularul cu informații despre vizitator sau acceptă politica de confidențialitate. Din acel moment, acesta păstrează un ID de conversație aleatoriu și o copie a conversației în browserul respectiv, ca stocare proprie (first-party) pe domeniul dumneavoastră, astfel încât chatul să fie disponibil atunci când vizitatorul revine. Acesta nu încarcă scripturi de analiză sau de urmărire și nu setează cookie-uri de la terți. Deoarece nu se scrie nimic până când vizitatorul nu solicită chatul, acesta se încadrează în categoria stocării strict necesare pentru un serviciu solicitat de vizitator, deci îl puteți încărca fără a-l restricționa în spatele unui banner de consimțământ. Dacă site-ul dumneavoastră utilizează oricum un instrument de consimțământ, este în regulă să păstrați widgetul în spatele acestuia; chatul va apărea pur și simplu odată ce vizitatorul își dă acceptul.

Canale și încorporare #

• Buton atașament: Permite vizitatorilor să trimită imagini și fișiere în chat.
• Selector de emoji: Adaugă un selector de emoji lângă căsuța de mesaje.
• Linkuri către canale: Includeți opțional linkuri către WhatsApp, Instagram sau Messenger, astfel încât vizitatorii să poată continua conversația pe platforma preferată. Acestea apar doar după ce ați conectat un număr de WhatsApp (WhatsApp Business sau WhatsApp Web), Instagram sau Messenger. Activarea linkului WhatsApp completează automat numărul conectat; linkul rămâne editabil, așa că după ce schimbați numerele, îl puteți introduce pe cel nou acolo.
• Butoane de acțiune: Un rând de comenzi rapide în partea de sus a chatului care direcționează vizitatorul către o altă destinație în loc de o conversație — consultați Butoane de acțiune mai jos.
• Listă albă de domenii: Restricționați site-urile web care au permisiunea de a încorpora widgetul dvs. Adăugați domeniile unde l-ați instalat (de exemplu, example.com sau *.example.com); lăsați gol pentru a permite orice domeniu.
• Țări blocate: Împiedicați afișarea widgetului pentru vizitatorii din țările pe care nu le deserviți. Vizitatorii a căror locație de rețea se află într-o țară selectată de dvs. nu vor vedea niciodată widgetul, iar orice chat pe care încearcă să îl inițieze va fi refuzat. Lăsați gol pentru a permite accesul tuturor. Consultați Blocarea boților și a consumului inutil de credite mai jos.
• Direcționează aceste chaturi către: Alegeți agentul care ar trebui să gestioneze chaturile provenite din codul pe care urmează să îl copiați. Lăsați setat pe Implicit cont pentru a utiliza rutarea obișnuită a widgetului de chat. Consultați Trimiteți pagini diferite către agenți diferiți mai jos.
• Fragment de încorporare: Alegeți Bulă plutitoare sau În linie și copiați codul de instalare (consultați mai jos).
• Link demo client: Lipiți orice adresă de site web și faceți clic pe Creează link pentru a obține un link partajabil care deschide acel site cu widgetul dvs. rulând deasupra, fără a fi nevoie de instalare din partea lor. Fiecare link creat de dvs. este listat și puteți dezactiva oricare dintre ele. Consultați Afișați widgetul pe site-ul altcuiva mai jos.
• Link de partajare: Un link gata de utilizare care deschide asistentul dvs. pe o pagină proprie, pe tot ecranul, fără a fi nevoie de un site web. Copiați-l și trimiteți-l oriunde. Consultați Partajați un link direct către chat mai jos.

În partea de jos a panoului, o acțiune de Ștergere widget de chat elimină widgetul de pe site-ul tău imediat — acest lucru nu poate fi anulat, iar vizitatorii nu vor mai vedea balonul de chat.

Butoane de acțiune #

Unii vizitatori nu doresc să chat-uiască. Ei vor numărul dvs. de telefon, adresa sau adresa de e-mail și vor acest lucru printr-o singură atingere. Butoanele de acțiune reprezintă un rând de scurtături în partea de sus a panoului de chat exact pentru acest lucru.

Adăugați până la șase. Fiecare are o etichetă (cuvintele de pe buton) și o destinație, iar destinația depinde de acțiunea pe care o alegeți:

Aceste butoane nu consumă credite. Atingerea unuia nu trimite un mesaj și nu începe o conversație — doar direcționează vizitatorul acolo unde a solicitat. Doar o conversație reală cu agentul dvs. AI consumă credite, exact ca până acum.

Câteva lucruri care merită știute:

• Butoanele rămân vizibile în timp ce vizitatorul chat-uiește. Cineva poate pune două întrebări și tot poate atinge Direcții ulterior, fără a reîncărca pagina.
• Etichetele dvs. sunt afișate exact așa cum le-ați scris. Spre deosebire de mesajul de întâmpinare și întrebările de început, etichetele butoanelor nu sunt traduse automat, așa că, dacă serviți vizitatori în mai multe limbi, păstrați etichetele scurte și evidente (sau scrieți-le în limba principală).
• Completați corect un buton, altfel nu se va salva. Dacă un număr de telefon, o adresă de e-mail sau un link nu este valid, panoul va semnala acest lucru și va bloca Salvare modificări în loc să publice un buton care nu ar face nimic pe site-ul dvs.
• Nu sunt răspunsuri FAQ. Butoanele de acțiune doar trimit oamenii în altă parte; ele nu răspund cu text predefinit. Întrebările sunt sarcina agentului dvs. AI, iar acesta le răspunde din baza dvs. de cunoștințe. Dacă doriți să sugerați ce să întrebe, utilizați întrebările de început din secțiunea Aspect.

Ce nu poți personaliza #

Panoul Manage reprezintă setul complet de opțiuni. Mai exact:

• Fără CSS sau fișier de stil personalizat. Stilul este cel oferit de temă, colțuri, fonturi și selectorii de culoare — nu poți injecta propriul CSS în widget, iar regulile de pe pagina ta nu vor avea efect în interiorul acestuia.
• Fără text substituent personalizat în căsuța de mesaje.
• Fără încorporare video în interiorul chat-ului.

Dacă unul dintre aceste aspecte reprezintă un impediment pentru tine, încorporarea inline îți oferă cel mai mare control: widgetul este plasat într-un container pe propria pagină, pe care îl poți dimensiona și poziționa după cum dorești.

Prevenirea boților și a consumului de credite #

Fiecare răspuns AI costă credite, așa că un script (sau o persoană plictisită) care deschide chat după chat pe site-ul tău este singurul lucru împotriva căruia un widget public trebuie să se apere. Widgetul gestionează majoritatea acestor situații de unul singur, iar două setări din panoul Gestionare îți permit să întărești securitatea pentru site-ul tău.

• Lista albă de domenii. Doar site-urile pe care le enumerați pot afișa widgetul. Oricine copiază codul de încorporare pe un alt site nu va obține nimic.
• Țări blocate. Vizitatorii a căror locație de rețea se află într-o țară pe care o blocați nu vor vedea niciodată widgetul, iar un chat pe care încearcă totuși să îl inițieze este refuzat. Locația provine din conexiunea vizitatorului: cineva care folosește un VPN va apărea ca fiind din țara VPN-ului, iar un vizitator a cărui locație nu poate fi determinată este lăsat să treacă în loc să fie blocat. propria previzualizare din interiorul aplicației va continua să funcționeze chiar dacă blocați țara în care vă aflați.
• Conversații noi per conexiune. O conexiune (în practică, o adresă de gospodărie sau de birou) poate deschide 20 de conversații noi pe zi pe un widget. Vizitatorii care revin și își continuă chatul existent nu sunt luați în calcul, doar conversațiile complet noi, astfel încât un script care continuă să inițieze chat-uri noi pentru a obține răspunsuri AI se va epuiza după 20, în timp ce vizitatorii reali nu vor observa nimic. Dacă mai multe persoane partajează o singură conexiune pe site-ul dvs. (un campus, un call center), măriți numărul prin REST API cu max_new_chats_per_ip_daily; 0 dezactivează verificarea.
• Verificare umană (opțional). Vizitatorii trec printr-o verificare rapidă Cloudflare Turnstile înainte ca primul lor mesaj să fie trimis, astfel încât un script nu poate iniția deloc chat-uri. Majoritatea oamenilor nu dau click pe nimic; Cloudflare afișează o casetă de selectare doar atunci când nu este sigur. Utilizează propriile chei gratuite Turnstile, consultați Adăugarea unei verificări umane de mai jos.
• Limite integrate. În plus, fiecare sesiune de browser este limitată în ceea ce privește numărul de mesaje pe care le poate trimite pe minut și pe zi, iar agentul care răspunde la chat încetează să mai răspundă unui vizitator odată ce acesta atinge Numărul maxim de mesaje AI per chat setat în Limite de răspuns.

Nimic din toate acestea nu identifică dispozitive sau persoane: widgetul nu stochează nimic în browserul vizitatorului până când acesta nu alege să inițieze un chat (vezi mai sus) și nu există nicio amprentare digitală (fingerprinting).

Adăugarea unei verificări umane (Cloudflare Turnstile) #

Activați această opțiune atunci când boții continuă să deschidă chat-uri pe site-ul dvs. web, iar setările de mai sus nu sunt suficiente. Verificarea rulează o singură dată, chiar înainte ca primul mesaj al unui vizitator să fie trimis. Un vizitator care trece testul poate continua să chatuiască timp de 24 de ore fără a-l mai vedea, iar oricine revine la o conversație anterioară o poate citi în continuare înainte de verificare.

1. Conectați-vă la contul dvs. Cloudflare (un cont gratuit este suficient) și deschideți Turnstile.
2. Faceți click pe Add widget, dați-i un nume și adăugați fiecare domeniu pe care rulează widgetul dvs. de chat (de exemplu yourshop.com). Lăsați modul widget pe Managed.
3. Copiați Site key și Secret key pe care vi le arată Cloudflare.
4. În aplicație, deschideți panoul Manage al widgetului de chat, activați Human check before chatting, lipiți ambele chei și salvați.

La ce să te aștepți:

• Verificarea rămâne dezactivată până când ambele chei sunt completate, deci activarea acesteia fără chei nu va bloca niciodată accesul vizitatorilor.
• Dacă un vizitator nu trece verificarea sau o lasă nerezolvată, mesajul său nu este trimis și va primi un buton de Retry.
• Verificarea apare doar pe domeniile pe care le-ați adăugat în Cloudflare. Pe orice alt domeniu, Cloudflare o refuză și nimeni de pe acel site nu poate trimite un mesaj, așa că adăugați fiecare domeniu înainte de a o activa.
• Dacă site-ul dvs. utilizează o politică de securitate a conținutului (Content Security Policy), permiteți https://challenges.cloudflare.com pentru scripturi și cadre, altfel verificarea nu se poate încărca.
• Cheile aparțin propriului dvs. cont Cloudflare, iar cheia secretă nu este trimisă niciodată către browserele vizitatorilor.

Instrucțiuni de instalare #

Pentru a adăuga widgetul de chat pe site-ul tău, adaugă o linie de cod în HTML-ul site-ului tău.

1. Deschide fișierul HTML al site-ului tău într-un editor de text.
2. Găsește eticheta de închidere </body> — aceasta se află de obicei chiar la sfârșitul fișierului.
3. Inserează această linie de cod chiar înainte de eticheta </body>, astfel încât restul paginii să se încarce mai întâi:

<script src="https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID" defer></script>

4. Înlocuiește CONFIG_ID cu identificatorul tău unic de configurare, afișat în secțiunea Canale și module încorporate (Channels & Embed) din panoul de administrare. Acest identificator este specific contului tău și conectează widgetul la sistemul tău de mesagerie.

Fragmentul nu va încetini site-ul: este un încărcător minuscul, iar widgetul în sine se descarcă în fundal fără a bloca pagina. Dacă totuși doriți ca widgetul să aștepte până când pagina s-a încărcat complet, puteți include același URL astfel:

<script>
window.addEventListener('load', function () {
  var s = document.createElement('script');
  s.src = 'https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID';
  s.async = true;
  document.body.appendChild(s);
});
</script>

Iar dacă doriți să întârziați doar mica bulă de invitație, nu încărcarea widgetului, aceasta este setarea Bulă pop-up proactivă din secțiunea Comportament de mai sus — nu este nevoie de cod.

Instalarea pe Shopify #

1. În panoul de administrare Shopify, mergi la Online Store > Themes.
2. Pe tema marcată ca fiind tema ta curentă (publicată), dă clic pe butonul … și alege Edit code. Editarea unei ciorne sau a unei copii a temei nu schimbă nimic în magazinul tău live.
3. Deschide layout/theme.liquid și derulează până la eticheta de închidere </body> de lângă partea de jos.
4. Lipește linia de instalare chiar deasupra </body> și dă clic pe Save:

<script src="https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID" defer></script>

Dacă ai instalat widgetul înainte ca linia de instalare să conțină defer, editorul de cod Shopify afișează o subliniere roșie sub aceasta. Acea subliniere este un avertisment din partea verificatorului de cod Shopify cu privire la liniile de script fără defer sau async, nu o eroare: tema se salvează în continuare și widgetul funcționează. Adăugarea defer așa cum se arată mai sus face ca sublinierea să dispară și nu schimbă nimic în modul în care se comportă widgetul, deci nu este nevoie de o reinstalare pe alte site-uri.

Iată un exemplu complet despre cum ar trebui să arate fișierul dvs. HTML cu widgetul de chat implementat:

<!DOCTYPE html>
<html>
<head>
    <title>My Website</title>
</head>
<body>
    <!-- Your existing website content would be here -->

    <!-- Chat Widget Integration -->
    <script src="https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID" defer></script>
</body>
</html>

Încorporare inline pe o pagină (Avansat) #

Dacă preferi ca fereastra de chat să apară ca parte a paginii tale — de exemplu, în interiorul unei secțiuni dedicate „Contactează-ne”, într-o filă de ajutor sau într-o bară laterală — în loc să apară ca o bulă plutitoare în colț, schimbă setarea Fragment încorporat (Embed snippet) în În linie (Inline) în panoul de administrare și copiază fragmentul de cod inline.

Arată astfel:

<div data-chat-widget="CONFIG_ID" style="width:100%;height:600px;"></div>
<script src="https://api.youraiconnector.com/v1/chat-widget/embed.js" async></script>

Elementul <div> este punctul de montare — panoul de chat se randează în interiorul acestuia și îi ocupă dimensiunile. Stilează div-ul după cum dorești (oferă-i o înălțime fixă, plasează-l într-un container flex, într-o celulă de grid etc.), iar panoul de chat se va adapta.

Ai nevoie de un singur tag <script> pe pagină, chiar dacă încorporezi mai multe widgeturi de chat. Scriptul scanează pagina pentru fiecare <div data-chat-widget="…"> și montează un panou de chat în fiecare dintre acestea.

Când să alegi varianta inline față de cea flotantă:

• Bula flotantă este potrivită pentru un buton de tipul „Ai nevoie de ajutor?” disponibil permanent pe tot site-ul.
• Încorporarea inline este potrivită atunci când chatul trebuie să fie într-un loc specific — o pagină de suport, o bară laterală a bazei de cunoștințe, o filă de ajutor în aplicație — și să pară o parte nativă a acelei pagini.

Modulul încorporat în linie reutilizează aceeași configurație ca bula plutitoare (logo, mesaj de întâmpinare, colectare de date, întrebări inițiale și așa mai departe), deci nu trebuie să configurezi nimic de două ori.

Afișați widgetul pe site-ul altcuiva #

Puteți afișa widgetul de chat rulând pe un site web pe care nu îl controlați — fără cod, fără a fi nevoie de acces la site-ul lor. Este cea mai rapidă metodă de a arăta unui potențial client cum ar arăta asistentul pe propriile sale pagini.

1. Deschideți panoul Gestionare și derulați până la Canale și încorporări.
2. În Link demo client, introduceți adresa site-ului web (de exemplu www.theircompany.com).
3. Opțional: sub câmp, alegeți Agentul care ar trebui să răspundă în acest demo, de exemplu un agent pe care l-ați creat pe baza propriului site web al potențialului client, astfel încât să vorbească despre serviciile, prețurile și întrebările frecvente ale acestuia. Lăsați setat pe Implicit cont pentru a utiliza rutarea obișnuită a widgetului de chat.
4. Faceți clic pe Creați link. Linkul este copiat pentru dvs. și apare în lista de sub câmp, cu butoanele Copiere și Deschidere și agentul pe care îl utilizează.
5. Trimiteți linkul oricui doriți să îl arătați.

Deschiderea linkului încarcă acel site web cu widgetul de chat plutind deasupra, exact așa cum ar arăta dacă ar fi instalat. Oricine are linkul îl poate deschide — nu există nimic la care să se autentifice.

Câteva lucruri care merită știute:

• Chat-urile din demo sunt reale. Mesajele pe care un vizitator le trimite într-un demo ajung în căsuța dvs. de primire și sunt răspunse de agentul dvs., consumând credite ca orice altă conversație.
• Pagina nu este marcată cu brandul dvs. Afișează site-ul lor web și widget-ul dvs., nimic altceva.
• Unele site-uri web nu pot fi încadrate. Un număr de site-uri (bănci, retaileri mari, orice site cu setări de securitate stricte) blochează afișarea lor în alte pagini. Când se întâmplă acest lucru, link-ul funcționează în continuare: afișează o fereastră de browser neutră în loc de site-ul real, cu widget-ul dvs. activ deasupra, astfel încât demo-ul să își îndeplinească scopul.
• Nu modifică site-ul lor web. Nu se instalează și nu se modifică nimic — demo-ul există doar în interiorul acelui link.
• Dezactivați un link când demo-ul s-a încheiat. Faceți clic pe Dezactivare lângă link-ul din listă și confirmați. Din acel moment, oricine îl deschide va vedea o pagină care anunță că link-ul a fost dezactivat. Widget-ul dvs. și celelalte link-uri demo continuă să funcționeze. Un link care a fost dezactivat nu mai poate fi reactivat; creați unul nou în schimb.
• Link-uri copiate înainte de 25 septembrie 2026. Link-urile demo create înainte de existența listei nu apar în aceasta. Acestea continuă să funcționeze până când faceți clic pe Dezactivează-le pe acelea sub listă, ceea ce le dezactivează pe toate simultan (iar Reactivează-le inversează acțiunea).

Un link demo creat fără un agent utilizează rutarea implicită a contului tău, indiferent de setarea opțiunii Direcționează aceste chat-uri către. Cu un agent selectat, fiecare chat de pe acel link este alocat acelui agent și răspuns de acesta. Widget-ul își păstrează aspectul, numele și mesajul de întâmpinare proprii. Link-ul îl poartă ca &agent=AGENT_ID; adăugarea acestuia manual la un link mai vechi funcționează de asemenea (folosește &, nu ?, deoarece link-ul conține deja un ?).

Dacă ulterior ștergeți agentul pe care îl utilizează un link demo, linkul continuă să funcționeze: chat-urile sale vor fi direcționate către rutarea implicită a contului dvs., iar lista va afișa „agent șters, utilizează setarea implicită” lângă acesta. Ștergerea agentului care este setat ca implicit pentru widgetul de chat nu afectează linkurile fixate pe un alt agent.

Partajați un link direct către chat #

Uneori nu există un site web pe care să plasați widgetul — doriți să oferiți cuiva un link și ca acesta să poată vorbi imediat cu asistentul dvs. Fiecare widget de chat are unul:

1. Deschideți panoul Gestionare și derulați la Canale și încorporare.
2. Găsiți Link de partajare (se află chiar sub linkul demo pentru client).
3. Faceți clic pe Copiere pentru a prelua linkul sau pe Deschidere pentru a-l încerca singur.

Deschiderea acestuia nu afișează nimic altceva decât asistentul dvs., ocupând întregul ecran — fără site web în spate, fără bulă pe care să faceți clic mai întâi, fără nimic de instalat. Plasați-l în biografia de Instagram, într-un cod QR pe un pliant, într-o semnătură de e-mail sau într-un mesaj WhatsApp către un potențial client.

Link-ul de partajare urmează rutarea implicită a widget-ului tău de chat. Pentru a deschide un agent specific, adaugă ?agent=AGENT_ID la sfârșitul link-ului; fiecare chat provenit de pe acesta este apoi alocat acelui agent și răspuns de acesta, în timp ce pagina își păstrează numele și mesajul de întâmpinare ale widget-ului tău.

Câteva lucruri care merită știute:

• Chat-urile din link sunt reale. Ele ajung în căsuța de primire, agentul dvs. le răspunde și utilizează credite ca orice altă conversație.
• Pagina nu poartă nicio marcă de-a noastră. Afișează doar asistentul dvs. și nimic altceva, fiind exclusă din rezultatele căutării.
• Funcționează pe propria adresă. Dacă furnizorul dvs. rulează aplicația pe propriul domeniu, linkul utilizează și acea adresă, astfel încât nu va apărea nimic necunoscut.
• Un vizitator per link, per browser. Oricine îl deschide păstrează aceeași identitate în acel browser, astfel încât revenirea ulterioară continuă aceeași conversație în loc să înceapă una nouă, ca un străin. Un browser diferit sau linkul unui alt widget reprezintă un vizitator diferit.

Trimiteți pagini diferite către agenți diferiți #

În mod implicit, fiecare chat care provine prin widgetul dvs. este gestionat de același agent. Puteți suprascrie acest lucru pentru fiecare pagină, astfel încât vizitatorii de pe pagina de prețuri să discute cu agentul de vânzări, în timp ce vizitatorii de pe pagina de ajutor discută cu agentul de asistență, totul din același widget de chat.

Există două modalități de a obține codul:

• De la agent. Pe pagina Agenți AI, faceți clic pe butonul </> de pe rând sau deschideți agentul și accesați fila Puncte de intrare. În ambele cazuri, veți obține un fragment gata de lipit, deja direcționat către acel agent.

  Fila Puncte de intrare a unui agent conține, de asemenea, un panou Widget de chat pentru site-ul web care arată câte conversații prin chat pe site gestionează deja acel agent. Conversațiile provenite dintr-o fereastră încorporată ajung direct la agent, așa că nu este nevoie să creați o regulă de punct de intrare pentru acestea — un agent fără nicio regulă va răspunde în continuare prin fereastra sa încorporată.

  Butonul </> apare doar pentru agenții activi. Un agent întrerupt ar primi chatul, dar nu ar răspunde niciodată, așa că opțiunea este ascunsă până când o reactivați. Nu există niciun canal de configurat pentru un agent — un agent poate prelua un chat de pe orice canal.

• Din setările widgetului. În Setări → Canale → Gestionare din widgetul dvs. de chat, setați Direcționează aceste chat-uri către și copiați fragmentul de dedesubt. Modificarea meniului derulant rescrie fragmentul.

Fragmentul plutitor conține destinația în adresă:

<script src="https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID?agent=AGENT_ID" defer></script>

Fragmentul în linie o conține în schimb pe <div>, astfel încât o pagină poate găzdui mai multe chat-uri care merg în locuri diferite:

<div data-chat-widget="CONFIG_ID" data-agent="AGENT_ID" style="width:100%;height:600px;"></div>
<script src="https://api.youraiconnector.com/v1/chat-widget/embed.js" async></script>

Fragmentele copiate înainte de retragerea campaniilor conțin în schimb ?campaign= sau data-campaign=. Acestea continuă să funcționeze, deci nu este nevoie să le lipiți din nou.

Câteva lucruri care merită știute:

• Utilizați butonul de copiere în loc să tastați manual ID-ul. Dacă ID-ul nu corespunde unui agent din contul dvs., chatul va funcționa în continuare, dar va reveni la rutarea implicită.
• Cineva care se află deja în mijlocul unei conversații rămâne cu persoana cu care a început, chiar dacă ulterior ajunge pe o pagină care direcționează către altcineva. Acest lucru previne schimbarea personalității unei conversații la jumătatea drumului.
• O destinație specifică paginii are prioritate față de setarea implicită a contului și față de declanșatoarele de cuvinte cheie.

Spune widgetului cine este vizitatorul (Avansat) #

Dacă plasezi widgetul de chat într-o zonă pentru membri, un portal pentru clienți sau o aplicație unde utilizatorii sunt deja autentificați, site-ul tău știe deja cine sunt aceștia. Poți transmite aceste informații widgetului, astfel încât vizitatorului să nu i se mai ceară detalii pe care le-a furnizat deja, iar AI-ul tău să poată folosi ceea ce știi deja despre el.

Adaugă un mic bloc de setări înainte de scriptul widgetului:

<script>
  window.chatWidgetSettings = {
    visitor: {
      id: "12345",
      name: "Maria",
      email: "maria@example.com",
      phone: "+391234567890"
    },
    data: {
      plan: "Professional",
      customer_since: "2024",
      last_order: "A-2291"
    }
  };
</script>
<script src="https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID" defer></script>

Pagina ta ar trebui să completeze acele valori pe partea de server, folosind datele utilizatorului autentificat.

Pentru a salva și un nume de familie, adaugă last_name lângă name în blocul visitor (data-visitor-last-name pe o integrare inline). Este opțional: un nume și o adresă de e-mail sunt în continuare suficiente pentru a sări peste formular, indiferent dacă Colectare nume de familie este activat sau nu.

Se întâmplă două lucruri:

• Formularul „Înainte de a începe…” este omis. Cu un nume și o adresă de e-mail furnizate, vizitatorul trece direct la conversație, iar acele detalii sunt salvate în contactul său exact ca și cum le-ar fi introdus el însuși.
• Tot ce se află sub data este transmis AI-ului tău. Orice introduci acolo — plan, număr de comandă, dată de reînnoire, sold credit, număr de locuri — devine parte din ceea ce știe AI-ul despre acea persoană, astfel încât să poată răspunde la întrebări precum „când se reînnoiește planul meu?” fără a cere vizitatorului să explice cine este. Folosește orice nume de câmp care are sens pentru tine; acestea vor apărea în contact la secțiunea Câmpuri personalizate. Poți trimite până la 20 de valori, actualizate la fiecare mesaj, astfel încât, dacă planul se schimbă în timpul conversației, AI-ul va vedea noua valoare.

Pentru elementele încorporate (inline embeds), poți plasa aceleași informații pe <div>, ceea ce este util atunci când o pagină conține mai multe ferestre de chat:

<div data-chat-widget="CONFIG_ID"
     data-visitor-name="Maria"
     data-visitor-email="maria@example.com"
     data-visitor-data='{"plan":"Professional"}'
     style="width:100%;height:600px;"></div>
<script src="https://api.youraiconnector.com/v1/chat-widget/embed.js" async></script>

Dacă site-ul tău află cine este vizitatorul abia după încărcarea paginii — de exemplu, într-o aplicație de tip single-page unde autentificarea are loc fără reîncărcarea paginii — apelează această funcție ori de câte ori ai detaliile, iar widgetul se va actualiza automat:

<script>
  window.chatWidget.setVisitor({
    visitor: { id: "12345", name: "Maria", email: "maria@example.com" },
    data: { plan: "Professional" }
  });
</script>

Câteva lucruri care merită știute:

• Dacă două persoane diferite se conectează pe același computer, a doua persoană începe o conversație nouă în loc să o vadă pe cea a primei persoane. Widgetul observă schimbarea persoanei și se resetează.
• De la sine, acest lucru servește pentru context, nu pentru autentificarea cuiva. Conversațiile sunt în continuare păstrate separat, așa cum au fost întotdeauna, deci transmiterea unui id nu permite nimănui să deschidă conversația altcuiva, iar cineva care folosește un dispozitiv sau un browser diferit începe o conversație nouă acolo. Pentru a continua conversația pe mai multe dispozitive, semnați id așa cum este descris în continuare.
• Este opțional. Un widget de pe o pagină publică obișnuită nu are nevoie de nimic din toate acestea și se comportă exact ca înainte.

Reluați aceeași conversație pe orice dispozitiv (ID vizitator conectat) #

Dacă clienții dvs. au conturi, puteți face ca chatul lor să îi urmărească: se conectează pe un telefon, continuă pe un laptop, și este aceeași conversație cu același contact în căsuța dvs. de primire, iar AI-ul știe în continuare tot ce s-a spus. Pentru aceasta, Your AI Connector are nevoie de dovada că vizitatorul este într-adevăr cine spune pagina dvs. că este, altfel oricine ar putea introduce un număr de client în browserul său și ar putea citi chatul acelui client. Dovada este o semnătură pe care o calculați pe serverul dvs.

1. În panoul Gestionare al widgetului, sub Canale și încorporare, găsiți Vizitatori autentificați și faceți clic pe Generare secret. Copiați secretul de identitate. Păstrați-l doar pe serverul dumneavoastră; nu îl introduceți niciodată în pagină.

2. Când serverul dumneavoastră randează o pagină pentru un client autentificat, calculați un HMAC-SHA256 al ID-ului acelui client folosind secretul, sub formă de șir hexazecimal cu litere mici:

// Node.js
const hash = require("crypto").createHmac("sha256", IDENTITY_SECRET).update(customerId).digest("hex");

// PHP
$hash = hash_hmac('sha256', $customerId, IDENTITY_SECRET);

# Python
import hmac, hashlib
hash = hmac.new(IDENTITY_SECRET.encode(), customer_id.encode(), hashlib.sha256).hexdigest()

3. Introduceți ID-ul și hash-ul în blocul de setări, lângă numele și adresa de e-mail pe care le transmiteți deja:

<script>
  window.chatWidgetSettings = {
    visitor: {
      id: "12345",
      hash: "3f2a…e91c",
      name: "Maria",
      email: "maria@example.com"
    }
  };
</script>
<script src="https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID" defer></script>

Încorporarea inline preia aceeași valoare ca data-visitor-hash pe <div>, iar window.chatWidget.setVisitor({ visitor: { id, hash } }) funcționează pentru aplicațiile care conectează utilizatorii fără reîncărcarea paginii.

Ce se întâmplă odată ce semnătura este verificată:

• Chatul clientului este stocat în contul său, mai degrabă decât în browser, deci este aceeași conversație pe fiecare dispozitiv și fiecare browser în care este conectat, și un singur contact în căsuța dvs. de primire.
• Mesajele sale anterioare se încarcă pe noul dispozitiv, iar AI-ul continuă de unde a rămas.
• Dacă semnătura este incorectă, widgetul se comportă discret ca înainte, ca un chat normal per-browser, și tipărește motivul în consola browserului, astfel încât un dezvoltator să îl poată identifica. Vizitatorii dvs. nu văd niciodată o eroare.
• ID-ul este comparat exact așa cum l-ați trimis, deci semnați aceeași valoare pe care o transmiteți ca id și folosiți același ID pentru aceeași persoană peste tot.

Două lucruri de știut:

• Regenerare în panoul Gestionare vă oferă un secret nou. Paginile care se semnează în continuare cu cel vechi revin la chat-urile normale per-browser până când serverul dvs. folosește noul secret. Conversațiile existente sunt păstrate; ele sunt legate de ID-ul clientului, nu de secret.
• O conversație pe care cineva a avut-o înainte de a se conecta, ca vizitator anonim, rămâne un chat separat. Conversația bazată pe cont începe cu primul mesaj pe care îl trimite în timp ce este conectat.

Modifică setările widgetului din propriul tău cod (API) #

Tot ce se află în panoul Gestionare al widgetului poate fi modificat și prin REST API, ceea ce este util dacă gestionezi mai multe site-uri web sau dacă dorești să dezactivezi automat butonul de atașare pentru un client. Trimite un PATCH către https://api.youraiconnector.com/v1/chat-widget-configs/CONFIG_ID cu cheia ta API și doar câmpurile pe care dorești să le modifici — de exemplu, {"show_upload_button": false} ascunde butonul de atașare, {"show_emoji_button": false} ascunde selectorul de emoji-uri, iar {"launcher_icon": "chat-dots"} schimbă pictograma lansatorului. CONFIG_ID este același identificator ca cel din scriptul tău de încorporare. Lista completă a câmpurilor acceptate (nume, mesaj de întâmpinare, culori, pictograma lansatorului, domenii permise, formular de informații vizitator, notificare de confidențialitate, temă, stilul colțurilor și al fontului) se află în Referința API la secțiunea Widget de chat. Site-urile web preiau modificarea la următoarea încărcare a paginii.

La ce să te aștepți după instalare #

După ce ați adăugat scriptul pe site-ul dumneavoastră, widgetul de chat va crea automat un buton de chat în colțul site-ului (implicit în dreapta jos). Widgetul rămâne într-o poziție fixă pe măsură ce utilizatorii derulează paginile, asigurându-se că este întotdeauna accesibil.

Când vizitatorii dau clic pe acest buton, acesta se extinde într-o fereastră de chat completă unde pot începe o conversație, afișând mesajul dumneavoastră de întâmpinare. Dacă opțiunea Colectare informații vizitator este activată, apare mai întâi un formular mic care solicită numele și adresa de e-mail (și opțional numărul de telefon) înainte ca aceștia să poată tasta.

Interfața de chat se adaptează automat la diferite dimensiuni de ecran, astfel încât funcționează fără probleme atât pe desktop, cât și pe dispozitivele mobile.

Testarea implementării #

După ce ai adăugat widgetul pe site-ul tău, testează dacă funcționează:

1. Deschide site-ul tău într-un browser.
2. Dă clic pe butonul de chat pentru a deschide widgetul.
3. Trimite un mesaj de test și confirmă că primești un răspuns.
4. Repetă procesul pe un alt dispozitiv sau browser pentru a confirma că funcționează peste tot.

Dacă widgetul de chat nu apare pe site-ul tău, verifică următoarele:

1. Asigură-te că ai înlocuit CONFIG_ID cu identificatorul tău real de configurare.
2. Asigură-te că eticheta de script este plasată înainte de eticheta de închidere </body>.
3. Verifică codul pentru erori de scriere.
4. Pe Shopify, asigură-te că ai editat tema publicată și că ai dat clic pe Save. O modificare făcută într-o ciornă sau într-o temă duplicată nu ajunge niciodată în magazinul tău live.

În spatele unui firewall corporativ #

Dacă widgetul se încarcă pentru public, dar nu și pentru angajații din rețeaua de la birou, este aproape sigur că rețeaua blochează domeniul de pe care acesta se încarcă. Roagă echipa IT să permită, prin HTTPS standard pe portul 443:

• Domeniul din fragmentul tău de încorporare — adresa din linia <script src="..."> pe care ai copiat-o din panoul Manage.
• api.youraiconnector.com — widgetul trimite mesajele și către această adresă.

Nu este necesară nicio altă setare: fără porturi suplimentare și fără reguli de intrare. Dacă widgetul tot nu apare după aceste modificări, deschide consola pentru dezvoltatori a browserului pe pagina respectivă și trimite-ne ceea ce raportează — o cerere blocată va menționa domeniul care a fost refuzat, ceea ce reprezintă, de obicei, tot răspunsul de care avem nevoie.