Zum Inhalt springen

VTEX-Integration

KI-Chatbot für deinen VTEX-Shop

Verbinde deine VTEX-Storefront, damit der Agent über die öffentliche Intelligent Search von VTEX live nach Produkten und Preisen sucht, und binde den Chat per Google Tag Manager oder im Code deiner Storefront ein. Ohne App-Key.

Agent kostenlos erstellen

Zuletzt aktualisiert:

So funktioniert intoCHAT mit VTEX

intoCHAT erkennt dein VTEX-Konto an deiner Storefront und sucht Produkte über die öffentliche Intelligent Search von VTEX, also dieselbe Suche, die dein Shop nutzt. Das klappt mit Store-Framework-Shops genauso wie mit Headless-Storefronts. Die Chat-Bubble kommt über ein kurzes Script dazu, per Google Tag Manager oder im eigenen Code deiner Storefront. Der Agent liest nur öffentliche Katalogdaten: keine Bestellungen, Warenkörbe, Checkout-Daten oder Kundenkonten.

intoCHAT in VTEX einrichten

  1. Agenten erstellen und trainieren

    Registriere dich, erstelle einen Agenten und gib im Tab Knowledge die Adresse deines Shops ein, damit er deine Versand-, Rückgabe- und Hilfeseiten kennt. Du kannst auch Dateien hochladen oder Q&A-Paare anlegen.

  2. Shop verbinden

    Wähle im Tab Actions Connect your website und füge die Adresse ein, die deine Kundschaft besucht, auch wenn es eine eigene Storefront ist. intoCHAT erkennt dein VTEX-Konto und legt die Aktion Search products an.

  3. Custom-HTML-Tag im Google Tag Manager anlegen

    Nutzt dein Shop die Google-Tag-Manager-App von VTEX, öffne deinen GTM-Container und geh zu Tags > Neu > Tag-Konfiguration > Benutzerdefiniertes HTML. Füge den Code unten ein und ersetze YOUR_AGENT_ID durch die ID aus dem Tab Share.

  4. Auf allen Seiten auslösen

    Füge dem Tag einen neuen Trigger vom Typ DOM ist bereit hinzu, der bei allen Ereignissen auslöst, damit der Body der Seite existiert, wenn das Widget startet, und speichere das Tag. Prüfe es im Vorschaumodus, sende die Änderungen und veröffentliche den Container.

  5. Shop prüfen

    Öffne deinen Shop. Die Chat-Bubble erscheint unten in der Ecke, mit den Farben und der Position aus dem Tab Appearance.

Der Code für ein Custom-HTML-Tag im GTM

<script>
  (function () {
    if (document.getElementById('intochat-embed')) return;
    var s = document.createElement('script');
    s.id = 'intochat-embed';
    s.src = 'https://www.intochat.ai/api/embed.js';
    s.setAttribute('data-chatbot-id', 'YOUR_AGENT_ID');
    document.body.appendChild(s);
  })();
</script>

Google Tag Manager entfernt Data-Attribute aus Script-Tags in Custom HTML, das einfache Script-Tag würde also ohne Agenten-ID laden. Diese Version setzt das Attribut per JavaScript. Derselbe Code funktioniert in der body.html einer Pixel-App oder in einem CMS-Template.

Was der Agent in deinem VTEX-Shop macht

  • Sucht live im Katalog

    Jede Suche läuft über VTEX Intelligent Search für dein Konto und liefert bis zu fünf Produkte mit Name, Marke, Preis, Kategorien und SKU-Spezifikationen.

  • Zeigt Produktkarten

    Antworten enthalten Karten mit Produktbild, Preis und einem Link, der dem Aufbau deiner eigenen Produkt-URLs folgt.

  • Nennt den Preis, den Kunden zahlen

    Der Agent unterscheidet den Verkaufspreis vom Listenpreis vor Rabatt und nennt so den Betrag, den Kunden tatsächlich zahlen, in der Währung deines Shops.

  • Funktioniert mit Headless-Storefronts

    Gib die Adresse ein, die deine Kundschaft besucht. intoCHAT liest das Linkformat deiner Produkte aus deinen Seiten, sodass Links zu deiner eigenen Storefront führen.

  • Antwortet auch jenseits des Katalogs

    Trainiere ihn mit Versand-, Rückgabe- und FAQ-Seiten oder Dateien. Q&A-Paare haben Vorrang vor anderen Quellen.

  • Sammelt Leads

    Ein Formular im Chat fragt nach E-Mail-Adresse oder Telefonnummer, nach Regeln, die du festlegst, und jeder neue Lead löst eine E-Mail-Benachrichtigung aus.

Häufige Fragen

Was liest intoCHAT aus meinem VTEX-Shop?

Öffentliche Katalogdaten aus VTEX Intelligent Search für dein Konto: Produktnamen, Marken, Preise, Kategorien und SKU-Spezifikationen, dazu die Währung deines Shops aus dessen öffentlichem Verkaufskanal. Einen App-Key brauchst du nicht, und Bestellungen, Warenkörbe, Checkout und Kundenkonten sieht der Agent nicht.

Kann der Agent Bestellungen verfolgen?

Nein. Für Bestellabfragen braucht es private Zugangsdaten des Shops und einen Nachweis, dass die Bestellung dem Besucher gehört, und das kann eine öffentliche Verbindung nicht leisten. Der Agent beantwortet Fragen zu Lieferung und Rückgabe aus deinen Seiten und nimmt E-Mail-Adresse oder Telefonnummer auf, damit dein Team nachfassen kann.

Wie binde ich den Chat ohne Google Tag Manager ein?

Im Store Framework können Entwickler denselben Code in die Datei body.html einer Pixel-App legen, die im Body jeder Shopseite läuft; nutze dafür nicht die head.html. In einem Shop mit Legacy CMS gehst du zu Storefront > Layout > CMS > HTML Templates und fügst den Code direkt vor dem schließenden Body-Tag jedes Templates ein, das deine Seiten nutzen. Bei FastStore oder einer anderen Headless-Storefront fügen deine Entwickler ihn in den Code der Storefront ein, sodass er auf jeder Seite läuft.

Warum nicht einfach das Script-Tag in den Google Tag Manager einfügen?

GTM entfernt Data-Attribute aus Script-Tags in Custom-HTML-Tags, das Script würde also ohne deine Agenten-ID laden und kein Chat erscheinen. Der Code auf dieser Seite baut das Script-Element per JavaScript und setzt das Attribut selbst. Wo du HTML direkt bearbeitest, etwa in einem CMS-Template, funktioniert auch das einzeilige Script-Tag aus dem Tab Share.

Funktioniert es mit einer Headless-Storefront auf VTEX?

Ja. Verbinde die Adresse, die deine Kundschaft besucht. intoCHAT erkennt das VTEX-Konto an Asset-Adressen auf deinen Seiten, etwa vtexassets.com, und baut Produktlinks im Format deiner Storefront.

Macht der Chat meinen Shop langsamer?

Über den Google Tag Manager wird das Script erst eingefügt, wenn die Seite schon lädt, es hält deine Inhalte also nicht auf. Das Chatfenster läuft in einem eigenen iframe von intoCHAT, sein Code bleibt also von deiner Storefront getrennt.

Sieh, wie er mit deiner Website antwortet

Gib die Adresse deiner Website ein und chatte mit einem Agenten, der aus deinen Seiten gebaut wird. Das dauert etwa eine Minute.

Agent kostenlos erstellen

Kostenloser Plan, keine Kreditkarte nötig.