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 Tabloul de bord Asyntai și derulați în jos până la secțiunea "Cod de încorporare". Copiați codul unic de încorporare care va arăta astfel:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></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
For standard React apps (Create React App, Vite) consuming Strapi API:
- Deschideți fișierul
public/index.html(CRA) sauindex.html(Vite) - 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> - 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 - 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> - 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 integrare în fișierul HTML înainte de eticheta de închidere
</body>:<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></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