Ajouter Olotalk à WordPress
WordPress n’a pas de boîte unique “custom code” ; les chemins fiables sont soit un plugin header/footer, soit le hook wp_footer.
Vous aurez besoin de votre Assistant ID (ast_oltk_...) depuis l’étape Installation de votre assistant. Nouveau ici ? Commencez par le Démarrage rapide.
Le plus simple : le plugin officiel Olotalk
- Dans wp-admin, ouvrez Extensions → Ajouter et recherchez Olotalk.
- Installez puis activez Olotalk Grounded AI Assistant.
- Ouvrez Réglages → Olotalk et cliquez sur Connect to Olotalk.
- Connectez-vous, confirmez le site et choisissez un assistant : l’identifiant d’assistant se remplit tout seul.
Aucun fichier de thème à toucher, rien à copier et aucun identifiant à retrouver. Le plugin conserve votre identifiant d’assistant ainsi que son nom d’affichage, et supprime les deux dès que vous désinstallez le plugin.
Ce que la connexion transmet
Avant de transmettre quoi que ce soit, Olotalk vous montre quel site demande l’accès et ce qu’il recevra exactement, c’est-à-dire l’identifiant et le nom d’affichage de l’assistant, et rien d’autre : ni accès au compte, ni clé d’API, ni aucun de vos contenus.
Si le domaine de ce site ne figure pas déjà dans votre compte Olotalk, un avertissement le nomme et vous devez confirmer que vous le reconnaissez avant de continuer. Dans tous les cas, Olotalk vous envoie un e-mail dès qu’une connexion aboutit, afin qu’une connexion que vous n’avez pas lancée ne passe pas inaperçue.
Si la connexion ne fonctionne pas
| Ce que vous voyez | Ce qui s’est passé | Que faire |
|---|---|---|
| Ce lien de connexion est incomplet ou mal formé | Le lien est arrivé chez Olotalk sans tout ce qu’il lui faut, le plus souvent parce qu’il a été ouvert depuis l’historique ou un e-mail au lieu d’être déclenché dans wp-admin. | Recommencez depuis Réglages → Olotalk. |
| Code de connexion expiré ou déjà utilisé | Une connexion reste valable quelques minutes et ne peut servir qu’une fois. | Cliquez de nouveau sur Connect to Olotalk. |
| Confirmez que vous reconnaissez le site | Le domaine ne figure dans aucun domaine de votre compte Olotalk. | Cochez la confirmation si le site vous appartient. Sinon, fermez la page : rien n’a encore été transmis. |
| L’adresse du site et celle de l’administration sont sur des domaines différents | L’adresse WordPress et l’adresse du site pointent vers des hôtes différents, ce qu’une connexion ne peut pas relier. | Collez plutôt l’identifiant d’assistant à la main. |
| Le bouton ne fait rien, ou le retour n’arrive jamais | Un plugin de sécurité, une couche SSO ou un hébergeur infogéré a bloqué la redirection. | Collez plutôt l’identifiant d’assistant à la main. |
Le rôle Administrateur est nécessaire pour se connecter comme pour modifier ces réglages, et le bouton reste masqué pour tous les autres.
Le champ d’identifiant d’assistant ne disparaît jamais. Les deux chemins aboutissent au même résultat, et coller l’identifiant reste le recours fiable. Depuis Réglages → Olotalk, vous pouvez aussi masquer complètement le bouton si vous préférez que votre équipe se contente de coller un identifiant.
Si vous ne souhaitez pas installer de plugin, ou si vous utilisez déjà un plugin de headers et footers, les méthodes manuelles ci-dessous fonctionnent tout aussi bien.
Alternative : un plugin headers & footers
Si vous préférez ne pas toucher aux fichiers du thème, installez un plugin qui injecte du HTML brut, par exemple WPCode ou Insert Headers and Footers.
- Installez et activez le plugin.
- Ouvrez ses réglages.
- Collez le snippet dans la zone Footer / Body, puis enregistrez :
<script
src="https://cdn.jsdelivr.net/npm/@olotalk/assistant-loader@0/dist/loader.iife.js"
data-olotalk-assistant-id="YOUR_ASSISTANT_ID"
async
></script>
Ces plugins rendent le snippet tel quel ; les attributs data-olotalk-* sont donc conservés.
Code du thème : le hook wp_footer
Si vous maintenez votre propre child theme ou plugin spécifique au site, ajoutez le loader sur wp_footer :
// functions.php (child theme ou plugin spécifique)
add_action( 'wp_footer', function () {
?>
<script
src="https://cdn.jsdelivr.net/npm/@olotalk/assistant-loader@0/dist/loader.iife.js"
data-olotalk-assistant-id="YOUR_ASSISTANT_ID"
async
></script>
<?php
} );
N’utilisez pas un simple wp_enqueue_script() pour le loader. L’assistant a besoin des attributs data-olotalk-* sur la balise <script> générée ; si vous l’enfilez manuellement, ajoutez-les avec le filtre script_loader_tag. Sinon, utilisez le snippet brut wp_footer ci-dessus ou un plugin header/footer.
Autoriser votre domaine
Ajoutez le domaine du site dans Domaines d’installation, sinon l’assistant reste invisible. Si vous publiez depuis une preview *.wordpress.com ou *.wpcomstaging.com, ajoutez-la aussi.
Si un plugin de cache active une option delay JavaScript execution, excluez olotalk.
Vérifier
Ouvrez le site publié et cherchez le launcher en bas à droite. Vérifiez ensuite votre tableau de bord : la carte État de l’installation de l’étape Installation affiche Détecté sur votredomaine.com dès que le snippet se charge, avec une correction en un clic si le domaine n’est pas encore autorisé. Rien ? Voir Dépannage.