Référence d’intégration

Tout ce dont un développeur a besoin pour contrôler la façon dont l’assistant Olotalk se charge et se comporte.


Snippet de base

<script
  src="https://cdn.jsdelivr.net/npm/@olotalk/assistant-loader@0/dist/loader.iife.js"
  data-olotalk-assistant-id="YOUR_ASSISTANT_ID"
  async
></script>

Placez-le avant </body>. async est recommandé pour que le loader reste non bloquant.

Un script asynchrone
Lit votre configuration
Récupère le bundle + CSS
Monte l'assistant
Le tag script unique est un petit loader asynchrone : il lit votre configuration (attributs data-* fusionnés avec un éventuel window.OlotalkConfig), récupère le bundle assistant et la feuille CSS depuis le CDN, puis monte l'assistant automatiquement au DOMContentLoaded.

Attributs data-olotalk-*

Toute la configuration passe via des attributs data- sur la balise <script>.

<script
src=".../@olotalk/assistant-loader@0/dist/loader.iife.js"
1data-olotalk-assistant-id="ast_oltk_..."
2data-olotalk-origin="https://api.example.com"
3data-olotalk-locale="fr"
4data-olotalk-cdn-base="..."
async
></script>
  1. 1
    data-olotalk-assistant-idRequis : quel assistant charger.
  2. 2
    data-olotalk-originOverride optionnel de l'origine API pour le self-hosting ; omettez-le sur Olotalk Cloud.
  3. 3
    data-olotalk-localeForce une langue. Sinon, détection automatique.
  4. 4
    data-olotalk-cdn-baseOù récupérer le bundle. jsDelivr par défaut.
Toute la configuration passe par le tag script via des attributs data-*. Seul l'identifiant de l'assistant est requis ; chaque autre attribut a une valeur par défaut raisonnable.

data-olotalk-assistant-id (requis)

Identifiant unique de votre assistant. Trouvez-le dans le dashboard : ouvrez l’assistant depuis Assistants, l’ID est affiché sur son étape Installation (et dans l’URL de la page).

data-olotalk-assistant-id="ast_oltk_7Kd2mQxRv9TbNhLpW3Zsy"

data-olotalk-origin (optionnel)

URL de base de l’API Olotalk. Omettez-la pour Olotalk Cloud : le loader utilise par défaut https://api.olotalk.com. Ne la définissez que dans un déploiement self-managed avancé où l’API tourne sur une autre origine.

<!-- Déploiement self-managed -->
data-olotalk-origin="https://api.example.com"

data-olotalk-locale

Force une locale spécifique pour l’UI de l’assistant. Accepte n’importe quel tag BCP 47 bien formé : "en", "fr", "en-CA", "vi", "ja-JP", "sw", etc. Les chaînes UI pour en/fr/de sont embarquées ; les autres locales sont traduites par Olotalk à la première requête puis mises en cache.

Quand cet attribut est omis, l’assistant détecte automatiquement la langue dans l’ordre suivant : choix accepté précédemment par le visiteur (localStorage) → <html lang> de la page → navigator.language. La langue détectée n’est utilisée que si elle fait partie de l’ensemble supportedLocales de l’assistant.

data-olotalk-locale="fr"

Voir la section Multilingual dans le README du loader pour la chaîne de priorité complète.

Cet attribut est lu une seule fois, au montage de l’assistant. Si votre propre sélecteur de langue change la langue de la page sans la recharger, appelez Olotalk('locale', 'fr') : les textes de l’assistant sont échangés sur place et la conversation ouverte est conservée. Voir Piloter la langue depuis votre interface.

data-olotalk-sandbox-token

Fonctionnalité preview. Un jeton signé et expirant, généré depuis la carte Test in your own app du dashboard. Sa présence bascule l’assistant dans le bac à sable développeur non facturé, voir Tester dans le bac à sable pour le modèle complet. Si la fonctionnalité n’est pas activée pour votre espace de travail, ignorez cet attribut.

data-olotalk-sandbox-token="<jeton depuis le dashboard>"

data-olotalk-mode

Quelle forme monter. Sans lui, vous obtenez le corner bubble.

data-olotalk-mode="drawer"

Plusieurs formes, séparées par des virgules, partagent une seule conversation ; la première est la résidence :

data-olotalk-mode="bubble,drawer"

La liste complète, et l’usage de chacune, est dans Shapes. Quatre d’entre elles, drawer, anchored, navfield et askbar, s’attachent à quelque chose de votre page et demandent une ligne de JavaScript en plus de cet attribut ; les autres fonctionnent avec la seule balise script.

Un id que l’assistant ne reconnaît pas retombe sur un montage fonctionnel et le dit dans la console : une coquille dégrade en bubble, pas en page blanche.

data-olotalk-reach

Des manières supplémentaires d’appeler la forme que vous avez montée, séparées par des virgules. selection l’ouvre à côté d’un passage que le visiteur surligne, ce passage cité au-dessus d’un composer vide, et commandk l’ouvre sur ⌘K.

data-olotalk-mode="bubble"
data-olotalk-reach="selection,commandk"

Peu importe le nombre de portes que vous ajoutez, la page n’a toujours qu’un seul panneau et qu’une seule conversation, voir Combiner les formes. Un id que reach ne reconnaît pas est ignoré avec un avertissement en console.

data-olotalk-open

Transforme n’importe quel élément existant en porte d’entrée, sans écrire une ligne de JavaScript.

<button data-olotalk-open>Ask AI</button>
<button data-olotalk-open="drawer">Ask AI</button>
<button data-olotalk-open data-olotalk-prefill="Comment fonctionne la facturation ?">Aide tarifs</button>

La valeur désigne la forme à ouvrir ; laissez-la vide lorsque la page n’a qu’un seul panneau, ce qui est le cas courant. data-olotalk-prefill ouvre le panneau avec une question, que la forme envoie aussitôt ou laisse modifiable selon son propre comportement (la bulle de coin envoie, tandis que le select-to-ask conserve le texte pour que le visiteur puisse l’amender). Une porte qui désigne une forme non montée avertit dans la console et ne fait rien, plutôt que d’échouer en silence.

Une porte simple fonctionne comme un interrupteur : appuyez de nouveau pendant que le panneau est ouvert et il se referme. Une porte porteuse de data-olotalk-prefill ouvre toujours, en revanche, car elle signifie « pose cette question » ; un second appui veut alors dire « repose-la », et non « laisse tomber ».

C’est ce qui rend le drawer installable par simple collage : comme il n’a délibérément pas de lanceur, son snippet embarque ce bouton. Déplacez-le dans votre en-tête, restylez-le, ou posez simplement l’attribut sur un bouton que vous avez déjà.

data-olotalk-door="branded"

Donne à une porte l’allure de l’assistant lui-même : une pastille discrète au repos, autour de laquelle le dégradé du lanceur se met à tourner au survol.

<button data-olotalk-open="drawer" data-olotalk-door="branded">Ask AI</button>

L’adhésion est volontaire, et c’est délibéré : sans cet attribut, la porte garde votre mise en forme et nous n’y touchons pas, puisque tout l’intérêt de data-olotalk-open est de se poser sur un élément que vous possédez déjà. Le snippet généré embarque l’attribut ainsi que la marque du robot en SVG inline, car celle-ci cligne des yeux, ce qu’une image de fond ne saurait faire. Retirez l’attribut et vous retrouvez votre bouton d’origine.

data-olotalk-selection-answers

Là où un surlignage ouvre le panneau. beside, la valeur par défaut, l’amène jusqu’aux mots, de sorte que la réponse arrive là où la question a été posée. in-place l’ouvre là où l’assistant vit, un bon choix quand votre assistant est un point fixe que vos visiteurs ont déjà repéré et que vous préférez que rien ne bouge.

data-olotalk-mode="bubble"
data-olotalk-reach="selection"
data-olotalk-selection-answers="in-place"

Seul le déclencheur de sélection est concerné : vos propres appels à open({ anchor }) se positionnent comme ils l’ont toujours fait. Toute autre valeur est ignorée avec un avertissement en console et vous obtenez beside.

data-olotalk-mount

Sélecteur CSS du conteneur dans lequel l’assistant se rend. Requis pour les formes dans le flux, inline et expand, qui vivent dans votre mise en page plutôt qu’au-dessus. Tout le reste se positionne par rapport au viewport et l’ignore.

data-olotalk-mount="#olotalk-assistant"

data-olotalk-cdn-base

Remplace l’URL de base du CDN à partir de laquelle le bundle assistant et la CSS sont chargés. Utile pour l’auto-hébergement.

<!-- Auto-hébergement sur votre propre origine -->
data-olotalk-cdn-base="https://assets.example.com/olotalk"

Quand cet attribut est omis, le loader utilise jsDelivr avec une version de bundle assistant épinglée sur celle du build du loader.


Attribut JSON (syntaxe alternative)

Au lieu d’attributs data-olotalk-* séparés, vous pouvez passer un seul blob JSON :

<script
  src="https://cdn.jsdelivr.net/npm/@olotalk/assistant-loader@0/dist/loader.iife.js"
  data-olotalk='{"assistantId":"ast_oltk_7Kd2mQxRv9TbNhLpW3Zsy","locale":"fr"}'
  async
></script>

L’attribut JSON est fusionné avec les attributs data-olotalk-* individuels ; les attributs individuels gardent la priorité.


Objet de config global (avancé)

Pour un contrôle programmatique complet, définissez window.OlotalkConfig avant le script du loader :

<script>
  window.OlotalkConfig = {
    assistantId: 'ast_oltk_7Kd2mQxRv9TbNhLpW3Zsy',
    locale: 'fr',
    theme: 'dark',
    mode: 'inline',           // quelle forme — `bubble` par défaut
    mount: '#chat-container', // sélecteur CSS — requis pour `inline` et `expand`
    // origin: 'https://api.example.com', // uniquement pour le self-managed
    // cdnBase: 'https://assets.example.com/olotalk', // uniquement pour les assets auto-hébergés
    // version: '1.2.3',                 // épingle la version du bundle assistant
  };
</script>
<script
  src="https://cdn.jsdelivr.net/npm/@olotalk/assistant-loader@0/dist/loader.iife.js"
  async
></script>

window.OlotalkConfig est fusionné avec les attributs data-. Les attributs data- gardent la priorité.

attribut data-olotalk-*
sur le tag script
overrides
window.OlotalkConfig
l'objet global de configuration
overrides
valeur intégrée par défaut
ce qui est livré

Référence complète de la config

ChampTypeDéfautDescription
assistantIdstring—Assistant ID (requis)
siteIdstring—Alias legacy de assistantId
originstringhttps://api.olotalk.com (build cloud)URL de base de l’API Olotalk
localestringauto-détectéeOverride explicite de locale (tag BCP 47)
theme"light" | "dark" | object"light"Thème UI
modeid de forme"bubble"Quelle forme monter, voir Shapes
placement"floating" | "embedded"—Déprécié, utilisez mode. floating équivaut à bubble, embedded à inline. Toujours résolu, car présent dans des snippets en production
mountstringdocument.bodySélecteur CSS du conteneur. Requis pour inline et expand
cdnBasestringjsDelivrURL de base du CDN d’assets
versionstringcelle du build du loaderÉpinglage de version du bundle assistant
cssUrlstringdérivé de cdnBaseOverride de l’URL CSS de l’assistant

Configuration des conversions

Le pipeline de conversion permet les propositions de CTA par intention et la capture de leads. Quand il est activé, l’assistant classe chaque message visiteur dans une catégorie d’intention commerciale (pricing, demo, integration, support, general) et, si la confiance est suffisamment haute, propose l’action configurée à côté de la réponse.

La configuration des conversions est uniquement côté serveur. Elle vit dans l’enregistrement assistant, pas dans le snippet client.

Configurer dans le dashboard

Ouvrez votre assistant depuis Assistants puis utilisez le builder :

  • CTA actions, confidence et webhook target vivent sur l’étape Base, sous Advanced configuration → Action policy.
  • Tool connections (Calendly, HubSpot) vivent sur l’étape Behavior.

La plage recommandée en production pour minIntentConfidence est 0.7–0.8 ; baissez-la pendant les tests si vous voulez déclencher les CTA plus facilement.

Types d’actions CTA

link
Envoie le visiteur vers une URL.
lead_form
Collecte nom, email, entreprise et cas d'usage.
escalate_to_human
Transfère la conversation à une personne.
trigger_webhook
Déclenche votre webhook avec le lead.
book_meeting
Ouvre un flux de prise de rendez-vous.
hubspot_create_contact_deal
Crée un contact et un deal HubSpot.
ActionDéclenchée parCe qui se passe
linkclic sur le bouton CTAOuvre href dans un nouvel onglet
lead_formclic sur le bouton CTAFormulaire inline, e-mail requis + champs optionnels
escalate_to_humanclic sur le bouton CTAAction côté serveur, notifie notifyEmail
trigger_webhookclic sur le bouton CTAAction côté serveur, POSTe les données lead vers webhookUrl
book_meetingclic sur le bouton CTAOuvre un scheduler Calendly inline
hubspot_create_contact_dealclic sur le bouton CTAAction côté serveur, crée un contact + deal HubSpot

Les cibles notifyEmail et webhookUrl restent stockées côté serveur et ne sont jamais exposées au navigateur.

Page patterns et réglage de confiance

Par défaut, un CTA peut se déclencher sur n’importe quelle page. Pour le restreindre à certains chemins, utilisez pagePatterns :

{ "pagePatterns": ["/pricing", "/integrations", "/docs"] }

Le matching se fait par sous-chaîne. Omettez pagePatterns pour cibler toutes les pages.

minIntentConfidence (0–1) contrôle à quel point l’intention du visiteur doit être claire avant le déclenchement du CTA. La plage recommandée en production est 0.7–0.8.

Score des leads et dispatch webhook

Quand un lead est soumis via lead_form, Olotalk le score à partir de l’intention, du domaine e-mail, de la présence d’une entreprise et de la complétude du cas d’usage. Les leads avec un score ≥ 60 passent en qualified. Si l’assistant possède un webhookUrl, Olotalk POSTe le payload du lead, par défaut pour chaque lead soumis, pas seulement les qualifiés. Voir Leads et conversions pour la référence détaillée.

Événements de conversion

Écoutez les outcomes de conversion sur l’instance assistant. Ces événements sont exposés sur l’instance @olotalk/assistant retournée par createAssistant() ; le snippet loader standard ne les expose pas.

import { createAssistant } from '@olotalk/assistant'

const assistant = createAssistant(mountEl, { assistantId, origin })

assistant.on('cta_click', ({ id, action, intent }) => {
  console.log('CTA cliqué', id, action, intent)
})

assistant.on('lead_submit', ({ leadId, status, score }) => {
  console.log('Lead capturé', leadId, status, score)
})

Mode embarqué

Par défaut, l’assistant se rend en corner bubble (launcher flottant en bas à droite). Pour l’intégrer inline dans un conteneur existant :

<div id="chat-container" style="height: 600px;"></div>

<script>
  window.OlotalkConfig = {
    assistantId: 'ast_oltk_7Kd2mQxRv9TbNhLpW3Zsy',
    mode: 'inline',
    mount: '#chat-container',
  };
</script>
<script
  src="https://cdn.jsdelivr.net/npm/@olotalk/assistant-loader@0/dist/loader.iife.js"
  async
></script>

Le conteneur doit avoir une hauteur explicite.

Pour faire correspondre l’assistant embarqué à la page hôte, définissez quelques variables CSS. Voir Theming.


Guides framework

Vous utilisez un builder no-code ou un CMS ? WordPress, Shopify, Wix, Squarespace, Webflow, Framer, Ghost, BigCommerce, Google Tag Manager et d’autres disposent d’un guide pas à pas dans Installer sur votre plateforme.

Les exemples ci-dessous supposent Olotalk Cloud : data-olotalk-origin est omis car le loader utilise déjà https://api.olotalk.com.

Chaque guide ci-dessous monte le corner bubble, le bon choix pour la plupart des sites. Vous le voulez inline dans votre propre layout ? Voir Choisir une forme, puis Inline dans un framework. Pour adapter l’apparence au site, voir Theming.

Votre framework n’est pas listé ? L’intégration repose sur une simple balise <script>, donc le snippet HTML brut fonctionne dans n’importe quel framework qui rend du markup. Pour une approche plus native, l’élément personnalisé fonctionne dans n’importe quel template.

React

import { useEffect } from 'react'

export function OlotalkAssistant() {
  useEffect(() => {
    if (document.getElementById('olotalk-loader')) return

    window.OlotalkConfig = {
      assistantId: process.env.NEXT_PUBLIC_OLOTALK_ASSISTANT_ID!,
    }

    const script = document.createElement('script')
    script.id = 'olotalk-loader'
    script.src =
      'https://cdn.jsdelivr.net/npm/@olotalk/assistant-loader@0/dist/loader.iife.js'
    script.async = true
    document.body.appendChild(script)

    return () => {
      window.Olotalk?.('destroy')
    }
  }, [])

  return null
}

Ajoutez <OlotalkAssistant /> à votre layout racine.

Next.js (composant Script)

Requiert Next.js 14+. L’exemple ci-dessous suit les conventions Next.js 16.

Utilisez directement les attributs data-* sur le tag <Script>. Lisez la config assistant depuis des variables d’environnement non NEXT_PUBLIC_ dans un composant serveur async afin qu’elles soient évaluées à la requête.

// app/layout.tsx
import Script from 'next/script'

export const dynamic = 'force-dynamic'

export default async function RootLayout({ children }: { children: React.ReactNode }) {
  const loaderSrc = process.env.OLOTALK_LOADER_SRC
  return (
    <html>
      <body>
        {children}
        {loaderSrc && (
          <Script
            id="olotalk-loader"
            src={loaderSrc}
            strategy="afterInteractive"
            data-olotalk-assistant-id={process.env.OLOTALK_ASSISTANT_ID}
          />
        )}
      </body>
    </html>
  )
}

Vue / Nuxt

// plugins/olotalk.client.ts
export default defineNuxtPlugin(() => {
  window.OlotalkConfig = {
    assistantId: useRuntimeConfig().public.olotalkAssistantId,
  }

  const script = document.createElement('script')
  script.src =
    'https://cdn.jsdelivr.net/npm/@olotalk/assistant-loader@0/dist/loader.iife.js'
  script.async = true
  document.body.appendChild(script)
})

Astro

Ajoutez le loader à votre layout partagé. Astro bundle les balises <script> par défaut ; marquez-la is:inline pour conserver le loader externe et ses attributs data-.

---
// src/layouts/Layout.astro
const assistantId = import.meta.env.PUBLIC_OLOTALK_ASSISTANT_ID
---
<slot />

<script
  is:inline
  src="https://cdn.jsdelivr.net/npm/@olotalk/assistant-loader@0/dist/loader.iife.js"
  data-olotalk-assistant-id={assistantId}
  async
></script>

Définissez PUBLIC_OLOTALK_ASSISTANT_ID dans votre .env.

HTML brut / sites statiques

<!DOCTYPE html>
<html>
  <body>
    <!-- le contenu de votre page -->

    <script
      src="https://cdn.jsdelivr.net/npm/@olotalk/assistant-loader@0/dist/loader.iife.js"
      data-olotalk-assistant-id="ast_oltk_7Kd2mQxRv9TbNhLpW3Zsy"
      async
    ></script>
  </body>
</html>

Remix

Ajoutez le loader dans app/root.tsx après le composant <Scripts />. Utilisez defer plutôt que async.

// app/root.tsx
import { Scripts } from '@remix-run/react'

export default function App() {
  return (
    <html>
      <body>
        <Outlet />
        <Scripts />
        <script
          src="https://cdn.jsdelivr.net/npm/@olotalk/assistant-loader@0/dist/loader.iife.js"
          data-olotalk-assistant-id={process.env.OLOTALK_ASSISTANT_ID}
          defer
        />
      </body>
    </html>
  )
}

Les variables d’environnement sont côté serveur par défaut dans Remix. Si vous en avez besoin côté client, exposez-les via un loader.

SvelteKit

Option A, src/app.html

<!-- src/app.html -->
<body>
  %sveltekit.body%

  <script
    src="https://cdn.jsdelivr.net/npm/@olotalk/assistant-loader@0/dist/loader.iife.js"
    data-olotalk-assistant-id="ast_oltk_7Kd2mQxRv9TbNhLpW3Zsy"
    async
  ></script>
</body>

Option B, +layout.svelte avec injection d’env var

<!-- src/routes/+layout.svelte -->
<script>
  import { onMount } from 'svelte'
  export let data

  onMount(() => {
    if (document.getElementById('olotalk-loader')) return

    window.OlotalkConfig = {
      assistantId: data.olotalkAssistantId,
    }

    const script = document.createElement('script')
    script.id = 'olotalk-loader'
    script.src =
      'https://cdn.jsdelivr.net/npm/@olotalk/assistant-loader@0/dist/loader.iife.js'
    script.async = true
    document.body.appendChild(script)
  })
</script>

<slot />
// src/routes/+layout.server.ts
import { env } from '$env/static/private'

export function load() {
  return {
    olotalkAssistantId: env.OLOTALK_ASSISTANT_ID,
  }
}

Angular

Option A, src/index.html

<!-- src/index.html -->
<body>
  <app-root></app-root>

  <script
    src="https://cdn.jsdelivr.net/npm/@olotalk/assistant-loader@0/dist/loader.iife.js"
    data-olotalk-assistant-id="ast_oltk_7Kd2mQxRv9TbNhLpW3Zsy"
    async
  ></script>
</body>

Option B, AppComponent avec environment.ts

// src/app/app.component.ts
import { Component, OnInit } from '@angular/core'
import { environment } from '../environments/environment'

@Component({ selector: 'app-root', templateUrl: './app.component.html' })
export class AppComponent implements OnInit {
  ngOnInit() {
    if (document.getElementById('olotalk-loader')) return

    ;(window as any).OlotalkConfig = {
      assistantId: environment.olotalkAssistantId,
    }

    const script = document.createElement('script')
    script.id = 'olotalk-loader'
    script.src =
      'https://cdn.jsdelivr.net/npm/@olotalk/assistant-loader@0/dist/loader.iife.js'
    script.async = true
    document.body.appendChild(script)
  }
}
// src/environments/environment.ts
export const environment = {
  production: false,
  olotalkAssistantId: 'ast_oltk_7Kd2mQxRv9TbNhLpW3Zsy',
}

Inline dans un framework

Tous les guides ci-dessus montent le corner bubble. Pour placer l’assistant inline dans votre propre layout, deux options fonctionnent dans tous les frameworks.

Le plus simple, l’élément personnalisé. <olotalk-assistant> se rend là où vous le placez ; mode="inline" le rend donc inline dans n’importe quel template HTML ou composant.

// une fois, au démarrage de l’app
import { defineOlotalkAssistantElement } from '@olotalk/assistant'
defineOlotalkAssistantElement()
<div style="height: 600px">
  <olotalk-assistant assistant-id="ast_oltk_7Kd2mQxRv9TbNhLpW3Zsy" mode="inline"></olotalk-assistant>
</div>

Mode impératif, montage dans une ref. Si vous préférez contrôler vous-même le montage, appelez createAssistant(element, …) avec le conteneur.

import { useEffect, useRef } from 'react'
import { createAssistant } from '@olotalk/assistant'

export function InlineAssistant() {
  const ref = useRef<HTMLDivElement>(null)
  useEffect(() => {
    if (!ref.current) return
    const assistant = createAssistant(ref.current, {
      assistantId: 'ast_oltk_7Kd2mQxRv9TbNhLpW3Zsy',
      mode: 'inline',
    })
    return () => { void assistant.destroy() }
  }, [])

  return <div ref={ref} style={{ height: 600 }} />
}

Le conteneur a besoin d’une hauteur explicite. Les deux approches sont détaillées dans API JS de l’assistant.


Auto-hébergement

Pour héberger le bundle assistant sur votre propre infrastructure :

  1. Installez les packages npm sur une machine disposant de Node.js :
    npm install @olotalk/assistant-loader @olotalk/assistant
    
  2. Copiez les fichiers dist vers votre serveur d’assets statiques :
    cp node_modules/@olotalk/assistant/dist/olotalk-assistant.js /your/assets/
    cp node_modules/@olotalk/assistant/dist/olotalk-assistant.iife.js /your/assets/
    cp node_modules/@olotalk/assistant/dist/olotalk-assistant.css /your/assets/
    cp node_modules/@olotalk/assistant-loader/dist/loader.iife.js /your/assets/
    cp node_modules/@olotalk/assistant/dist/version.json /your/assets/
    
  3. Définissez data-olotalk-cdn-base avec l’URL où ces assets sont servis :
    <script
      src="https://assets.example.com/olotalk/loader.iife.js"
      data-olotalk-assistant-id="ast_oltk_7Kd2mQxRv9TbNhLpW3Zsy"
      data-olotalk-cdn-base="https://assets.example.com/olotalk"
      async
    ></script>
    

Le loader demande {cdnBase}/olotalk-assistant.js sur les navigateurs module-capables, retombe sur {cdnBase}/olotalk-assistant.iife.js si nécessaire, puis charge la CSS depuis {cdnBase}/olotalk-assistant.css. Il demande aussi {cdnBase}/version.json pour le cache-busting, sans ce fichier tout fonctionne, mais vous verrez un 404 dans la console et les visiteurs peuvent garder un bundle en cache plus longtemps.


Ingestion de votre contenu

Olotalk construit la base de connaissances de l’assistant en crawlant les pages que vous lui indiquez, directement depuis le dashboard, sans appel API ni script supplémentaire.

Ouvrez votre assistant depuis Assistants puis allez à l’étape Source. Deux notions restent indépendantes :

  • Source URLs, ce qui est indexé dans la base de connaissances
  • Domaines d’installation, les domaines sur lesquels le launcher est autorisé (étape Installation)

Ajoutez les URL à indexer, ou entrez la racine du site pour laisser Olotalk découvrir les pages depuis sitemap.xml et robots.txt. Lancez ensuite le crawl ; le panneau Ingestion status, coverage & languages sur la même étape suit la progression.


Sécurité

Allowlist des domaines d’installation, Olotalk valide chaque requête par rapport aux domaines d’installation configurés sur l’assistant. Ajoutez le hostname concerné sur l’étape Installation, sous Domaines d’installation. Les domaines non listés reçoivent un 403.

Rate limiting, l’endpoint de config est limité à 60 requêtes par IP et par minute. L’endpoint d’ask hérite du réglage rateLimitPer5Min par assistant (par défaut : 20).

Request tracing, chaque réponse inclut un header x-request-id. Si vous fournissez votre propre valeur, Olotalk la réutilise ; sinon un UUID est généré.

Content Security Policy, si votre site applique une CSP stricte, ajoutez :

script-src 'self' https://cdn.jsdelivr.net;
style-src 'self' https://cdn.jsdelivr.net;
connect-src 'self' https://api.olotalk.com https://cdn.jsdelivr.net;

Adaptez cdn.jsdelivr.net si vous auto-hébergez. Si vous utilisez le CTA book_meeting, autorisez aussi l’iframe du scheduler avec frame-src https://calendly.com;.