Come aggiungere il chatbot IA Asyntai a TYPO3

Piattaforma:

TYPO3

HTML/Custom WordPress Shopify WooCommerce BigCommerce Ecwid Wix Squarespace Webflow Weebly HubSpot Tilda Adobe Experience Manager Duda Google Sites Bludit Plesk Concrete CMS Craft CMS Contentful Docusaurus Strapi Joomla Kentico Drupal Magento Blogger Bitrix TYPO3 PrestaShop OpenCart Ghost Hugo Statamic Umbraco Volusion Moodle SilverStripe Grav October CMS ProcessWire Sanity ExpressionEngine Sylius Backdrop CMS MODX Bagisto PayloadCMS e107 CrafterCMS Kirby MedusaCMS DatoCMS GoDaddy Framer Bubble Carrd Jimdo Strikingly Kajabi Teachable Thinkific ClickFunnels Hostinger Unbounce Leadpages Systeme.io Instapage

Passaggio 1: ottieni il tuo codice di incorporamento

Per prima cosa, vai alla tua Dashboard Asyntai e scorri fino alla sezione "Codice di incorporamento". Copia il tuo codice di incorporamento univoco che apparirà così:

Passaggio 2: Utilizzo di TypoScript footerData (consigliato)

Il modo più semplice per aggiungere il chatbot a tutte le pagine è utilizzare TypoScript footerData:

1. Accedi al tuo Backend TYPO3
2. Vai su Web → Template
3. Seleziona la tua pagina root nell'albero delle pagine
4. Clicca su "Edit the whole template record" (oppure seleziona "Info/Modify" e poi "Setup")
5. 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>
6. Sostituisci YOUR_WIDGET_ID con l'ID widget effettivo dalla dashboard
7. Clicca su "Save"
8. Svuota la cache di TYPO3: Admin Tools → Maintenance → Flush TYPO3 and PHP Cache

Alternativa: Utilizzo del Site Package (per Site Package)

Se stai utilizzando un site package, puoi aggiungere lo script tramite il file di configurazione TypoScript:

1. Naviga nella cartella del tuo site package: packages/your_sitepackage/Configuration/TypoScript/
2. Apri o crea setup.typoscript
3. Aggiungi il seguente codice:
   page.footerData {
  99 = TEXT
  99.value = <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
}
4. Sostituisci YOUR_WIDGET_ID con il tuo ID widget effettivo
5. Svuota la cache nel backend di TYPO3

Alternativa: Utilizzo del template Fluid (FooterAssets)

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

1. Naviga al file del tuo template Fluid (di solito in Resources/Private/Templates/)
2. Aggiungi una sezione FooterAssets nel tuo layout o template:
   <f:section name="FooterAssets">
  <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
</f:section>
3. Make sure your page layout renders the FooterAssets section:
   <f:render section="FooterAssets" optional="true" />
4. Svuota la cache di TYPO3

Alternativa: Utilizzo di AssetCollector (per sviluppatori)

For extension developers, TYPO3 v10.3+ offers the AssetCollector API:

1. Nel tuo codice PHP (ad esempio un controller o un middleware), inietta l'AssetCollector
2. Aggiungi lo script con attributi personalizzati:
   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']
);

Passaggio 3: verifica l'installazione

Dopo aver salvato le modifiche e svuotato la cache, visita il tuo sito web in una nuova scheda del browser o in una finestra di navigazione in incognito. Dovresti vedere il pulsante del widget chat nell'angolo in basso a destra. Cliccaci sopra per assicurarti che si apra e funzioni correttamente.