> For the complete documentation index, see [llms.txt](https://docs.hablla.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hablla.com/french/hablla/parametres/connexions-et-integrations/webchat.md). # Webchat Découvrez le canal Webchat de Hablla : ce qu’il est, comment le mode de recherche identifie chaque visiteur de votre site et quelles options de personnalisation visuelle sont disponibles. ## Qu’est-ce que le Webchat Le **Webchat de Hablla** est un canal de service qui permet à vos clients de discuter avec votre entreprise **directement via le site**, sans avoir besoin de quitter la page. En pratique, il fonctionne de la même manière que les autres canaux de la plateforme, comme **WhatsApp**, **Instagram** et **Telegram**: c’est encore une *connexion* au sein de Hablla. Cela signifie que le Webchat peut utiliser : * Flux * Intelligence artificielle * Bots * Assistance humaine * Automatisation La seule différence est le point de contact : au lieu d’une application de messagerie, la conversation se déroule dans le site de votre entreprise. *** ## Important à savoir Avant de configurer le canal, il vaut la peine de comprendre deux concepts qui définissent le comportement du Webchat : **comment il identifie la personne qui discute** et **comment il apparaît sur votre site**. ### 1. Mode de recherche Tout comme WhatsApp utilise le numéro de téléphone pour savoir qui se trouve de l’autre côté, le Webchat a également besoin d’une **identification unique** pour reconnaître le visiteur. Cette identification garantit : * la conservation de l’historique de la conversation ; * la reconnaissance de l’utilisateur qui vous a déjà contacté ; * qu’aucun prospect en double ne soit créé ; * la continuité du service même après l’actualisation de la page. Le champ **Mode de recherche**, sur l’écran de configuration du canal, définit lequel de ces comportements sera utilisé. Ensuite, nous parlerons de chacun des modes disponibles pour la configuration de votre canal Webchat dans Hablla : #### 1.1. Mode de recherche automatique Dans ce mode, votre Webchat génère automatiquement un ID pour le visiteur et l’enregistre dans le **Local Storage** du navigateur de l’utilisateur, c’est-à-dire la personne qui vous envoie un message via le Webchat sur votre site. Ainsi, l’utilisateur peut actualiser la page, partir et revenir plus tard, et la conversation continue normalement. C’est le mode le plus simple à configurer et il ne nécessite aucun développement sur votre site. {% hint style="danger" %} Si le Local Storage du navigateur de l’utilisateur (la personne qui vous contacte) est supprimé, un nouvel ID sera généré. Le système comprendra qu’il s’agit d’une autre *personne* pourra être créée dans Hablla. {% endhint %} #### 1.2. Mode de recherche manuel Ici, c’est vous qui définissez quelle information sera utilisée comme identifiant de l’utilisateur qui communique avec vous et où cette information sera obtenue. Par exemple : * CPF * E-mail * ID interne du système * Matricule * Code utilisateur Dans ce mode, vous devez également définir quelle sera la **source de recherche**, c’est-à-dire **où** le système recherchera l’information que vous avez définie comme identifiant :
Source de rechercheOù le Webchat recherche l’identifiant
Local StorageStockage du navigateur qui reste enregistré même après la fermeture de l’onglet ou du navigateur.
Session StorageStockage temporaire dans le navigateur, utilisé pendant la session du Webchat. Les données restent disponibles tant que la session est active, dans le respect du délai d’expiration configuré par le système.
CookiesCookies enregistrés dans le navigateur de l’utilisateur par son propre site.
PersonnaliséLe système de votre site envoie lui-même l’identifiant au Webchat, initialisant le système de messagerie sur la base de l’ID fourni par votre système.
{% hint style="danger" %} Si la variable configurée n’existe pas dans la source de recherche choisie, **le widget NE se charge PAS**. Le fonctionnement du Webchat dépend alors de la disponibilité de cette information dans le navigateur de l’utilisateur. {% endhint %} *** ### 2. Personnalisation visuelle La connexion Webchat permet également de personnaliser l’apparence du bouton et de la fenêtre de service, afin que le canal soit aligné avec l’identité visuelle de votre site. Parmi les options disponibles, vous pouvez personnaliser la mise en page, la typographie et les couleurs de votre Webchat. **Mise en page et design** * Format d’affichage du chat * Positionnement à l’écran (les quatre coins) * Animation d’entrée * Espacement vertical et horizontal * Hauteur et largeur du chat et du bouton * Image du chat et image du bouton **Typographie** * Police * Taille * Graisse de la police * Couleur du texte du message **Couleurs** * Mode clair, sombre ou automatique * En-tête du chat en couleur unie ou en dégradé * Couleur des messages du client * Couleur du bouton Pendant que vous effectuez les ajustements, la plateforme affiche un **aperçu en temps réel** dans le coin inférieur droit de l’écran ou à l’emplacement que vous avez choisi pour le chargement du widget. Cela facilite énormément le réglage des détails sans avoir besoin de publier quoi que ce soit. {% hint style="info" %} L’aperçu sert uniquement à montrer l’apparence du widget. Il **n’effectue pas de tests réels d’envoi et de réception de messages**. {% endhint %} ## Bonnes pratiques * Vérifiez qu’il existe déjà un **service** enregistré avant de commencer la création de votre connexion Webchat. * Utilisez des noms descriptifs pour les connexions et les identifiants, afin de faciliter la gestion lorsqu’il existe plusieurs Webchats. * Nous recommandons l’utilisation du mode de recherche en **mode automatique** lorsqu’il n’y a pas de connexion sur le site ; utilisez **manuel** uniquement lorsqu’il existe un identifiant fiable disponible sur la page. * Testez localement avant de publier le script sur le site en production. *** {% hint style="info" %} **Remarque :** Cette documentation traite uniquement du fonctionnement de la fonctionnalité. Pour des informations sur la facturation, les coûts ou les conditions commerciales, consultez le contrat en vigueur ou contactez le service responsable. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.hablla.com/french/hablla/parametres/connexions-et-integrations/webchat.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.