Jak přidat Asyntai AI Chatbota na Contentful
Průvodce krok za krokem pro weby postavené na Contentful
Headless CMS: Contentful je headless CMS, což znamená, že poskytuje obsah přes API, ale neobsahuje vestavěný frontend. Instalace chatbota závisí na tom, jaký frontend framework používáte pro vykreslování obsahu z Contentful. Zvolte níže metodu, která odpovídá vašemu nastavení.
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.
Metoda 1: Next.js s Contentful (doporučeno)
Pokud používáte Next.js pro vykreslování obsahu z Contentful, přidejte chatbota pomocí komponenty Script:
- Otevřete svůj hlavní layout soubor:
app/layout.tsx(App Router) nebopages/_app.tsx(Pages Router) - Importujte komponentu Script a přidejte chatbota:
import Script from 'next/script'
export default function RootLayout({ children }) {
return (
<html>
<body>
{children}
<Script
src="https://asyntai.com/static/js/chat-widget.js"
data-asyntai-id="YOUR_WIDGET_ID"
strategy="lazyOnload"
/>
</body>
</html>
)
} - Nahraďte
YOUR_WIDGET_IDsvým skutečným ID widgetu - Uložte soubor a restartujte vývojový server
Tip: Použití strategy="lazyOnload" zajistí, že se chatbot načte až poté, co je stránka plně interaktivní, což poskytuje nejlepší výkon.
Metoda 2: Gatsby s Contentful
Pro Gatsby weby čerpající obsah z Contentful:
- Nainstalujte gatsby-plugin-load-script (volitelné, ale doporučené):
npm install gatsby-plugin-load-script - Přidejte do svého
gatsby-config.js:module.exports = {
plugins: [
{
resolve: 'gatsby-plugin-load-script',
options: {
src: 'https://asyntai.com/static/js/chat-widget.js',
attributes: {
'data-asyntai-id': 'YOUR_WIDGET_ID',
async: true
}
}
}
]
} - Alternativně použijte gatsby-ssr.js:
// gatsby-ssr.js
import React from 'react'
export const onRenderBody = ({ setPostBodyComponents }) => {
setPostBodyComponents([
<script
key="asyntai-chatbot"
async
src="https://asyntai.com/static/js/chat-widget.js"
data-asyntai-id="YOUR_WIDGET_ID"
/>
])
} - Restartujte vývojový server Gatsby
Metoda 3: React s Contentful
Pro standardní React aplikace (Create React App, Vite atd.) používající Contentful:
- Otevřete soubor
public/index.html - Přidejte embed kód před uzavírací značku
</body>:<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> - Uložte soubor
Nebo použijte React komponentu s useEffect:
// components/Chatbot.jsx
import { useEffect } from 'react'
export default function Chatbot() {
useEffect(() => {
const script = document.createElement('script')
script.src = 'https://asyntai.com/static/js/chat-widget.js'
script.async = true
script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID')
document.body.appendChild(script)
return () => document.body.removeChild(script)
}, [])
return null
}
Metoda 4: Vue/Nuxt s Contentful
Pro aplikace Vue nebo Nuxt.js používající Contentful:
Nuxt 3:
- Přidejte do svého
nuxt.config.ts:export default defineNuxtConfig({
app: {
head: {
script: [
{
src: 'https://asyntai.com/static/js/chat-widget.js',
async: true,
'data-asyntai-id': 'YOUR_WIDGET_ID'
}
]
}
}
})
Vue 3:
- Add to your
index.htmlbefore</body>:<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Metoda 5: Statické HTML s Contentful API
Pokud používáte Content Delivery API Contentful s čistým JavaScriptem:
- Přidejte embed kód do svého HTML souborů před uzavírací značku
</body>:<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> - Uložte soubor a nahrajte na hosting
Krok 2: Ověření instalace
Po přidání kódu chatbota na váš web postavený na Contentful proveďte nasazení nebo spusťte vývojový server. Navštivte svůj web v nové záložce prohlížeče nebo v anonymním okně. V pravém dolním rohu byste měli vidět tlačítko chatovací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 skript přidali do správného souborů pro váš framework. Zkontrolujte vývojářskou konzoli prohlížeče, zda nejsou chyby. Pokud používáte server-side rendering, zajistěte, aby se skript spouštěl na straně klienta. Zkuste vymazat mezipaměť prohlížeče nebo zobrazit stránku v anonymním okně.
Proměnné prostředí: Pro lepší zabezpečení a flexibilitu zvažte uložení ID widgetu do proměnné prostředí (např. NEXT_PUBLIC_ASYNTAI_ID pro Next.js) namísto jeho pevného zadání do kódu.
Weebly