Commerce AgentsBază de cunoștințe
Română
РусскийEnglishDeutschFrançaisEspañolPortuguêsItalianoNederlandsPolskiУкраїнськаČeštinaSlovenčinaSlovenščinaHrvatskiСрпскиБългарскиRomânăMagyarΕλληνικάSvenskaNorskDanskSuomiLatviešuLietuviųEestiTürkçeالعربيةעברית中文
Tarife Spre cabinet
Bază de cunoștințe → Instalare pe platforme

Cum se instalează agentul pe Shopify

Unde se inserează codul în tema Shopify, cum citește agentul catalogul magazinului, ce e de făcut cu coșul de cumpărături și plata și cum se verifică instalarea.

6 septembrie 2026

Shopify are deja un catalog într-un format lizibil de mașină, de aceea agentul colectează produsele mai precis decât oriunde altundeva: prețurile, variantele, disponibilitatea și fotografiile provin direct din magazin.

Pasul 1. Inserați codul în temă#

  1. În panoul de administrare Shopify, deschideți Online Store → Themes.
  2. La tema activă, apăsați … → Edit code.
  3. În lista de fișiere, găsiți layout/theme.liquid.
  4. Inserați linia de cod din contul dvs. chiar înainte de eticheta de închidere </body>.
  5. Salvați.

O alternativă fără a edita tema: Online Store → Preferences → Custom code sau orice aplicație pentru inserarea scripturilor. Rezultatul este același.

    <!-- Commerce Agents -->
<script src="https://comag.vibevox.pro/widget.js" data-slug="slug-ul tău" async></script>
  </body>
</html>

Luați linia exactă din contul dvs. folosind butonul „Copiază codul”: aceasta conține deja adresa magazinului dvs. online.

Pasul 2. Colectați catalogul#

În setări, introduceți adresa magazinului și porniți analiza. Crawler-ul Shopify citește datele structurate ale produselor: denumirea, prețul, moneda, disponibilitatea, descrierea și fotografiile. Variantele (mărimi, culori) apar în fișa produsului ca și caracteristici.

O analiză repetată actualizează prețurile și disponibilitatea. Rulați-o după modificări majore ale sortimentului: agentul nu se conectează direct la baza dvs. de date, ci lucrează cu catalogul colectat.

Pasul 3. Lăsați plata în seama magazinului#

Pe Shopify, nu este necesar să activați plata în chat. Schema corectă:

  1. În setările magazinului, specificați linkul către coșul de cumpărături — de obicei https://domeniul-dvs/cart.
  2. Agentul selectează produsul, afișează fișa acestuia și, printr-un buton, direcționează cumpărătorul către coșul de cumpărături Shopify.
  3. Finalizarea comenzii și plata se desfășoară în mod obișnuit, cu toate regulile dvs. de livrare și taxe.

Pentru a vedea ce dialoguri se finalizează cu o achiziție, inserați fragmentul de pixel de cumpărare pe pagina de mulțumire. Pe Shopify, aceasta se găsește la Settings → Checkout → Order status page → Additional scripts. Fragmentul cu substituirea numărului comenzii și a sumei se găsește în contul dvs., în secțiunea „Widget și link”.

Produsul ajunge în coș, fără a întrerupe conversația#

Aici Shopify se evidențiază mai bine decât alte platforme. Agentul afișează fișe de produse cu fotografie, preț și un buton, dar butonul nu doar duce la pagină — el adaugă produsul în coșul magazinului.

Funcționează astfel: în linkul produsului Shopify există un identificator de variantă, agentul îl transmite coșului dvs. prin interfața standard /cart/add.js. Pagina nu se reîncarcă, dialogul nu este întrerupt, cumpărătorul vede o confirmare scurtă și continuă să aleagă. Produsul este deja în coșul Shopify — cu toate regulile dvs. de reduceri, taxe și livrare.

Dacă varianta nu este în link, agentul deschide fișa produsului, iar cumpărătorul o adaugă singur. Nimic nu se strică, este doar un clic în plus.

Când persoana este pregătită, butonul „Treci la finalizarea comenzii” duce la /cart, unde totul este deja pregătit. Mai departe — casa de marcat obișnuită Shopify.

Și separat despre context: agentul citește datele structurate ale paginii pe care este deschis chatul. Cumpărătorul privește un anumit produs și întreabă „este disponibil în mărimea L?” — agentul înțelege despre ce este vorba, fără a cere clarificări.

Chatul în ton cu vitrina#

Tema Shopify setează atmosfera întregului magazin, iar chatul nu ar trebui să iasă din acest ton. În setările widgetului există trei opțiuni: deschisă, întunecată și „ca la vizitator”, care urmează setările dispozitivului cumpărătorului.

Pentru magazinele cu temă întunecată, setați ferm varianta întunecată, pentru cele luminoase — pe cea deschisă. Culoarea de accent a butoanelor rămâne a dvs. în ambele cazuri.

Pasul 4. Verificați#

Probleme frecvente#

Widgetul a dispărut după schimbarea temei. Codul se află în fișierul temei. Schimbarea sau actualizarea temei șterge modificarea — inserați codul din nou sau utilizați Custom code, care nu depinde de temă.

Catalogul nu a fost colectat complet. Crawler-ul preia produsele de pe paginile publice. Produsele ascunse din catalog și ciornele nu sunt incluse, ceea ce este corect.

Prețurile din catalog sunt învechite. Rulați din nou analiza site-ului, aceasta va actualiza prețurile și disponibilitatea pentru fișele de produse existente.

Widgetul intră în conflict cu aplicația de chat. Păstrați un singur chat: două ferestre în același colț se deranjează reciproc și îl confundă pe cumpărător.

Întrebări frecvente#

Este necesară o aplicație din Shopify App Store#

Nu. Agentul se conectează printr-o singură linie de cod, nu este necesară instalarea unei aplicații.

Poate agentul să afișeze variantele produselor#

Da, variantele apar în fișa produsului ca și caracteristici: mărime, culoare, volum. Cumpărătorul alege varianta specifică în coșul Shopify.

Cum se procedează cu mai multe valute#

Agentul afișează prețurile în valuta catalogului, pe care o determină la scanare. Funcționalitatea multivalută a Shopify operează mai departe, la nivelul coșului și al plății.

Va ști agentul despre stocuri#

Disponibilitatea este preluată la momentul analizei. Pentru produsele care se epuizează frecvent, rulați analiza mai des sau adăugați în condiții o mențiune că disponibilitatea se confirmă la finalizarea comenzii.

Influențează widgetul viteza magazinului#

Scriptul se încarcă asincron și nu blochează randarea. Acest lucru nu afectează practic deloc metricile Core Web Vitals.

Nu ați găsit răspunsul? Scrieți pe Telegram Deschide ca Markdown
Agent demo