Hoe voegt u de Asyntai AI Chatbot toe aan Umbraco

Stap-voor-stap handleiding voor Umbraco CMS-websites

Insluitcode ophalen

Stap 1: Uw insluitcode ophalen

Ga eerst naar uw Asyntai Dashboard en scroll naar het gedeelte "Insluitcode". Kopieer uw unieke insluitcode die er als volgt uitziet:

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

Opmerking: De bovenstaande code is slechts een voorbeeld. U moet uw eigen unieke insluitcode kopiëren vanuit uw Dashboard omdat deze uw persoonlijke widget-ID bevat.

Stap 2: Master Template bewerken (aanbevolen)

De eenvoudigste manier om de chatbot aan alle pagina's toe te voegen is door uw Master-template te bewerken:

  1. Log in op uw Umbraco Backoffice
  2. Ga naar Settings in de linkerzijbalk
  3. Vouw Templates uit
  4. Klik op uw Master-template (of de hoofdlayouttemplate die uw site gebruikt)
  5. Zoek de afsluitende </body>-tag
  6. Plak uw Asyntai-insluitcode net vóór de </body>-tag
  7. Klik op "Save"

Tip: Het toevoegen van het script vóór de afsluitende </body>-tag zorgt ervoor dat het na de pagina-inhoud wordt geladen, wat aanbevolen is voor chatwidgets en het laden van uw pagina niet vertraagt.

Alternatief: Site Settings Document Type gebruiken

Voor meer flexibiliteit kunt u een aangepast veld toevoegen om footerscripts te beheren:

  1. Ga naar Settings → Document Types
  2. Bewerk uw Site Settings documenttype (of maak er een aan als het niet bestaat)
  3. Voeg een nieuwe eigenschap toe genaamd "Footer Scripts" met een Textarea-gegevenstype
  4. Sla het Document Type op
  5. Ga naar Content en bewerk uw Site Settings-knooppunt
  6. Plak uw Asyntai-insluitcode in het veld Footer Scripts
  7. Voeg in uw Master-template deze code toe vóór </body>:
    @Html.Raw(Model.Value("footerScripts"))
  8. Sla zowel de inhoud als de template op

Opmerking: Het gebruik van @Html.Raw() is belangrijk om de scripttags correct weer te geven zonder HTML-codering.

Alternatief: Scripts-map gebruiken

U kunt ook een JavaScript-bestand aanmaken in de Umbraco Backoffice:

  1. Ga naar Settings → Scripts
  2. Klik met de rechtermuisknop op Scripts en selecteer "Create"
  3. Create a new file called asyntai-chatbot.js
  4. Voeg de volgende code toe:
    (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. Vervang YOUR_WIDGET_ID door uw werkelijke widget-ID
  6. Sla het bestand op
  7. Voeg dit script toe in uw Master-template vóór </body>:
    <script src="/scripts/asyntai-chatbot.js"></script>

Alternatief: Paginaspecifiek met RenderSection

Als u de chatbot alleen op specifieke pagina's wilt:

  1. Voeg in uw Master-template het volgende toe vóór </body>:
    @RenderSection("footerScripts", required: false)
  2. In the specific page template where you want the chatbot, add:
    @section footerScripts {
      <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
    }

Stap 3: Installatie verifiëren

Bezoek na het opslaan van uw wijzigingen uw website in een nieuw browsertabblad of incognitovenster. U zou de chatwidgetknop rechtsonder in de hoek moeten zien. Klik erop om te controleren of deze correct opent en werkt.

Ziet u de widget niet? Zorg ervoor dat u de template hebt opgeslagen na het aanbrengen van wijzigingen. Probeer uw browsercache te wissen of bekijk de pagina in een incognitovenster. Als u Umbraco Cloud gebruikt, worden wijzigingen automatisch uitgerold. Voor zelf gehoste Umbraco moet u mogelijk de applicatie herstarten of de cache wissen.