Connecter Trello

À quoi sert cette connexion ?

Trello permet à ELChat de parcourir les tableaux, listes et cartes accessibles au compte, puis de créer, déplacer ou commenter des cartes.

Ce dont vous avez besoin

Identifiant	Rôle	Confidentialité
Clé API	Identifie l’application Trello	La clé seule n’accède pas aux données
Jeton utilisateur	Autorise l’application au nom du membre	Secret à protéger

ELChat effectue des lectures et des écritures : le jeton doit être autorisé avec les scopes Trello read,write. Le scope account n’est pas nécessaire aux actions implémentées.

Étape 1 — Créer la clé et le jeton

1. Connectez-vous à Trello avec le membre qui possède les tableaux concernés.
2. Ouvrez Trello Apps Admin.
3. Créez ou sélectionnez un Power-Up servant à l’intégration ELChat.
4. Ouvrez son onglet API Key.
5. Cliquez sur Generate a new API Key si aucune clé n’existe.
6. Lancez l’autorisation d’un jeton pour cette clé avec les scopes read,write et une durée conforme à votre politique.
7. Acceptez l’accès, puis copiez le jeton affiché.

La procédure et les paramètres d’autorisation sont détaillés dans la documentation officielle Trello. Le lien historique trello.com/app-key affiché dans certaines interfaces peut désormais rediriger vers la gestion des Power-Ups.

Étape 2 — Connecter Trello à ELChat

1. Ouvrez Dashboard > votre site > Actions IA > Connecteurs.
2. Cliquez sur Connecter sur la carte Trello.
3. Collez la clé API.
4. Collez le jeton utilisateur.
5. Validez.

Vérifier la connexion

Demandez à ELChat de lister les tableaux accessibles, puis les colonnes d’un tableau test et les cartes d’une colonne. Comparez les résultats avec Trello avant toute création.

Capacités disponibles

Capacité réelle	Type
Lister les tableaux accessibles	Lecture
Lister les colonnes d’un tableau	Lecture
Lister les cartes d’une colonne	Lecture
Consulter une carte, son échéance, ses membres et sa colonne	Lecture
Créer une carte dans une colonne	Écriture
Déplacer une carte vers une autre colonne	Écriture
Ajouter un commentaire à une carte	Écriture

ELChat ne supprime pas de carte, ne crée pas de tableau ou de colonne et ne gère pas les checklists, pièces jointes ou automatisations.

Reconnecter et déconnecter

Générez ou autorisez un nouveau jeton, reconnectez et testez la liste des tableaux. Révoquez l’ancien depuis Paramètres du compte Trello > Applications. Désactiver dans ELChat n’invalide pas à lui seul le jeton.

Problèmes fréquents

• Jeton invalide / 401 : le jeton est expiré ou révoqué ; autorisez-en un nouveau.
• Écriture refusée : le jeton a seulement read ou le membre n’a pas le droit de modifier le tableau.
• Tableau absent : le membre du jeton n’en est pas membre ou le tableau est fermé.
• Erreur 429 : Trello limite notamment les appels par clé et par jeton ; attendez avant de réessayer.

Sécurité et limites

Un jeton peut accéder à l’ensemble du compte Trello du membre selon ses scopes. Utilisez un membre dédié et révoquez immédiatement un jeton exposé. Le connecteur ne pagine pas explicitement toutes les grandes collections ; une organisation très volumineuse peut ne pas être parcourue en une seule demande.

Exemple : tableau de suivi commercial

Créez un membre ou un Power-Up dédié ELChat — Tests, autorisez les scopes read,write, puis connectez la clé API et le jeton dans ELChat. Listez les tableaux, choisissez Prospects — Test, puis contrôlez la liste À qualifier et une carte connue avant toute création.

Le membre limite le périmètre et la lecture confirme que le jeton voit le bon tableau. Les noms de tableau et de liste doivent venir des résultats de Trello : une valeur devinée peut viser une mauvaise destination ou échouer silencieusement.