---
title: Cum se instalează agentul pe Shopify
description: 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.
section: platforms
keywords: Shopify, widget Shopify, chatbot Shopify, agent AI Shopify, theme.liquid, chat pentru magazin Shopify, agent inteligent Shopify, integrare AI Shopify, suport clienți automatizat Shopify, instalare agent Shopify, configurare agent Shopify, catalog produse Shopify
updated: 2026-09-06
---
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.

```liquid
    <!-- 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.

- Deschideți magazinul în modul incognito, așteptați butonul de chat.
- Întrebați despre un produs după denumire — ar trebui să apară o fișă cu preț.
- Apăsați „Treci la finalizarea comenzii” — ar trebui să se deschidă coșul Shopify.
- Plasați o comandă de test și asigurați-vă că achiziția a fost înregistrată în „Comenzi”.

## 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.
