Passer à la navigation

Trello

Transformez les demandes des appelants en cartes Trello avec un outil webhook.

Votre réceptionniste peut ajouter une carte à une liste Trello lorsqu’un appelant demande à être rappelé, un devis ou tout autre élément que votre équipe doit suivre. Un outil webhook crée la carte via l’API REST de Trello.

Avant de commencer

1

Obtenez une clé API

Accédez au portail d’administration Power-Up, créez un Power-Up pour votre Workspace (le nom importe peu), ouvrez son onglet Trello Auth, puis sélectionnez Generate a new API key.

2

Générez un jeton

Sélectionnez le lien Token à côté de votre clé API, ou ouvrez cette URL dans un navigateur après avoir remplacé API_KEY par votre clé API :

https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&name=Reception&key=API_KEY

Sélectionnez Allow et copiez le jeton. Il peut lire et modifier tous les tableaux auxquels vous avez accès ; envisagez donc de le générer depuis un compte qui est uniquement membre du tableau dont vous avez besoin.

3

Trouvez l’ID de la liste

Ouvrez le tableau dans votre navigateur, ajoutez .json à la fin de son URL et chargez la page. Recherchez le nom de la liste ; la valeur id située à côté correspond à l’ID de la liste.

Créer l’outil webhook

Accédez à Integrations, sélectionnez Add integration, puis choisissez Webhook Tool.

ChampValeur
Nomcreate_trello_card
Description”Créez une carte pour l’équipe chaque fois que vous promettez un suivi à l’appelant ou que celui-ci demande quelque chose que l’équipe doit traiter.”
MéthodePOST
URLhttps://api.trello.com/1/cards?idList=LIST_ID
En-têtes de requêteAuthorization: OAuth oauth_consumer_key="API_KEY", oauth_token="TOKEN"
Paramètres du corpsname (chaîne, obligatoire) : “Titre court avec le nom de l’appelant et ce dont il a besoin, par exemple : Rappeler Jane Doe au sujet d’un devis.”
desc (chaîne, obligatoire) : “Le nom, le numéro de téléphone de l’appelant et les détails de sa demande.”
Attribuer aux agentsRéceptionniste

Saisissez ?idList=LIST_ID directement dans le champ URL, avec l’ID de votre liste. N’ajoutez pas idList comme paramètre de requête : les paramètres de requête sont renseignés par l’IA, tandis que le texte dans l’URL est envoyé exactement tel qu’il est écrit.

Trello accepte également la clé et le jeton dans l’URL, sous la forme &key=API_KEY&token=TOKEN. Cette méthode fonctionne aussi, mais l’en-tête évite de les inclure dans l’URL. Si vous les placez dans l’URL, considérez l’URL entière comme un secret.

Sélectionnez Enable, puis testez votre réceptionniste en demandant à être rappelé. La carte apparaît en bas de la liste.

Résolution des problèmes

ProblèmeVérifications à effectuer
Trello renvoie 401Vérifiez l’en-tête : la clé et le jeton doivent chacun être entre guillemets doubles, séparés par une virgule et une espace. Générez à nouveau le jeton s’il a été révoqué.
invalid value for idListL’ID de la liste dans l’URL est incorrect. Utilisez l’id de la liste, et non celui du tableau.
Trello renvoie 404 ou aucun accèsL’utilisateur associé au jeton doit être membre du tableau.
Le réceptionniste ne crée jamais de cartesAssurez-vous que la description de l’outil indique les situations dans lesquelles il doit en créer une.