Comment installer Chatwoot sur Saplo (chat en direct et helpdesk pour l'équipe)

Si tu gères tes clients par chat et que tu paies chaque mois un agent sur Intercom, Zendesk ou Tawk.to Pro, tu finiras par faire le calcul du coût d'une équipe composée de plusieurs personnes. Chatwoot adopte une autre approche, car il est open source et tu l'héberges sur ton propre serveur. Tu paies une seule fois pour Box, sans aucune limite au nombre d'agents, de conversations ou de boîtes mail. Voici, étape par étape, comment installer Chatwoot sur Saplo.

À qui s'adresse Chatwoot

Avant de l'installer, vérifie si cet outil correspond à ce que tu fais :

• tu veux répondre aux clients par chat sur ton site, et pas uniquement par e-mail - Chatwoot propose un widget de chat que tu intègres sur n'importe quelle page, tandis que les conversations arrivent dans une boîte de réception partagée pour l'équipe,
• tu gères plusieurs marques ou sites depuis un seul Panneau - une seule installation de Chatwoot prend en charge n'importe quel nombre de boîtes de réception (Inbox) : le site web, l'e-mail, Facebook ou Instagram, chacune gérée séparément,
• tu en as assez de payer pour chaque agent supplémentaire chez Intercom, Zendesk ou Tawk.to - Chatwoot est open source, sans frais calculés en fonction du nombre de personnes dans l'équipe du support,
• tu as besoin d'automatisations et de statistiques d'équipe - les règles d'attribution automatique des conversations, les modèles de réponse et les rapports sur le temps de réponse sont intégrés, sans forfait supplémentaire.

Si tu cherches un widget simple et prêt à l'emploi, sans infrastructure à gérer, et que payer par agent ne te pose pas problème, le plan gratuit de Tawk.to peut tout de même suffire. Chatwoot sur Saplo devient pertinent lorsque l'équipe grandit et que le coût du SaaS commence à augmenter avec elle.

Exigences

Pour installer Chatwoot sur Saplo, tu as besoin de :

• du plan Box M ou supérieur, car la recette lance simultanément quatre conteneurs Docker (application, worker, base de données, Redis) et exige au moins 2 Go de RAM libre,
• d'au moins 10 Go d'espace disque,
• d'un Domaine ou d'un sous-domaine *.saploapp.pl, inclus dans le prix de chaque offre, sous lequel seront accessibles le Panneau agent et le widget de chat,
• d'une base de données distincte, que tu NE dois PAS créer manuellement : la recette installe son propre conteneur PostgreSQL avec l'extension pgvector, car Chatwoot l'utilise pour les fonctions IA, tandis que le moteur ne dispose d'une base de données partagée que pour MySQL,
• d'un serveur SMTP dédié, si tu veux que les invitations pour agents et les notifications soient réellement envoyées par e-mail, comme expliqué plus en détail dans la première section de configuration ci-dessous.

Installation étape par étape

1. Dans le Panneau Saplo, accède au Catalogue d'applications et choisis Chatwoot (catégorie « Business »).
2. Sélectionne une Box M ou un plan supérieur, avec au moins 2 GB de RAM libre, ainsi qu'un domaine ou un sous-domaine sous lequel le panneau de l'agent sera accessible.
3. Valide l'installation. Le moteur installe Docker CE s'il n'est pas déjà présent sur la Box, télécharge l'image officielle chatwoot/chatwoot (environ 1,5 GB), ainsi que les images de sa propre base de données pgvector/pgvector et Redis.
4. Avant de lancer le panneau, le moteur effectue une étape unique de préparation de la base de données (rails db:chatwoot_prepare), requise par Chatwoot avant le premier démarrage, puis lance les deux conteneurs longue durée : le serveur web (panneau de l'agent et widget de chat) et le worker Sidekiq en arrière-plan (notifications, e-mails, automatisations).
5. L'installation dure plus longtemps que pour les recettes plus simples, car elle inclut le téléchargement de l'image, la préparation de la base de données et le démarrage de deux conteneurs sur la même image. Le moteur attend que les deux soient effectivement démarrés, au lieu de s'arrêter à leur lancement.
6. Sous le domaine indiqué apparaît l'assistant de création du premier compte.

Première connexion et configuration

1. Accède au domaine que tu as indiqué lors de l'installation.
2. Contrairement à la plupart des recettes Saplo, Chatwoot ne crée pas automatiquement de compte administrateur. Tu dois donc le créer toi-même dans l'assistant "Create your profile" : indique le nom de l'entreprise, l'adresse e-mail et le mot de passe. Ce compte devient le premier compte administrateur. Fais-le dès que possible après l'installation, car jusque-là le panneau est accessible à toute personne qui se rend sur le domaine.
3. Ajoute la première boîte de réception dans Paramètres -> Boîtes de réception -> Nouvelle boîte de réception -> Website, puis copie le code du widget de chat pour le coller sur le site du client.
4. Par défaut, Chatwoot configure uniquement l'en-tête de l'expéditeur des e-mails, sans les envoyer. Si tu veux que les invitations destinées aux agents et les notifications arrivent dans les boîtes de réception, configure ton propre serveur SMTP dans Paramètres -> Compte -> SMTP Settings.
5. Tu trouveras les instructions complètes de la première connexion et de prévisualisation des journaux des conteneurs dans le fichier CHATWOOT-SETUP.txt du Catalogue d'applications.

Chatwoot sur Saplo face aux alternatives

Questions fréquentes

Le compte administrateur est-il créé automatiquement, comme dans les autres recettes d'installation de Saplo ? Non. Chatwoot n'a pas de variables permettant de créer automatiquement un compte, tu dois donc le créer toi-même dans l'assistant "Create your profile" lors de ta première connexion au domaine. Fais-le immédiatement après l'installation, car jusque-là le panneau est accessible à la première personne qui s'y rend.

Quelle base de données utilise Chatwoot ? Chatwoot utilise son propre conteneur PostgreSQL avec l'extension pgvector, et non la base MySQL partagée de Saplo. La recette d'installation le met automatiquement en place, tu n'as donc pas à créer ta propre base.

Les invitations d'agents et les notifications sont-elles envoyées automatiquement par e-mail ? Par défaut, non, l'installation configure uniquement l'en-tête de l'expéditeur. Pour que les e-mails arrivent réellement dans les boîtes de réception, configure ton propre serveur SMTP dans Paramètres -> Compte -> SMTP Settings après ta première connexion.

Combien de boîtes de réception (Inbox) puis-je rattacher à une même installation ? Sans limite. Tu peux connecter un site web, une adresse e-mail ou un réseau social en tant que boîtes de réception distinctes dans le même panneau, chacune avec son propre widget ou sa propre adresse.

Pourquoi l'installation nécessite-t-elle le plan Box M et pas un plan inférieur ? Parce que la recette d'installation lance quatre conteneurs en même temps : l'application, le worker Sidekiq, la base PostgreSQL et Redis, ce qui exige au minimum 2 GB de RAM disponibles. Sur Box S, il n'y a généralement pas assez de mémoire libre.

Il est facile de perdre une conversation de chat lorsqu'un client revient un mois plus tard. Tu peux gérer tes contacts, tes opportunités de vente et l'historique de tes échanges dans EspoCRM sur Saplo, sans frais par utilisateur.

Si tu veux cesser de payer pour chaque agent supplémentaire chez Intercom ou Zendesk et garder les conversations avec tes clients sur ton propre serveur, tu peux déployer Chatwoot sur Saplo en quelques minutes. Écris-nous si tu as besoin d'aide pour configurer SMTP ou créer ta première boîte de réception.