Comment ajouter le chatbot IA Asyntai à TYPO3
Guide étape par étape pour les sites TYPO3
Étape 1 : Obtenir votre code d'intégration
Tout d'abord, rendez-vous sur votre Tableau de bord Asyntai et faites défiler jusqu'à la section « Code d'intégration ». Copiez votre code d'intégration unique qui ressemblera à ceci :
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Note : Le code ci-dessus n'est qu'un exemple. Vous devez copier votre propre code d'intégration depuis votre Tableau de bord car il contient votre identifiant de widget personnel.
Étape 2 : Utiliser le footerData TypoScript (recommandé)
La façon la plus simple d'ajouter le chatbot à toutes les pages est d'utiliser TypoScript footerData :
- Connectez-vous à votre back-office TYPO3
- Accédez à Web → Modèle
- Sélectionnez votre page racine dans l'arborescence des pages
- Cliquez sur « Modifier l'ensemble de l'enregistrement du modèle » (ou sélectionnez « Info/Modifier » puis « Configuration »)
- 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> - Remplacez
YOUR_WIDGET_IDpar votre identifiant de widget réel depuis le tableau de bord - Cliquez sur "Save"
- Videz le cache TYPO3 : Admin Tools → Maintenance → Flush TYPO3 and PHP Cache
Astuce : L'utilisation de footerData place le script juste avant la balise fermante </body>, ce qui est recommandé pour les widgets de chat car cela ne ralentira pas le chargement de votre page.
Alternative : Utilisation d'un Site Package (pour les Site Packages)
Si vous utilisez un package de site, vous pouvez ajouter le script via votre fichier de configuration TypoScript :
- Accédez au dossier de votre package de site :
packages/your_sitepackage/Configuration/TypoScript/ - Ouvrez ou créez setup.typoscript
- Ajoutez le code suivant :
page.footerData {
99 = TEXT
99.value = <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
} - Replace
YOUR_WIDGET_IDwith your actual widget ID - Videz le cache dans le backend TYPO3
Alternative : Utilisation du template Fluid (FooterAssets)
For sites using Fluid templates, you can use the FooterAssets section:
- Accédez à votre fichier de modèle Fluid (généralement dans
Resources/Private/Templates/) - Ajoutez une section FooterAssets dans votre mise en page ou 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> - Assurez-vous que votre mise en page rend la section FooterAssets :
<f:render section="FooterAssets" optional="true" /> - Videz le cache TYPO3
Important : La fonctionnalité FooterAssets nécessite TYPO3 v8 ou une version ultérieure. Pour les versions plus anciennes, utilisez la méthode TypoScript footerData.
Alternative : Utilisation d'AssetCollector (pour les développeurs)
For extension developers, TYPO3 v10.3+ offers the AssetCollector API:
- Dans votre code PHP (par exemple, un contrôleur ou un middleware), injectez l'AssetCollector
- Ajoutez le script avec des attributs personnalisés :
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']
);
Étape 3 : Vérifier l'installation
Après avoir enregistré vos modifications et vidé le cache, visitez votre site web dans un nouvel onglet de navigateur ou en navigation privée. Vous devriez voir le bouton du widget de chat dans le coin inférieur droit. Cliquez dessus pour vérifier qu'il s'ouvre et fonctionne correctement.
Vous ne voyez pas le widget ? Assurez-vous de vider tous les caches : allez dans Admin Tools → Maintenance → Flush TYPO3 and PHP Cache. Essayez également de vider le cache de votre navigateur ou de consulter le site dans une fenêtre de navigation privée. Si vous utilisez TypoScript, vérifiez que votre modèle est correctement inclus dans la hiérarchie des pages.
Weebly