Chatwoot

À propos de Chatwoot

Ce qui est installé

Prêt au démarrage du VPS

OS compatibles

Ubuntu 24.04

Application

Chatwoot

Stack technique

DockerRuby on Railspgvector/PostgreSQL 15Redis 7Sidekiq

RAM minimum

2 Go (4 Go recommandé au-delà de 10 agents)

CPU minimum

2 vCPU

Port par défaut

3000

Accès

root par SSH

Fonctionnalités clés

• Boîte de réception partagée omnicanale : e-mail, chat en direct, WhatsApp, Telegram, Facebook et messages privés Twitter/X dans un même tableau de bord
• Widget de chat intégrable sur n'importe quel site via un extrait JavaScript de deux lignes, personnalisable depuis l'interface
• Réponses préenregistrées et règles d'automatisation : affectation automatique, message de première réponse, routage par langue ou par mot-clé
• Travail en équipe : notes internes, attribution des conversations, mentions et files d'attente par équipe, visibles en temps réel
• CRM intégré : fiches contacts avec historique complet, attributs personnalisés et étiquettes
• API REST et webhooks pour relier Chatwoot à Zapier, n8n, Activepieces ou votre propre back-end

Quand utiliser cette solution ?

Guide

Déployer Chatwoot sur votre VPS

1. 1

   Commander le VPS

   Prévoyez au minimum 2 Go de RAM et 2 vCPU sous Ubuntu 24.04 : le serveur Rails, le worker Sidekiq, PostgreSQL et Redis consomment environ 1,2 Go au repos. Comptez 4 Go au-delà d'une dizaine d'agents connectés simultanément ou d'un volume de conversations soutenu.

2. 2

   Déployer depuis le Marketplace

   Dans votre espace client ServOrbit, ouvrez le Marketplace, catégorie Collaboration et productivité, puis lancez le déploiement de Chatwoot. Docker récupère l'image chatwoot/chatwoot:latest et démarre la pile ; un conteneur de migration prépare la base avant que le serveur web et le worker ne s'ouvrent. Laissez 60 à 90 secondes au premier démarrage.

3. 3

   Se connecter la première fois

   Ouvrez l'URL dès que l'installation est terminée : un écran d'accueil vous fait créer le premier compte (nom, e-mail, mot de passe) et ce compte devient propriétaire de l'espace de travail.

4. 4

   Créer le compte administrateur

   Si un domaine est attaché à l'app, ouvrez https://votre-domaine — sans numéro de port : le vhost nginx et le certificat TLS sont déjà en place. Sans domaine, il n'y a pas d'accès public : ouvrez un tunnel SSH avec ssh -L 3000:127.0.0.1:3000 root@<ip-du-vps> (3000 est le port du catalogue, donné en exemple — reportez-vous au port affiché sur la fiche de votre app dans l'espace client), puis ouvrez http://localhost:3000. L'assistant de première ouverture vous demande votre nom, votre e-mail et un mot de passe : ce compte devient le super-administrateur. Vous inviterez ensuite les autres agents et créerez les équipes depuis les réglages.

5. 5

   Pointer le domaine et fixer FRONTEND_URL

   Attachez le domaine qui portera votre support — par exemple support.votre-domaine.tld — à l'application depuis votre espace client : ServOrbit installe le vhost nginx et le certificat TLS, et les renouvelle ensuite tout seul. Vous n'avez ni proxy inverse à installer ni certificat à demander. C'est ce domaine que ServOrbit inscrit dans FRONTEND_URL, l'adresse sur laquelle Chatwoot s'appuie pour les redirections OAuth, les liens contenus dans les e-mails et l'URL du script du widget : vérifiez qu'elle correspond bien au domaine que vous utilisez avant d'ouvrir vos boîtes de réception.

6. 6

   Ouvrir la première boîte de réception

   Dans Réglages puis Boîtes de réception, ajoutez un canal : site web pour le chat en direct, e-mail en IMAP/SMTP, ou messagerie comme l'API WhatsApp Cloud et Telegram. Pour le chat, copiez l'extrait JavaScript généré dans le <head> de votre site. Invitez ensuite vos agents et créez vos règles d'automatisation.