Slik legger du til Asyntai AI-chatbot i Umbraco

Trinn-for-trinn-guide for Umbraco CMS-nettsteder

Hent innebyggingskode

Trinn 1: Hent innbyggingskoden din

Gå først til Asyntai-dashbordet ditt og bla ned til «Innbyggingskode»-seksjonen. Kopier din unike innbyggingskode som vil se slik ut:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Merk: Koden ovenfor er bare et eksempel. Du må kopiere din egen unike innbyggingskode fra Dashbordet ditt, da den inneholder din personlige widget-ID.

Trinn 2: Rediger Master-malen (anbefalt)

Den enkleste måten å legge til chatboten på alle sider er å redigere Master-malen din:

  1. Logg inn på Umbraco Backoffice
  2. Gå til Innstillinger i venstre sidefelt
  3. Utvid Maler
  4. Klikk på Master-malen din (eller hovedoppsettmalen nettstedet ditt bruker)
  5. Finn den avsluttende </body>-taggen
  6. Lim inn Asyntai-innbyggingskoden din rett før </body>-taggen
  7. Klikk på «Lagre»

Tips: Ved å legge til skriptet før den avsluttende </body>-taggen sikrer du at det lastes etter sideinnholdet, noe som anbefales for chatwidgeter og ikke vil bremse sidelastingen.

Alternativ: Bruk av dokumenttype for nettstedsinnstillinger

For mer fleksibilitet kan du legge til et egendefinert felt for å administrere bunntekstskript:

  1. Gå til Innstillinger → Dokumenttyper
  2. Rediger dokumenttypen Nettstedsinnstillinger (eller opprett en hvis den ikke finnes)
  3. Legg til en ny egenskap kalt «Footer Scripts» med datatypen Textarea
  4. Lagre dokumenttypen
  5. Gå til Innhold og rediger nettstedsinnstillinger-noden din
  6. Lim inn Asyntai-innbyggingskoden din i Bunntekstskript-feltet
  7. I Master-malen din, legg til denne koden før </body>:
    @Html.Raw(Model.Value("footerScripts"))
  8. Lagre både innholdet og malen

Merk: Bruk av @Html.Raw() er viktig for å gjengi skripttaggene riktig uten HTML-koding.

Alternativ: Bruk av skriptmappen

Du kan også opprette en JavaScript-fil i Umbraco Backoffice:

  1. Gå til Innstillinger → Skript
  2. Høyreklikk på Scripts og velg «Create»
  3. Opprett en ny fil kalt asyntai-chatbot.js
  4. Legg til følgende kode:
    (function() {
      var script = document.createElement('script');
      script.async = true;
      script.src = 'https://asyntai.com/static/js/chat-widget.js';
      script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
      document.body.appendChild(script);
    })();
  5. Erstatt YOUR_WIDGET_ID med din faktiske widget-ID
  6. Lagre filen
  7. Inkluder dette skriptet i Master-malen din før </body>:
    <script src="/scripts/asyntai-chatbot.js"></script>

Alternativ: Sidespesifikk med RenderSection

Hvis du bare vil ha chatboten på bestemte sider:

  1. I Master-malen din, legg til før </body>:
    @RenderSection("footerScripts", required: false)
  2. I den spesifikke sidemalen der du vil ha chatboten, legg til:
    @section footerScripts {
      <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
    }

Trinn 3: Bekreft installasjonen

Etter at du har lagret endringene, besøk nettstedet ditt i en ny nettleserfane eller i et inkognitovindu. Du bør se chat-widget-knappen nederst til høyre. Klikk på den for å forsikre deg om at den åpnes og fungerer riktig.

Ser du ikke widgeten? Forsikre deg om at du lagret malen etter at du gjorde endringer. Prøv å tømme nettleserbufferen eller se i et inkognitovindu. Hvis du bruker Umbraco Cloud, bør endringene distribueres automatisk. For selvhostet Umbraco kan det hende du må starte applikasjonen på nytt eller tømme bufferen.