Hur du lägger till Asyntai AI-chattbot i TYPO3

Steg-för-steg-guide för TYPO3-webbplatser

Plattform:

Steg 1: Hämta din inbäddningskod

Gå först till din Asyntai-instrumentpanel och scrolla ner till avsnittet "Inbäddningskod". Kopiera din unika inbäddningskod som ser ut så här:

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

Obs! Koden ovan är bara ett exempel. Du måste kopiera din egen unika inbäddningskod från din instrumentpanel eftersom den innehåller ditt personliga widget-ID.

Steg 2: Använda TypoScript footerData (rekommenderas)

Det enklaste sättet att lägga till chattboten på alla sidor är att använda TypoScript footerData:

Logga in på din TYPO3 Backend
Gå till Webb → Mall
Välj din rotsida i sidträdet
Klicka på "Edit the whole template record" (eller välj "Info/Modify" och sedan "Setup")
In the Setup field, add the following TypoScript code:
page.footerData.99 = TEXT page.footerData.99.value = <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Ersätt YOUR_WIDGET_ID med ditt faktiska widget-ID från instrumentpanelen
Klicka på "Spara"
Rensa TYPO3-cachen: Administrationsverktyg → Underhåll → Töm TYPO3 och PHP-cache

Tips: Att använda footerData placerar skriptet precis före den avslutande </body>-taggen, vilket rekommenderas för chattwidgetar eftersom det inte saktar ner sidladdningen.

Alternativ: Använda webbplatspaket (för webbplatspaket)

Om du använder ett webbplatspaket kan du lägga till skriptet via din TypoScript-konfigurationsfil:

Navigera till din webbplatspakemapp: packages/your_sitepackage/Configuration/TypoScript/
Öppna eller skapa setup.typoscript
Lägg till följande kod:
page.footerData { 99 = TEXT 99.value = <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> }
Ersätt YOUR_WIDGET_ID med ditt faktiska widget-ID
Rensa cachen i TYPO3:s backend

Alternativ: Använda Fluid-mall (FooterAssets)

For sites using Fluid templates, you can use the FooterAssets section:

Navigera till din Fluid-mallfil (vanligtvis i Resources/Private/Templates/)
Lägg till ett FooterAssets-avsnitt i din layout eller mall:
<f:section name="FooterAssets"> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </f:section>
Se till att din sidlayout renderar FooterAssets-avsnittet:
<f:render section="FooterAssets" optional="true" />
Rensa TYPO3-cachen

Viktigt: Funktionen FooterAssets kräver TYPO3 v8 eller senare. För äldre versioner, använd TypoScript footerData-metoden.

Alternativ: Använda AssetCollector (för utvecklare)

För tilläggsutvecklare erbjuder TYPO3 v10.3+ AssetCollector API:

I din PHP-kod (t.ex. en styrenhet eller mellanvara), injicera AssetCollector
Lägg till skriptet med anpassade attribut:
use TYPO3\CMS\Core\Page\AssetCollector; $this->assetCollector->addJavaScript( 'asyntai_chatbot', 'https://asyntai.com/static/js/chat-widget.js', ['async' => 'async', 'data-asyntai-id' => 'YOUR_WIDGET_ID'] );

Steg 3: Verifiera installationen

Efter att du har sparat dina ändringar och rensat cachen, besök din webbplats i en ny webbläsarflik eller ett inkognitofönster. Du bör se widgetknappen för chatten i det nedre högra hörnet. Klicka på den för att kontrollera att den öppnas och fungerar korrekt.

Ser du inte widgeten? Se till att rensa alla cacher: gå till Administratörsverktyg → Underhåll → Töm TYPO3 och PHP-cache. Prova också att rensa webbläsarens cache eller visa i ett inkognitofönster. Om du använder TypoScript, kontrollera att din mall är korrekt inkluderad i sidhierarkin.