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 :
| Appel | Effet |
|---|---|
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
- Ajoutez du contenu dans Base de connaissances : questions-réponses, URL d'une page web ou texte libre.
- Utilisez Essayer l'IA sur la même page pour voir comment elle répondrait.
- 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
- Message d'absence : envoyé automatiquement quand personne de l'équipe n'est en ligne.
- Collecte de l'e-mail : le widget demande un e-mail au visiteur (jamais, en votre absence ou toujours).
- Suivi par e-mail : si le visiteur est parti et a laissé son e-mail, votre réponse lui est envoyée par e-mail environ deux minutes plus tard.
- Alertes de l'équipe : si un visiteur attend quelques minutes et que personne n'est en ligne, les membres qui ont activé les alertes par e-mail reçoivent un message.
Équipe et rôles
| Rôle | Peut |
|---|---|
| Propriétaire | Tout, y compris la facturation. |
| Administrateur | Paramètres, base de connaissances, sites, invitations et facturation. |
| Agent | Ré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.
- Dans Widget de chat → Vérification d'identité, activez-la et copiez le secret. Gardez-le uniquement sur votre serveur.
- Sur votre serveur, calculez
hex(HMAC-SHA256(secret, userId)). - 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
- Téléchargez l'extension, puis dans WordPress allez dans Extensions → Ajouter → Téléverser une extension.
- Activez-la et ouvrez Réglages → Ontara Chat.
- 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.