Où l’assistant apparaît

Olotalk reste un seul assistant : il répond à partir de votre contenu, cite ses sources et refuse honnêtement quand votre contenu ne couvre pas la question. Cela ne change jamais.

Ce qui change, c’est la forme qu’il prend sur votre page. Le même assistant peut être un lanceur dans un coin ou un panneau dans votre propre mise en page. Vous choisissez la forme par la manière dont vous posez le snippet ; vous ne configurez pas un autre produit.

Bulle en coin
Lanceur flottant dans un coin. Toutes les pages, zéro décision de mise en page.
Inline
Un bloc placé dans votre propre balisage. Une page à forte intention.

Les formes disponibles aujourd’hui

Trois formes sont proposées aux nouvelles installations : Corner bubble, Drawer et Select to ask. Tout le reste de ce tableau continue de fonctionner et reste pris en charge pour les assistants qui l’utilisent déjà ; ces formes ne sont simplement plus proposées depuis le tableau de bord tant que l’offre reste resserrée. Launcher with starters n’est d’ailleurs pas une forme distincte, puisqu’il s’agit de ce que le lanceur du coin affiche au survol.

FormeApparenceBon pour
Corner bubbleUn lanceur flottant, dans le coin inférieur, qui ouvre un panneau de chatToutes les pages, sans décision de mise en page
Launcher with startersLe lanceur du coin, qui propose des questions suggérées au survolLes sites où les visiteurs ne savent pas quoi demander, fait partie de Corner bubble
InlineUn panneau de chat placé dans un conteneur de votre propre markupUne page à forte intention : pricing, contact, documentation, installations existantes uniquement
DrawerPleine hauteur, collé au bord, en repoussant la page quand la place le permetUn bouton « Ask AI » délibéré, placé par vos soins
⌘K panelCentré au-dessus d’une page assombrie, ouvert par un raccourci clavierLes audiences techniques qui ont déjà le réflexe ⌘K, installations existantes uniquement
Corner panelLe panneau de la bulle de coin, sans rien sur la page au reposLes sites qui veulent l’assistant accessible mais invisible tant qu’on ne le demande pas, installations existantes uniquement
Centred panelLe panneau ⌘K, ouvert par votre propre contrôle plutôt que par la toucheLa même expérience centrée, sans revendiquer de raccourci clavier, installations existantes uniquement
Expand in placeUne ligne dans votre texte qui se déplie en assistant, en poussant le contenuUne FAQ ou une doc, où un panneau serait de trop, installations existantes uniquement
AnchoredÀ côté d’un élément, sans jamais le recouvrirUn plan tarifaire ou une ligne de specs, avec le contexte de cet élément, installations existantes uniquement
Full pageL’assistant est la pageUne route /ask dédiée, installations existantes uniquement
Docked sidebarUn rail fixe le long d’un bord, toujours ouvertLa documentation, où il accompagne au lieu d’interrompre, installations existantes uniquement
Nav ask fieldVotre propre champ de navigation, relié à l’assistantLe rendre trouvable sans ajouter de chrome, installations existantes uniquement
Bottom ask barVotre propre barre au pied de la pageLes documents longs, installations existantes uniquement
Select to askRien au repos, une offre apparaît là où un visiteur surligne du texteLe contenu de référence, où la question porte sur ce passage

Toutes utilisent le même bundle, à une ligne de configuration près (~266 KB gzippés), la même conversation, le même ancrage, les mêmes citations. Seul le montage change.

La plupart s’installent depuis le dashboard ; six se câblent en code. L’étape Installation génère un snippet complet pour chaque forme qui n’exige de vous qu’une balise script : corner bubble, launcher with starters, inline, expand in place, docked sidebar, full page, ⌘K et select to ask.

Les six autres s’attachent à quelque chose que vous seul pouvez désigner, dont les deux panneaux nus, corner et center, qui ne dessinent rien au repos et n’ont aucun déclencheur propre : un drawer s’ouvre depuis un bouton que vous placez, anchored doit savoir de quel élément il s’agit, et le nav ask field comme la bottom ask bar sont votre propre markup qui soumet à l’assistant. Un snippet généré d’une ligne serait une installation qui ne fait rien ; le dashboard le dit honnêtement et vous envoie vers la référence à la place. Passez mode et appelez open() vous-même : voir Assistant API → Shapes.

Vous ne choisissez jamais de forme mobile. À la largeur d’un téléphone, les montages coin, drawer, ⌘K et anchored deviennent la même feuille en bas d’écran ; inline reste dans le flux, là où vous l’avez posé. Un seul embed couvre les deux. L’exception est Select to ask, qui n’offre volontairement rien sur un appareil tactile : y sélectionner du texte fait apparaître le menu Copier du système, et nous ne rivalisons pas avec lui.


Ce que décide une forme

Le tableau ci-dessus liste les formes. Il vaut la peine de connaître la règle qui les sous-tend, car elle explique l’ensemble et répond à elle seule à la plupart des questions du type « puis-je avoir… ? ».

Chaque forme répond à trois questions à la fois, et mode est la manière de trancher les trois en un seul mot :

  1. Où se place le panneau quand il est ouvert, un coin, un bord, le centre, à côté d’un élément, dans votre propre mise en page, ou la page entière.
  2. Ce qui l’ouvre, un bouton que nous dessinons, un raccourci clavier, un surlignage, votre propre code, ou rien du tout parce qu’il est déjà ouvert.
  3. Ce qui est sur la page avant que tout cela n’arrive.

C’est la troisième que l’on n’attend pas, la voici donc en entier.

Deux formes seulement posent un bouton sur votre page

Ce que voit un visiteur avant toute actionFormes
Un lanceur flottant dans le coinCorner bubble · Launcher with starters
L’assistant lui-même, toujours visibleInline · Full page · Docked sidebar
Une ligne dans votre propre texteExpand in place
Rien de chez nousCorner panel · Centred panel · Drawer · ⌘K panel · Nav ask field · Bottom ask bar · Anchored · Select to ask

La moitié de la famille n’ajoute rien à votre page tant que personne ne le demande. Si « pas de bulle de chat dans le coin » est une exigence, et pour bien des sites elle l’est, vous choisissez donc parmi huit formes, et non aucune, dont deux, Corner panel et Centred panel, sont précisément le panneau de coin et le panneau centré, sans le bouton.

Les trois décisions vont ensemble

Choisir un mode, c’est prendre les trois d’un bloc. C’est tout l’intérêt, un mot plutôt qu’un écran de configuration, et c’est aussi la limite : choisir la manière dont une forme s’ouvre revient à accepter où elle se place et ce qu’elle laisse sur la page.

Deux conséquences à connaître avant de bâtir dessus :

  • reach ajoute des entrées ; rien n’en retire. Vous pouvez donner à une bulle de coin un raccourci ⌘K et le sélectionner-pour-demander par-dessus son lanceur, voir Combiner les formes, mais vous ne pouvez pas garder le panneau de coin de la bulle en supprimant son bouton.
  • Le sélectionner-pour-demander est une forme, pas un réglage. mode="selection" signifie que le surlignage est l’assistant, sans rien sur la page au repos. reach="selection" signifie qu’une autre forme gagne un déclencheur au surlignage et conserve ce qu’elle affichait déjà. La section mode contre reach détaille la différence : c’est ce que l’on confond le plus facilement ici.

Le visiteur peut le redimensionner, et le déplacer

Presque tout panneau qui flotte au-dessus de la page peut être redimensionné par ses bords ou ses coins, et le panneau du sélectionner-pour-demander peut aussi être déplacé par son en-tête. Rien à configurer : aucun attribut ne les active, aucun ne les désactive.

Le tiroir fait exception, car sa largeur correspond à la portion de page qu’il retire : son ouverture déplace déjà la mise en page du site, de sorte que laisser le visiteur ajuster cette largeur ferait refluer la page sous ses yeux pendant qu’il lit.

Sur une fenêtre étroite, le tiroir se pose au-dessus de la page plutôt que de la pousser. La poussée décale votre <body> de la largeur du tiroir, mais les points de rupture de votre mise en page ne répondent qu’à la fenêtre et ne voient pas que la boîte dans laquelle ils se déploient vient de rétrécir. Une mise en page conçue pour un écran large se retrouve alors dessinée dans une colonne de la largeur d’une tablette, et elle se chevauche : une barre de navigation qui empiète sur son propre logo en est le premier signe. Aussi, dès que la poussée laisserait à la page moins de 1024 px, le tiroir fait ce que la feuille mobile fait déjà et recouvre le bord. Il n’y a rien à configurer, la bascule suit la fenêtre pendant que le tiroir est ouvert, et dans les deux cas la page reste vivante et défilante en dessous.

FormeRedimensionnerDéplacer
Corner bubble · Launcher with starters · Corner panel · ⌘K panel · Centred panel✅—
Drawer—,
Select to ask · Anchored✅✅
Inline · Expand in place · Full page · Docked sidebar—,
N’importe quelle forme à la largeur d’un téléphone—,

Le déplacement est plus restreint que le redimensionnement, et c’est délibéré. Une bulle de coin garde son lanceur à l’écran quand elle est ouverte : laisser le visiteur emporter le panneau ailleurs abandonnerait le bouton de fermeture dans le coin. Le sélectionner-pour-demander n’a pas de lanceur à côté de lui et recouvre volontairement le passage dont il parle ; le déplacer est donc le seul moyen de relire les mots d’origine.

La taille choisie par le visiteur dure jusqu’à la fermeture ; la position, elle, ne se reporte jamais. Un clic sur le lanceur ramène l’assistant dans son coin, à la taille qu’il avait choisie. Les deux gestes se font à la souris, sans équivalent clavier.

Les formes dans le flux sont votre mise en page : nous n’y touchons pas.

Le sélectionner-pour-demander continue de fonctionner panneau ouvert. Surligner un second passage fait réapparaître l’offre et l’ajoute à la conversation en cours : le panneau ne bouge pas, et ce qui était déjà saisi est conservé.


Quelle forme choisir ?

Commencez par le corner bubble. Un seul script tag, fonctionne sur toutes les pages, sans décision de layout. La plupart des sites n’ont besoin de rien d’autre.

Passez en inline quand l’emplacement compte. Sur une page pricing, une bulle dans un coin est facile à ignorer ; un panneau de chat sous le tableau de plans fait partie de la décision. C’est le même assistant, simplement rendu dans un conteneur que vous contrôlez.

Et vous n’êtes pas obligé de choisir une seule entrée. Une page monte une forme, c’est là que vit la conversation, mais d’autres déclencheurs peuvent se greffer par-dessus : ajoutez data-olotalk-reach="selection,commandk" au snippet et votre corner bubble s’ouvre aussi quand un visiteur surligne du texte ou presse ⌘K. Vos propres boutons et champs peuvent l’ouvrir également. Peu importe le nombre de portes que vous ajoutez, cela reste un seul panneau et une seule conversation, voir Combiner les formes.


Installation sur une plateforme

Si vous utilisez Webflow, Shopify, Ghost, Squarespace, WordPress ou une autre plateforme hébergée, des guides pas à pas existent pour tenir compte de l’endroit précis où chaque plateforme vous laisse injecter des scripts :

→ Installer sur votre plateforme

Et si vous ne pouvez pas toucher au site du tout, la forme pleine page existe sans aucune installation, sous la forme de la page hébergée de votre assistant :

→ Lien de partage


Ce dont chaque forme a besoin

Quel que soit votre choix :

  1. Un assistant ID. Dans le dashboard, ouvrez votre assistant depuis Assistants, l’ID est affiché sur son étape Installation (et dans l’URL de la page).
  2. Du contenu ingéré. L’assistant ne peut répondre qu’à partir des pages qu’Olotalk a crawlées. Un corpus vide produit une réponse honnête, mais inutile.
  3. Votre domaine dans la allowlist. Les requêtes sont vérifiées par rapport aux domaines autorisés de l’assistant, pour qu’un snippet copié ne puisse pas être utilisé sur le site de quelqu’un d’autre. Ajoutez chaque origine depuis laquelle vous servez le site, sinon vous obtiendrez 403 Domain not allowed. Pendant le développement, préférez un jeton sandbox à l’ajout de votre hôte de dev dans la allowlist (fonctionnalité preview) : le trafic de test reste non facturé et hors de vos analytics.

Pour faire correspondre l’assistant au style de votre site, police, couleurs, coins, voyez Theming. Quelques variables CSS suffisent, et cela fonctionne de la même manière pour chaque forme.

Utiliser l’assistant au clavier

Chaque forme se pilote sans souris. Rien n’est confisqué à votre page tant que le visiteur n’est pas dans l’assistant, à une exception près signalée ci-dessous.

ToucheEffet
EnterEnvoyer le message ; Shift + Enter insère un saut de ligne.
EscPendant qu’une réponse arrive : l’interrompre. Sinon : fermer le panneau.
↑Dans un champ vide, rappeler la dernière question posée, prête à être modifiée.
⌘K / Ctrl+KOuvrir l’assistant, uniquement sur la forme panneau ⌘K, ou si vous avez ajouté commandk en complément. Une bulle d’angle ne s’en empare jamais.

L’ordre d’Esc est délibéré : tant qu’une réponse arrive, il annule la réponse et non le panneau, car fermer l’assistant emporterait la conversation avec lui. Une fois la réponse interrompue, la touche referme le panneau comme d’habitude.

Interrompre rend aussi la question au champ de saisie, curseur en fin de ligne : la reformulation devient une correction plutôt qu’une nouvelle frappe. C’est exactement le geste du bouton Stop, si bien que le visiteur au clavier et celui à la souris aboutissent au même endroit.

L’interruption interrompt vraiment. L’appel au modèle de langage est annulé, pas seulement masqué, et la réponse partielle reste affichée avec une mention explicite pour qu’elle ne passe jamais pour une réponse complète.