Documentation

Tout ce qu'il faut pour installer Ontara sur votre site et répondre à vos visiteurs dans n'importe quelle langue.

Installer le widget

Connectez-vous, créez un espace de travail, puis ouvrez Widget de chat dans le tableau de bord. Copiez votre extrait de code et collez-le avant </body> sur chaque page :

<script src="https://YOUR-LINGLY-HOST/w.js" data-site="pk_your_site_key" async></script>

Le widget ne fonctionne que sur le domaine que vous avez enregistré et ses sous-domaines (par exemple, example.com couvre aussi shop.example.com). Avant de l'installer, ouvrez la Page de test depuis le tableau de bord pour l'essayer.

WordPress

Installez l'extension WordPress d'Ontara, ou collez le même extrait avec n'importe quelle extension de scripts d'en-tête et de pied de page.

Applications monopages

Ajoutez le script une seule fois dans votre gabarit HTML. Il continue de fonctionner lors des changements de route côté client.

API JavaScript

Une fois le script chargé, un petit objet global est disponible :

AppelEffet
lingly.open()Ouvre la fenêtre de chat, par exemple depuis votre propre bouton « Nous contacter ».
lingly.close()Ferme la fenêtre de chat.
lingly.identify({ userId, email, name, hash })Indique à Ontara qui est le visiteur. Voir la vérification d'identité.
lingly.reset()Oublie le visiteur, par exemple quand un utilisateur se déconnecte.
lingly.shutdown()Retire le widget de la page.

Traduction

Définissez la langue de l'équipe dans Équipe. Quand un visiteur écrit dans une autre langue, le message est traduit pour votre équipe et l'original reste à un clic. Vos réponses sont traduites dans la langue du visiteur avant d'être envoyées. Le message d'accueil et les réponses automatiques sont traduits eux aussi.

Activez ou désactivez la traduction dans Automatisation. Les boutons du widget suivent la langue du navigateur du visiteur (anglais, chinois, espagnol, portugais, français, allemand, japonais, coréen et italien), ou une langue que vous choisissez.

Réponses IA

  1. Ajoutez du contenu dans Base de connaissances : questions-réponses, URL d'une page web ou texte libre.
  2. Utilisez Essayer l'IA sur la même page pour voir comment elle répondrait.
  3. Dans Automatisation, choisissez quand l'IA répond : uniquement quand personne n'est en ligne, ou toujours en premier.

L'IA répond uniquement à partir de votre base de connaissances, dans la langue du visiteur. Quand elle ne peut pas répondre, ou que le visiteur demande à parler à quelqu'un, elle transmet la conversation à votre équipe et cesse de répondre dans cette conversation. Elle s'arrête aussi dès qu'un membre de l'équipe répond.

En votre absence

Équipe et rôles

RôlePeut
PropriétaireTout, y compris la facturation.
AdministrateurParamètres, base de connaissances, sites, invitations et facturation.
AgentRépondre aux conversations et consulter la base de connaissances.

Invitez des personnes depuis Équipe. Elles rejoignent l'espace en se connectant avec l'adresse e-mail invitée. Toutes les offres incluent des agents illimités.

Offres et limites

Consultez les tarifs pour voir ce que comprend chaque offre. Quand une limite mensuelle est atteinte, le chat en direct continue de fonctionner ; les réponses IA et la traduction sont suspendues jusqu'au mois suivant ou jusqu'à ce que vous changiez d'offre. Les conversations plus anciennes que la durée d'historique de votre offre sont supprimées automatiquement.

Vérification d'identité

Quand un visiteur est connecté à votre site, vous pouvez indiquer à Ontara qui il est et le prouver, afin que personne ne puisse se faire passer pour l'un de vos utilisateurs.

  1. Dans Widget de chat → Vérification d'identité, activez-la et copiez le secret. Gardez-le uniquement sur votre serveur.
  2. Sur votre serveur, calculez hex(HMAC-SHA256(secret, userId)).
  3. Sur la page, appelez lingly.identify({ userId, email, name, hash }).
// Node.js import { createHmac } from "node:crypto"; const hash = createHmac("sha256", process.env.LINGLY_IDENTITY_SECRET).update(user.id).digest("hex"); // PHP $hash = hash_hmac('sha256', $userId, getenv('LINGLY_IDENTITY_SECRET'));

Les agents voient un badge Vérifié à côté du visiteur. Un appel avec un hash incorrect est refusé. Les visiteurs qui saisissent simplement leur e-mail dans le chat ne sont pas marqués comme vérifiés.

Réponses par e-mail

Quand votre réponse est envoyée par e-mail à un visiteur parti, il lui suffit de répondre à cet e-mail. Sa réponse apparaît dans la même conversation, sans le texte cité ni les signatures.

Il faut pour cela un domaine de réception. Dans Cloudflare Email Routing, redirigez r-*@reply.your-domain.com vers le Worker Ontara, puis définissez INBOUND_EMAIL_DOMAIN=reply.your-domain.com. Seule l'adresse du visiteur peut écrire dans sa conversation ; les réponses automatiques et les rebonds sont ignorés.

Notifications

Dans Compte → Notifications du navigateur, chaque membre peut activer les notifications sur l'appareil qu'il utilise. Quand un visiteur écrit et que la boîte de réception n'est pas ouverte, une notification s'affiche ; un clic ouvre la conversation. Les alertes par e-mail (dans Équipe) restent actives en renfort.

React

Installez @lingly/react, placez <LinglyChat siteKey="pk_..." user={...} /> dans le composant racine et utilisez useLingly() pour obtenir open, close, identify et reset. Quand l'utilisateur se déconnecte (user devient null), le widget oublie le visiteur. Le paquet n'est pas encore publié sur npm ; en attendant, l'API JavaScript fait la même chose dans n'importe quelle app React.

WordPress

  1. Téléchargez l'extension, puis dans WordPress allez dans Extensions → Ajouter → Téléverser une extension.
  2. Activez-la et ouvrez Réglages → Ontara Chat.
  3. Collez votre clé de site. Vous pouvez aussi coller le secret de vérification d'identité pour que les utilisateurs WordPress connectés apparaissent comme vérifiés.

API REST

Créez une clé dans Développeurs et envoyez-la avec chaque requête via Authorization: Bearer lk_.... Les endpoints permettent de lister vos sites, lister et consulter les conversations, lire les messages, répondre au nom de votre équipe (la réponse est traduite pour le visiteur), fermer et rouvrir, supprimer une conversation et consulter les détails d'un visiteur. Chaque clé autorise 120 requêtes par minute. La référence complète se trouve dans la version anglaise.

Webhooks

Ajoutez un endpoint https dans Développeurs et choisissez les événements voulus. Chaque événement arrive en POST JSON avec l'en-tête Lingly-Signature: t=horodatage,v1=signature, la signature étant hex(HMAC-SHA256(secret, t + "." + rawBody)). Répondez avec n'importe quel statut 2xx. Les livraisons échouées sont relancées pendant environ 20 minutes, et un endpoint qui continue d'échouer est mis en pause. Un événement peut parfois arriver deux fois : utilisez id pour ignorer les doublons.