Kuidas lisada Asyntai tehisintellekti vestlusrobot DatoCMS-ile
Samm-sammuline juhend DatoCMS-i toega veebisaitide jaoks
Peata CMS: DatoCMS on peata CMS, mis edastab sisu API-de kaudu. Vestlusroboti kood tuleb lisada teie kasutajaliidese rakendusse (Next.js, Gatsby, Nuxt jne), mitte DatoCMS-i juhtpaneelile.
1. samm: hankige oma manuskood
Esmalt minge oma Asyntai juhtpaneelile ja kerige alla jaotiseni "Manuskood". Kopeerige oma unikaalne manuskood, mis näeb välja selline:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Märkus: Ülalolev kood on vaid näide. Peate kopeerima oma unikaalse manuskoodi oma juhtpaneelilt, kuna see sisaldab teie isiklikku vidina ID-d.
2. samm: Lisage Next.js kasutajaliidesse (kõige levinum)
Next.js on kõige populaarsem kasutajaliidese raamistik, mida kasutatakse DatoCMS-iga. Lisage vestlusrobot Script komponendi abil:
App Router (app/layout.tsx):
- Avage oma juurpaigutuse fail:
app/layout.tsx - Importige skriptikomponent ja lisage vestlusrobot:
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="afterInteractive"
/>
</body>
</html>
)
} - Asendage
YOUR_WIDGET_IDoma tegeliku vidina ID-ga - Salvestage fail ja taaskäivitage oma arendusserver
Pages Router (pages/_app.tsx):
- Avage oma fail
pages/_app.tsx - Lisage Script komponent:
import Script from 'next/script'
import type { AppProps } from 'next/app'
export default function App({ Component, pageProps }: AppProps) {
return (
<>
<Component {...pageProps} />
<Script
src="https://asyntai.com/static/js/chat-widget.js"
data-asyntai-id="YOUR_WIDGET_ID"
strategy="afterInteractive"
/>
</>
)
}
Vihje: Kasutades strategy="afterInteractive" tagatakse, et vestlusrobot laadib kohe pärast lehe interaktiivseks muutumist, pakkudes head tasakaalu jõudluse ja kättesaadavuse vahel.
Alternatiivne meetod 1: Gatsby kasutajaliides
Gatsby saitidele, mis tõmbavad sisu DatoCMS-ist gatsby-source-datocms kaudu:
- Looge või muutke
gatsby-ssr.jsoma projekti juurkaustas: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"
/>
])
} - Asendage
YOUR_WIDGET_IDoma tegeliku vidina ID-ga - Taaskäivitage oma Gatsby arendusserver
Alternatiivne meetod 2: Nuxt.js kasutajaliides
Nuxt.js rakenduste jaoks, mis tarbivad DatoCMS-i sisu:
- Lisage oma faili
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'
}
]
}
}
}) - Asendage
YOUR_WIDGET_IDoma tegeliku vidina ID-ga - Taaskäivitage oma Nuxt arendusserver
Alternatiivne meetod 3: tavaline HTML / staatiline sait
Kui kasutate DatoCMS-i sisuedastuse API-t staatilise HTML-saidi või staatilise saidi generaatoriga:
- Lisage manuskood oma HTML-faili enne sulgevat
</body>silti:<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> - Asendage
YOUR_WIDGET_IDoma tegeliku vidina ID-ga - Salvestage fail ja laadige oma hostingusse üles
Alternatiivne meetod 4: React (Vite/CRA)
Standardsete React rakenduste jaoks (Create React App, Vite), mis kasutavad DatoCMS API-t:
Valik A: lisage faili public/index.html
- Avage oma fail
public/index.html(CRA) võiindex.html(Vite) - Lisage manuskood enne sulgevat
</body>silti:<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> - Salvestage fail
Valik B: useEffect juurkomponendis
- Looge vestlusroboti komponent või lisage juurkomponenti:
// 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
} - Importige ja renderdage komponent oma
App.jsxfailis või juurpaigutuses
3. samm: Juurutage ja kontrollige
Pärast vestlusroboti koodi lisamist oma DatoCMS-iga toetatud saidile juurutage või käivitage oma arendusserver. Külastage oma veebisaiti uues brauseri vahekaardil või inkognito aknas. Peaksite nägema vestlusvidina nuppu alumises paremas nurgas. Klõpsake sellel, et veenduda, et see avaneb ja töötab korrektselt.
Ei näe vidinat? Veenduge, et lisasite skripti õigesse faili oma raamistiku jaoks. Kontrollige brauseri arenduskonsooli vigade suhtes. Serveripoolse renderdamise kasutamisel veenduge, et skript käivitub kliendi poolel. Proovige brauseri vahemälu tühjendada või vaadata inkognito aknas.
Keskkonnamuutujad: Parema turvalisuse ja paindlikkuse tagamiseks kaaluge oma vidina ID salvestamist keskkonnamuutujasse (nt NEXT_PUBLIC_ASYNTAI_ID Next.js-i jaoks või VITE_ASYNTAI_ID Vite jaoks) selle asemel, et see otse koodi kirjutada.
Weebly