Jak přidat Asyntai AI chatbota do Umbraco
Průvodce krok za krokem pro weby Umbraco CMS
Krok 1: Získejte svůj vkládací kód
Nejprve přejděte na svůj Asyntai Dashboard a přejděte dolů k sekci „Embed Code". Zkopírujte svůj unikátní kód pro vložení, který bude vypadat takto:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Poznámka: Kód výše je pouze příklad. Musíte zkopírovat svůj vlastní unikátní kód pro vložení z vašeho Dashboardu, protože obsahuje vaše osobní ID widgetu.
Krok 2: Úprava hlavní šablony (doporučeno)
Nejjednodušší způsob, jak přidat chatbota na všechny stránky, je úprava hlavní šablony:
- Přihlaste se do svého backoffice Umbraco
- Přejděte na Settings v levém postranním panelu
- Rozbalte Šablony
- Klikněte na svou šablonu Master (nebo hlavní šablonu layoutu, kterou váš web používá)
- Najděte uzavírací značku
</body> - Vložte svůj Asyntai embed kód těsně před značku
</body> - Klikněte na "Save"
Tip: Přidání skriptů před uzavírací značku </body> zajistí, že se načte po obsahu stránky, což je doporučeno pro chatovací widgety a nezpomalí načítání stránky.
Alternativa: Použití typu dokumentu Nastavení webu
Pro větší flexibilitu můžete přidat vlastní pole pro správu skriptů v zápatí:
- Přejděte na Settings → Document Types
- Upravte typ dokumentu Site Settings (nebo vytvořte nový, pokud neexistuje)
- Přidejte novou vlastnost s názvem "Footer Scripts" s datovým typem Textarea
- Uložte typ dokumentu
- Přejděte na Content a upravte uzel Site Settings
- Vložte kód Asyntai do pole Footer Scripts
- Ve své hlavní šabloně přidejte tento kód před
</body>:@Html.Raw(Model.Value("footerScripts")) - Uložte obsah i šablonu
Poznámka: Použití @Html.Raw() je důležité pro správné vykreslení značek script bez HTML kódování.
Alternativa: Použití složky Scripts
Můžete také vytvořit soubor JavaScript v Umbraco Backoffice:
- Přejděte na Settings → Scripts
- Klikněte pravým tlačítkem na Scripts a vyberte "Create"
- Vytvořte nový soubor s názvem asyntai-chatbot.js
- Přidejte následující kód:
(function() {
var script = document.createElement('script');
script.async = true;
script.src = 'https://asyntai.com/static/js/chat-widget.js';
script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
document.body.appendChild(script);
})(); - Nahraďte
YOUR_WIDGET_IDsvým skutečným ID widgetu - Uložte soubor
- Vložte tento skript do hlavní šablony před
</body>:<script src="/scripts/asyntai-chatbot.js"></script>
Alternativa: Pro konkrétní stránku s RenderSection
Pokud chcete chatbota pouze na konkrétních stránkách:
- Ve své hlavní šabloně přidejte před
</body>:@RenderSection("footerScripts", required: false) - Do šablony konkrétní stránky, kde chcete chatbota, přidejte:
@section footerScripts {
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
}
Krok 3: Ověřte instalaci
Po uložení změn navštivte svůj web v nové kartě prohlížeče nebo v anonymním okne. V pravém dolním rohu byste měli vidět tlačítko chatového widgetu. Klikněte na něj a ověřte, že se správně otevírá a funguje.
Nevidíte widget? Ujistěte se, že jste po provedení změn šablonu uložili. Zkuste vymazat mezipaměť prohlížeče nebo stránku zobrazit v anonymním okně. Pokud používáte Umbraco Cloud, změny by se měly nasadit automaticky. U samostatně hostovaného Umbraco možná budete muset restartovat aplikaci nebo vymazat mezipaměť.
Weebly