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

  1. Dans wp-admin, ouvrez Extensions → Ajouter et recherchez Olotalk.
  2. Installez puis activez Olotalk Grounded AI Assistant.
  3. Ouvrez Réglages → Olotalk et cliquez sur Connect to Olotalk.
  4. 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 voyezCe 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 siteLe 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érentsL’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 jamaisUn 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.

  1. Installez et activez le plugin.
  2. Ouvrez ses réglages.
  3. 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.

<html>
<head> … </head>
<body>
… your page …
cible<script src="…/loader.iife.js" data-olotalk-assistant-id="…" async></script>
</body>
</html>
Collez le snippet dans la zone Footer / Body du plugin. Quel que soit l'endroit prévu par la plateforme, l'objectif reste le même : il se charge juste avant la balise body de fermeture.

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.