La Fin CLI (@intercom/cli) est un outil en ligne de commande conçu pour les développeurs et les agents de codage IA, tels que Claude Code, Cursor ou Codex, pour configurer, paramétrer et gérer Intercom et Fin de manière programmatique. Vous pouvez orienter votre agent de codage vers la CLI et lui demander en langage clair de configurer Fin, importer du contenu ou modifier votre configuration Fin et Messenger, sans quitter votre environnement de codage. Chaque commande est conçue pour fonctionner sans invites interactives, avec une sortie JSON structurée et des messages d'erreur clairs pour une utilisation dans des workflows automatisés. En savoir plus sur fin.ai/cli.
Exigences
Node.js 18 ou supérieur (v20.6.0+ recommandé)
Un espace de travail Intercom dans la région US (les autres régions ne sont pas encore prises en charge)
Fin CLI ou Fin Agent API MCP server ? Utilisez la Fin CLI lorsque vous souhaitez qu’un agent de codage configure ou modifie votre espace de travail, comme configurer des procédures, des guides, des audiences, des connecteurs de données, des workflows, le Messenger ou des articles. Utilisez le Fin Agent API MCP server lorsque vous souhaitez qu’un agent utilise Fin, par exemple pour lui poser des questions ou exécuter des procédures au nom d’un utilisateur.
Installation
Installez la CLI globalement via npm :
npm install -g @intercom/cli
Ou exécutez-la directement sans installation globale :
npx @intercom/cli
Authentification
La CLI propose trois méthodes d’authentification selon votre configuration :
auth login — Entrez un jeton existant directement.
auth bootstrap — Créez automatiquement une application et récupérez un jeton en utilisant votre email et mot de passe.
auth signup — Créez un tout nouvel espace de travail Intercom à partir de zéro.
Les identifiants sont stockés en toute sécurité dans le trousseau de votre système (macOS Keychain, Windows Credential Manager ou Linux libsecret), avec une sauvegarde dans un fichier chiffré. Les jetons expirent après environ 14 jours. Il n’y a actuellement pas de rafraîchissement automatique des jetons — vous devrez vous réauthentifier lorsque votre jeton expirera.
Commandes clés
Configuration de l’espace de travail en une seule commande
La commande intercom setup automatise la création de l’espace de travail, l’installation du Messenger et la population du help center en une seule étape — aucune interface utilisateur requise.
intercom setup
Ingestion de contenu depuis Markdown
Remplissez votre help center en pointant la CLI vers un répertoire local de fichiers Markdown :
intercom setup --content-dir ./docs
Accès brut à l’API
La commande intercom api offre un accès direct à n’importe quel point de terminaison de l’API Intercom, similaire à la façon dont la CLI GitHub fonctionne avec gh api :
intercom api
Configuration de Fin
Gérez les procédures, guides, audiences, connecteurs de données, simulations et workflows de Fin directement depuis le terminal — pas besoin de visiter l’interface Intercom.
Utilisez la CLI avec Claude Code ou un autre agent de codage
Installez et authentifiez la CLI, puis demandez à votre agent de codage ce que vous souhaitez faire en langage clair. Par exemple, « Configurez Fin sur notre site et importez ./docs/help comme articles », ou « N’affichez le lanceur Messenger qu’aux users connectés ». L’agent exécute les commandes CLI correspondantes pour vous. Pour vérifier ce qu’il va changer avant toute application, demandez-lui d’utiliser les options --plan ou --dry-run d’abord.
Gestion des ressources
La CLI inclut des commandes dédiées pour gérer les ressources Intercom courantes :
Commande | Opérations |
intercom articles | lister, obtenir, créer, mettre à jour, supprimer |
intercom contacts | lister, obtenir, créer, mettre à jour, supprimer |
intercom conversations | lister, obtenir, répondre |
intercom help-center | lister, obtenir, créer |
intercom messenger | obtenir, mettre à jour, extrait |
intercom fin | procédures, guides, audiences, connecteurs de données, simulations, workflows |
intercom me | afficher les infos de l’espace de travail actuel |
Modes planification et simulation
Deux options sont disponibles pour valider les commandes avant leur exécution :
--plan : Liste les étapes que la CLI effectuerait sans les exécuter. Utile pour les agents IA qui examinent un workflow avant de s’engager.
--dry-run : Valide la commande et ses entrées sans effectuer de modifications.
Modes de sortie
Toutes les commandes supportent --json pour une sortie structurée adaptée à un passage vers d’autres outils. Vous pouvez aussi filtrer la sortie en ligne avec --jq — aucune installation système de jq requise.
Limitations connues
Région US uniquement — les autres régions ne sont pas encore prises en charge.
Les jetons expirent après environ 14 jours sans rafraîchissement automatique.
Les commandes auth signup et auth bootstrap utilisent des points de terminaison internes qui peuvent nécessiter des exceptions Web Application Firewall (WAF) dans certains environnements de production.
Node.js 18 ou supérieur est requis. Le flux OAuth via navigateur n’est pas encore pris en charge — l’authentification par jeton (auth login --token) est la principale méthode prise en charge.