Dois-je créer un webhook dans mon instance ?

Non. 0seat crée son bot d’agent et enregistre son webhook lui-même, avec le jeton d’administrateur. Vous ne déclarez rien à la main.

Pourquoi un jeton d’administrateur, et pas celui d’un agent ?

Parce que créer un bot d’agent et le rattacher à des boîtes demande des droits d’administration. Le jeton est chiffré, jamais réaffiché, remplaçable à tout moment.

Combien de temps prend le branchement ?

Nous ne publions pas de durée : elle dépend de votre instance et du paiement. Les trois étapes de l’assistant tiennent en quelques minutes ; la reprise de l’historique prend ensuite le temps de votre volume.

Puis-je brancher plusieurs instances ?

Oui : un espace par instance ou par compte, chacun avec sa base de données, son abonnement et ses réglages.

Brancher sa boîte de réception à 0seat

Avant de commencer

Vous avez besoin d’un compte 0seat (connexion par code reçu par e-mail ou par Google, sans mot de passe), d’un accès administrateur à votre instance Chatwoot et d’une carte bancaire : elle est demandée avant le premier espace, sans essai gratuit.

Dans votre instance, deux informations : le jeton d’accès d’un administrateur (Profil, puis « Jeton d’accès ») et l’identifiant du compte, c’est-à-dire le nombre qui suit « /accounts/ » dans l’adresse de l’application. Le jeton doit être celui d’un administrateur : 0seat s’en sert pour créer le bot d’agent et le brancher, ce qu’un agent ordinaire ne peut pas faire.

Créer l’espace en trois étapes

Dans la console, ouvrez « Espaces » puis « Nouvel espace ». L’assistant compte trois étapes : l’identité de l’espace, la connexion, le profil de l’assistant.

Identité : un nom (par exemple « Support client ») et un identifiant en minuscules, chiffres et tirets. L’identifiant figure dans l’adresse du webhook et ne change plus ensuite.
Connexion : l’adresse de votre instance, l’identifiant du compte et le jeton d’administrateur. Cliquez sur « Tester la connexion » : la console confirme le nombre de boîtes de réception trouvées. Sans ce test réussi, l’étape suivante reste fermée. Le jeton est chiffré à l’enregistrement et ne sera plus jamais affiché.
Profil : le modèle « Hébergeur web (WHMCS) » ou « Générique », qui fixe les catégories de la base ; la marque que l’assistant donne à votre entreprise ; une phrase sur votre métier ; la langue de la base de connaissances.
« Créer l’espace » : la console crée l’espace et ouvre le paiement ; la préparation de sa base et le branchement suivent sa confirmation.

Le paiement, puis le branchement

Le paiement vient avant la préparation : un espace dont le paiement n’est pas confirmé reste « en attente de paiement », et la console propose « Payer et activer ». Le paiement passe par Stripe. Une fois confirmé, 0seat prépare la base de données propre à l’espace, puis crée le bot d’agent dans votre instance et y enregistre l’adresse de son webhook, qui porte l’identifiant de l’espace et un secret.

Si une étape échoue (instance injoignable, jeton révoqué), l’espace reste dans un état cohérent et la console affiche l’étape restante avec un bouton « Reprendre la préparation ». Rien n’est à refaire depuis le début.

Régler les boîtes de réception

Une fois l’espace branché, la section « Boîtes de réception » liste les boîtes du compte. Chaque boîte a une nature (classique, paiements, WhatsApp non officiel) et un mode. La nature détectée d’après votre instance ne peut pas être changée : une boîte dont le nom parle de paiement ou de facturation est une boîte de paiements, un canal WhatsApp hors de l’API officielle est marqué comme tel.

Le mode par défaut est « Désactivé » : 0seat ne touche pas la boîte. Passez en « Brouillon (note privée) » les boîtes où vous voulez des propositions de réponse. Le mode « Automatique » envoie les réponses directement, dans les catégories qui passent la mesure ; le serveur le refuse d’office sur les boîtes de paiements, sur WhatsApp non officiel et, quand WHMCS est actif, tant que l’identité des visiteurs n’est pas vérifiée par le widget.

Ce qui se passe ensuite

La reprise de l’historique commence par lots dès que l’espace est servi, hors de la fenêtre nocturne. L’extraction des conversations résolues tourne ensuite chaque nuit, dans la fenêtre de l’espace (par défaut de deux à six heures du matin, à l’heure de l’espace). Vous pouvez déclencher l’une ou l’autre depuis « Santé », bouton « Lancer maintenant ».

Les premières fiches arrivent dans la base de connaissances comme candidates. Rien ne sert avant votre validation : c’est l’objet du guide suivant. Les brouillons commencent dès qu’il existe des fiches validées et qu’une boîte est en mode brouillon.

Pour remplacer le jeton d’administrateur plus tard, ou renouveler le secret du webhook, la page de l’espace a une section pour chacun : le nouveau jeton est testé avant d’être enregistré, et un nouveau secret rebranche le même bot.