Kā pievienot Asyntai MI tērzēšanas robotu DatoCMS
Soli pa solim ceļvedis DatoCMS vadītām tīmekļa vietnēm
Headless CMS: DatoCMS ir bezgalvas CMS, kas piegādā saturu caur API. Tērzēšanas robota kods jāpievieno jūsu priekšgala lietojumprogrammai (Next.js, Gatsby, Nuxt utt.), nevis DatoCMS vadības panelim.
1. solis: Iegūstiet savu iegulto kodu
Vispirms dodieties uz savu Asyntai vadības paneli un ritiniet uz leju līdz sadaļai "Iegultais kods". Nokopējiet savu unikālo iegulto kodu, kas izskatīsies šādi:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Piezīme: Iepriekš minētais kods ir tikai piemērs. Jums jānokopē savs unikālais iegultais kods no sava Vadības paneļa, jo tas satur jūsu personīgo logrīka ID.
2. solis: Pievienojiet Next.js priekšgalam (visbiežāk)
Next.js ir populārākais priekšgala ietvars, ko izmanto ar DatoCMS. Pievienojiet tērzēšanas robotu, izmantojot Script komponentu:
App Router (app/layout.tsx):
- Atveriet savu saknes izkārtojuma failu:
app/layout.tsx - Importējiet Script komponentu un pievienojiet tērzēšanas robotu:
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>
)
} - Aizstājiet
YOUR_WIDGET_IDar savu reālo logrīka ID - Saglabājiet failu un restartējiet izstrādes serveri
Pages Router (pages/_app.tsx):
- Atveriet savu
pages/_app.tsxfailu - Pievienojiet Script komponentu:
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"
/>
</>
)
}
Padoms: Izmantojot strategy="afterInteractive", tērzēšanas robots ielādējas uzreiz pēc tam, kad lapa kļūst interaktīva, nodrošinot labu līdzsvaru starp veiktspēju un pieejamību.
Alternatīvā metode 1: Gatsby priekšgals
Gatsby vietnēm, kas iegūst saturu no DatoCMS caur gatsby-source-datocms:
- Izveidojiet vai rediģējiet
gatsby-ssr.jssava projekta saknē: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"
/>
])
} - Aizstājiet
YOUR_WIDGET_IDar savu reālo logrīka ID - Restartējiet savu Gatsby izstrādes serveri
Alternatīvā metode 2: Nuxt.js priekšgals
Nuxt.js lietojumprogrammām, kas izmanto DatoCMS saturu:
- Pievienojiet savam
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'
}
]
}
}
}) - Aizstājiet
YOUR_WIDGET_IDar savu reālo logrīka ID - Restartējiet savu Nuxt izstrādes serveri
Alternatīvā metode 3: Vienkāršs HTML / Statiska vietne
Ja izmantojat DatoCMS satura piegādes API ar statisku HTML vietni vai statisku vietņu ģeneratoru:
- Pievienojiet iegulto kodu savam HTML failam pirms noslēdzošā
</body>taga:<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> - Aizstājiet
YOUR_WIDGET_IDar savu reālo logrīka ID - Saglabājiet failu un augšupielādējiet savā hostingā
Alternatīvā metode 4: React (Vite/CRA)
Standarta React lietotnēm (Create React App, Vite), kas patērē DatoCMS API:
A variants: Pievienot public/index.html
- Atveriet savu
public/index.htmlfailu (CRA) vaiindex.html(Vite) - Pievienojiet iegulto kodu pirms noslēdzošā
</body>taga:<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> - Saglabājiet failu
B variants: useEffect saknes komponentā
- Izveidojiet tērzēšanas bota komponentu vai pievienojiet savam saknes komponentam:
// 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
} - Importējiet un renderējiet komponentu savā
App.jsxvai saknes izkārtojumā
3. solis: Izvietojiet un pārbaudiet
Pēc tērzēšanas robota koda pievienošanas savai DatoCMS vadītajai vietnei izvietojiet vai palaidiet izstrādes serveri. Apmeklējiet savu tīmekļa vietni jaunā pārlūkprogrammas cilnē vai inkognito logā. Jums vajadzētu redzēt tērzēšanas logrīka pogu apakšējā labajā stūrī. Noklikšķiniet uz tās, lai pārliecinātos, ka tā atveras un darbojas pareizi.
Neredzat logrīku? Pārliecinieties, ka esat pievienojis skriptu pareizajam failam savam ietvaram. Pārbaudiet pārlūkprogrammas izstrādātāja konsoli, vai nav kļūdu. Ja izmantojat servera puses renderēšanu, pārliecinieties, ka skripts darbojas klienta pusē. Mēģiniet notīrīt pārlūkprogrammas kešatmiņu vai skatīt inkognito logā.
Vides mainīgie: Labākai drošībai un elastībai apsveriet iespēju glabāt savu logrīka ID vides mainīgajā (piemēram, NEXT_PUBLIC_ASYNTAI_ID Next.js vai VITE_ASYNTAI_ID Vite) nevis to iekodēt.
Weebly