Cum să adăugați Chatbot-ul AI Asyntai în Strapi
Ghid pas cu pas pentru site-urile bazate pe Strapi
CMS Headless: Strapi este un CMS headless care furnizează conținut prin API, dar nu include un frontend integrat. Instalarea chatbot-ului depinde de framework-ul frontend pe care îl utilizați pentru a reda conținutul Strapi. Alegeți metoda de mai jos care corespunde configurației dvs.
Pasul 1: Obțineți codul de încorporare
Mai întâi, accesați panoul de control Asyntai și derulați în jos până la secțiunea "Cod de integrare". Copiați codul dvs. unic de integrare, care va arăta astfel:
<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>
Notă: Codul de mai sus este doar un exemplu. Trebuie să copiați propriul cod unic de încorporare din Tabloul de bord, deoarece conține ID-ul personal al widgetului dvs.
Metoda 1: Next.js cu Strapi (Recomandat)
Dacă utilizați Next.js ca frontend Strapi (cea mai frecventă configurație), adăugați chatbot-ul folosind componenta Script:
- Deschideți fișierul de layout principal:
app/layout.tsx(App Router) saupages/_app.tsx(Pages Router) - Importați componenta Script și adăugați chatbot-ul:
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>
)
} - Înlocuiți
YOUR_WIDGET_IDcu ID-ul real al widget-ului dvs. - Salvați fișierul și reporniți serverul de dezvoltare
Sfat: Utilizarea strategy="lazyOnload" asigură că chatbot-ul se încarcă după ce pagina este complet interactivă, oferind cea mai bună performanță pentru site-ul bazat pe Strapi.
Metoda 2: Gatsby cu Strapi
Pentru site-urile Gatsby care utilizează gatsby-source-strapi:
- Creați sau editați
gatsby-ssr.jsîn rădăcina proiectului: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"
/>
])
} - Înlocuiți
YOUR_WIDGET_IDcu ID-ul real al widget-ului dvs. - Reporniți serverul de dezvoltare Gatsby
Metoda 3: Nuxt.js cu Strapi
Pentru aplicații Nuxt.js care utilizează @nuxtjs/strapi:
Nuxt 3:
- Adăugați în
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'
}
]
}
}
})
Nuxt 2:
- Adăugați în
nuxt.config.js:export default {
head: {
script: [
{
src: 'https://asyntai.com/static/js/chat-widget.js',
async: true,
'data-asyntai-id': 'YOUR_WIDGET_ID'
}
]
}
}
Metoda 4: React cu Strapi
Pentru aplicații React standard (Create React App, Vite) care consumă API-ul Strapi:
- Deschideți fișierul
public/index.html(CRA) sauindex.html(Vite) - Adăugați codul de încorporare înainte de eticheta de închidere
</body><script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script> - Salvați fișierul
Sau creați o componentă React:
// 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 5: SvelteKit cu Strapi
Pentru aplicații SvelteKit care consumă conținut Strapi:
- Editați fișierul
src/app.html - Adăugați codul de încorporare înainte de eticheta de închidere
</body><script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script> - Salvați fișierul
Metoda 6: Site static cu API-ul Strapi
Dacă utilizați API-ul REST sau GraphQL al Strapi cu un site HTML static:
- Adăugați codul de încorporare în fișierul HTML înainte de eticheta de închidere
</body>:<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script> - Salvați fișierul și încărcați-l pe hostingul dvs.
Pasul 2: Verificați instalarea
După ce ați adăugat codul chatbot-ului pe site-ul bazat pe Strapi, implementați sau rulați serverul de dezvoltare. Vizitați site-ul într-o filă nouă de browser sau într-o fereastră incognito. Ar trebui să vedeți butonul widget-ului de chat în colțul din dreapta jos. Faceți clic pe el pentru a vă asigura că se deschide și funcționează corect.
Nu vedeți widgetul? Asigurați-vă că ați adăugat scriptul în fișierul corect pentru framework-ul dvs. Verificați consola de dezvoltare a browserului pentru eventuale erori. Dacă utilizați randare pe server, asigurați-vă că scriptul rulează pe partea de client. Încercați să goliți cache-ul browserului sau să vizualizați într-o fereastră incognito.
Variabile de mediu: Pentru o securitate și flexibilitate mai bune, luați în considerare stocarea ID-ului widget-ului într-o variabilă de mediu (de ex., NEXT_PUBLIC_ASYNTAI_ID pentru Next.js sau VITE_ASYNTAI_ID pentru Vite) în loc să îl codificați direct.
Weebly