Atpakaļ uz informācijas paneli

Dokumentācija

Uzziniet, kā lietot Asyntai

Kā pievienot Asyntai AI tērzēšanas robotu Strapi

Soli pa solim ceļvedis Strapi darbinātām tīmekļa vietnēm

Iegūt iegulšanas kodu

Bezgalvas CMS: Strapi ir bezgalvas CMS, kas nodrošina saturu, izmantojot API, bet neietver iebūvētu priekšgalu. Tērzēšanas robota instalācija ir atkarīga no tā, kuru priekšgala ietvaru izmantojat Strapi satura atveidošanai. Izvēlieties tālāk aprakstīto metodi, kas atbilst jūsu konfigurācijai.

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.

1. metode: Next.js ar Strapi (ieteicams)

Ja izmantojat Next.js kā savu Strapi priekšgalu (visbiežākā konfigurācija), pievienojiet tērzēšanas robotu, izmantojot Script komponentu:

  1. Atveriet savu galveno izkārtojuma failu: app/layout.tsx (App Router) vai pages/_app.tsx (Pages Router)
  2. 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="lazyOnload"
            />
          </body>
        </html>
      )
    }
  3. Aizstājiet YOUR_WIDGET_ID ar savu reālo logrīka ID
  4. Saglabājiet failu un restartējiet izstrādes serveri

Padoms: Izmantojot strategy="lazyOnload", tiek nodrošināts, ka tērzēšanas robots tiek ielādēts pēc tam, kad lapa ir pilnībā interaktīva, nodrošinot labāko veiktspēju jūsu Strapi darbinātajai vietnei.

2. metode: Gatsby ar Strapi

Gatsby vietnēm, kas izmanto gatsby-source-strapi:

  1. Izveidojiet vai rediģējiet gatsby-ssr.js sava 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"
        />
      ])
    }
  2. Aizstājiet YOUR_WIDGET_ID ar savu reālo logrīka ID
  3. Restartējiet savu Gatsby izstrādes serveri

3. metode: Nuxt.js ar Strapi

Nuxt.js lietojumprogrammām, kas izmanto @nuxtjs/strapi:

Nuxt 3:

  1. 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'
            }
          ]
        }
      }
    })

Nuxt 2:

  1. Pievienojiet savam nuxt.config.js:
    export default {
      head: {
        script: [
          {
            src: 'https://asyntai.com/static/js/chat-widget.js',
            async: true,
            'data-asyntai-id': 'YOUR_WIDGET_ID'
          }
        ]
      }
    }

4. metode: React ar Strapi

Standarta React lietotnēm (Create React App, Vite), kas patērē Strapi API:

  1. Atveriet savu public/index.html failu (CRA) vai index.html (Vite)
  2. 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>
  3. Saglabājiet failu

Vai izveidojiet React komponentu:

// 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
}

5. metode: SvelteKit ar Strapi

SvelteKit lietojumprogrammām, kas patērē Strapi saturu:

  1. Rediģējiet savu src/app.html failu
  2. 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>
  3. Saglabājiet failu

6. metode: Statiska vietne ar Strapi API

Ja izmantojat Strapi REST vai GraphQL API ar statisku HTML vietni:

  1. 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>
  2. Saglabājiet failu un augšupielādējiet savā hostingā

2. solis: Pārbaudiet instalēšanu

Pēc tērzēšanas robota koda pievienošanas savai Strapi darbinātajai vietnei izvietojiet vai palaidiet izstrādes serveri. Apmeklējiet savu tīmekļa vietni jaunā pārlūkprogrammas cilnē vai inkognito logā. Apakšējā labajā stūrī vajadzētu redzēt tērzēšanas logrīka pogu. 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.