AI for Shops
Docs
Integrace webu

Integrace webu

Přidejte ai4shops.com na svůj web za méně než 5 minut. Funguje s jakoukoliv platformou.

ai4shops.com funguje s jakýmkoliv webem. WordPress, Shopify, vlastní HTML - pokud má váš web HTML, funguje to! 🚀

Základní skript

Zde je vše, co potřebujete:

<script
  src="https://ai4shops.com/embed.js"
  data-project-id="proj_vase_id"
></script>

To je opravdu vše! Tento jeden skript načte všechny vaše formuláře, vyskakovací okna a chatbota.

Kde to přidat

Nejlepší praxe: Před </body>

Vložte skript těsně před ukončovací tag </body> ve vašem HTML:

<!DOCTYPE html>
<html>
  <head>
    <title>Můj web</title>
  </head>
  <body>
    <!-- Obsah vašeho webu -->
 
    <!-- ai4shops.com Skript -->
    <script
      src="https://ai4shops.com/embed.js"
      data-project-id="proj_abc123"
    ></script>
  </body>
</html>

Proč před </body>?

  • Obsah stránky se načte první (rychlejší vnímání)
  • Zajišťuje, že je DOM připraven
  • Lepší SEO
  • Oborový standard

Instalace podle platformy

WordPress

Možnost 1: Plugin Header/Footer

  1. Nainstalujte plugin "Insert Headers and Footers"
  2. Vložte skript do sekce zápatí
  3. Uložte

Možnost 2: Editor motivu

  1. Vzhled → Editor motivu
  2. Otevřete footer.php
  3. Najděte tag </body>
  4. Vložte skript nad něj
  5. Aktualizujte soubor

Možnost 3: Widget Vlastní HTML

  1. Vzhled → Widgety
  2. Přidejte widget "Vlastní HTML" do zápatí
  3. Vložte skript
  4. Uložte

Shopify

  1. Online obchod → Motivy
  2. Klikněte na "..." → Upravit kód
  3. Otevřete theme.liquid
  4. Najděte </body> (obvykle poblíž spodní části)
  5. Vložte skript nad něj
  6. Uložte

Vlastní HTML

Přímá úprava vašich HTML souborů:

  1. Otevřete HTML soubor v editoru
  2. Najděte tag </body>
  3. Vložte skript nad něj
  4. Uložte a nahrajte

Ověření instalace

Přidejte skript

Nainstalujte pomocí jedné z výše uvedených metod.

Navštivte svůj web

Otevřete svůj web v prohlížeči (použijte režim inkognito pro čistý test).

Otevřete vývojářskou konzoli

  • Chrome/Edge: Stiskněte F12 nebo Ctrl+Shift+I (Windows) / Cmd+Option+I (Mac)
  • Firefox: Stiskněte F12 nebo Ctrl+Shift+K (Windows) / Cmd+Option+K (Mac)
  • Safari: Povolte vývojářské menu → Vývoj → Zobrazit JavaScriptovou konzoli

Zkontrolujte zprávy v konzoli

Hledejte:

✓ ai4shops.com v2.1.0 úspěšně načten
✓ Projekt: proj_abc123
✓ Widgety: 2 formuláře, 1 modal, 1 chatbot

Pokud vidíte chyby, viz Řešení problémů níže.

Otestujte widgety

  • Formuláře: Měly by se zobrazit na stránce
  • vyskakovací okna: Měly by se spustit podle nastavení
  • Chatbot: Bublina chatu by se měla objevit

Možnosti konfigurace

Přizpůsobte chování pomocí datových atributů:

Možnosti zobrazení

<script
  src="https://ai4shops.com/embed.js"
  data-project-id="proj_abc123"
  data-theme="auto"
  data-position="bottom-right"
  data-language="cs"
></script>

Dostupné možnosti:

data-theme

  • light: Světlé barvy
  • dark: Tmavé barvy
  • auto: Odpovídá systémovému nastavení (výchozí)

data-position (pro chatbota)

  • bottom-right (výchozí)
  • bottom-left
  • top-right
  • top-left

data-language

  • en: Angličtina (výchozí)
  • cs: Čeština
  • de: Němčina
  • ... (50+ jazyků)

Řešení problémů

Skript se nenačítá

Chyba: "Nepodařilo se načíst prostředek"

Řešení:

  • Ověřte, že URL je přesně: https://ai4shops.com/embed.js
  • Zkontrolujte konzoli prohlížeče pro detaily
  • Zkuste jiný prohlížeč
  • Kontaktujte podporu, pokud problém přetrvává

Neplatný API klíč

Chyba: "Ověření selhalo: Neplatný API klíč"

Řešení:

  • Zkopírujte API klíč z dashboardu (Nastavení → API klíče)
  • Ujistěte se, že jste zkopírovali celý klíč
  • Regenerujte, pokud je kompromitován
  • Aktualizujte skript novým klíčem

Widgety se nezobrazují

Formuláře se neobjevují:

  • Zkontrolujte, zda je formulář nastaven jako "Aktivní" v dashboardu
  • Ověřte, že data-form-id je správné
  • Hledejte CSS konflikty (použijte inspektor prohlížeče)
  • Zkontrolujte, zda formulář nemá podmínky zobrazení

vyskakovací okna nespouští:

  • Zkontrolujte nastavení spouštěčů (exit intent, scroll, časové zpoždění)
  • Ověřte, že modal je "Publikován"
  • Možná je třeba počkat na podmínku spuštění
  • Vyzkoušejte trigger "Při načtení stránky"

Chatbot není viditelný:

  • Ujistěte se, že chatbot je "Publikován" v nastavení
  • Zkontrolujte pozici (může být mimo obrazovku)
  • Hledejte CSS z-index konflikty
  • Ověřte, že existují trénovací data

Další kroky

Vytvořit první formulář

Vytvořte formulář k vložení

View

Nastavit chatbota Trénujte a nasaďte AI chat

View

Pokročilá integrace

Vlastní možnosti vložení a API

View

Instalace je jednoduchá, ale výkonná! Nyní udělejte svůj web interaktivní! 🚀✨