Asyntai AI Chatbot'u Contentful'e Nasıl Eklersiniz
Contentful destekli web siteleri için adım adım kılavuz
Headless CMS: Contentful bir headless CMS'dir, yani API aracılığıyla içerik sağlar ancak yerleşik bir frontend içermez. Chatbot kurulumu, Contentful içeriğinizi render etmek için hangi frontend framework'ü kullandığınıza bağlıdır. Kurulumunuza uyan aşağıdaki yöntemi seçin.
Adım 1: Yerleştirme Kodunuzu Alın
Önce Asyntai Dashboard'unuza gidin ve "Yerleştirme Kodu" bölümüne inin. Şuna benzeyen benzersiz yerleştirme kodunuzu kopyalayın:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Not: Yukarıdaki kod yalnızca bir örnektir. Kişisel widget kimliğinizi içerdiğinden, kendi benzersiz yerleştirme kodunuzu Dashboard'unuzdan kopyalamanız gerekir.
Yöntem 1: Contentful ile Next.js (Önerilen)
Contentful içeriğinizi render etmek için Next.js kullanıyorsanız, Script bileşenini kullanarak chatbot'u ekleyin:
- Ana düzen dosyanızı açın:
app/layout.tsx(App Router) veyapages/_app.tsx(Pages Router) - Script bileşenini içe aktarın ve chatbot'u ekleyin:
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>
)
} - Replace
YOUR_WIDGET_IDwith your actual widget ID - Dosyayı kaydedin ve geliştirme sunucunuzu yeniden başlatın
İpucu: strategy="lazyOnload" kullanmak, chatbot'un sayfa tamamen etkileşimli hale geldikten sonra yüklenmesini sağlayarak en iyi performansı sunar.
Yöntem 2: Contentful ile Gatsby
Contentful'dan içerik çeken Gatsby siteleri için:
- gatsby-plugin-load-script yükleyin (isteğe bağlı ancak önerilir):
npm install gatsby-plugin-load-script gatsby-config.jsdosyanıza ekleyin: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
}
}
}
]
}- Alternatif olarak gatsby-ssr.js kullanın:
// 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"
/>
])
} - Gatsby geliştirme sunucunuzu yeniden başlatın
Yöntem 3: Contentful ile React
Contentful kullanan standart React uygulamaları (Create React App, Vite vb.) için:
public/index.htmldosyanızı açın- Add the embed code before the closing
</body>tag:<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> - Dosyayı kaydedin
Veya useEffect ile bir React bileşeni kullanın:
// 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
}
Yöntem 4: Contentful ile Vue/Nuxt
Contentful kullanan Vue veya Nuxt.js uygulamaları için:
Nuxt 3:
nuxt.config.tsdosyanıza ekleyin: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>
Yöntem 5: Contentful API ile Statik HTML
Contentful'un Content Delivery API'sini vanilla JavaScript ile kullanıyorsanız:
- Yerleştirme kodunu HTML dosyanızda kapanış
</body>etiketinin öncesine ekleyin:<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> - Dosyayı kaydedin ve barındırma hizmetinize yükleyin
Adım 2: Kurulumu Doğrulayın
Chatbot kodunu Contentful destekli sitenize ekledikten sonra dağıtın veya geliştirme sunucunuzu çalıştırın. Web sitenizi yeni bir tarayıcı sekmesinde veya gizli pencerede ziyaret edin. Sağ alt köşede sohbet widget'ı düğmesini görmeniz gerekir. Düzgün açıldığından ve çalıştığından emin olmak için tıklayın.
Widget'ı göremiyorsunuz mu? Komut dosyasını framework'ünüz için doğru dosyaya eklediğinizden emin olun. Tarayıcınızın geliştirici konsolunda hata olup olmadığını kontrol edin. Sunucu tarafı render kullanıyorsanız, komut dosyasının istemci tarafında çalıştığından emin olun. Tarayıcı önbelleğinizi temizlemeyi veya gizli pencerede görüntülemeyi deneyin.
Ortam Değişkenleri: Daha iyi güvenlik ve esneklik için widget kimliğinizi sabit kodlamak yerine bir ortam değişkeninde (örneğin, Next.js için NEXT_PUBLIC_ASYNTAI_ID) saklamayı düşünün.
Weebly