- Accueil
- Ressources
- Intégrations
- Beeminder
Intégration Beeminder n8nAutomatiser Beeminder avec n8n.
Un objectif Beeminder n'avance que si une donnée arrive dessus. L'intégration Beeminder n8n ouvre 18 opérations réparties sur 4 ressources, du point de données unique à la réécriture complète d'un objectif. Aucun nœud trigger côté Beeminder : c'est un Schedule Trigger ou un webhook qui lance le workflow.
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
À quoi sert vraiment l'intégration Beeminder n8n ?
Beeminder suit un engagement sous forme de ligne à ne pas quitter, et le nœud n8n sert de tuyau vers cette ligne. Il crée, lit et modifie des objectifs, envoie des points de données à l'unité ou par lot, agit sur le pledge attaché à un objectif et remonte le compte associé au credential. Chaque action est un appel à l'API Beeminder signé avec ton jeton, déclenché par ce qui démarre le workflow.
Le montage le plus courant part du travail déjà tracé ailleurs. Une tâche passe en terminé dans ClickUp, le workflow récupère le temps passé et appelle datapoint.create avec cette durée dans Value. Le champ Comment reçoit le nom de la tâche, ce qui évite de se retrouver dans six mois devant un graphique de chiffres sans contexte. Personne n'ouvre Beeminder pour saisir quoi que ce soit.
Vient ensuite le pilotage du pledge, la mécanique d'engagement propre à Beeminder. goal.stepDown fait redescendre le pledge d'un objectif, goal.cancelStepDown annule cette descente, goal.shortCircuit le court-circuite, et goal.uncle fait dérailler l'objectif en prélevant le montant du pledge. Un workflow qui lit l'objectif chaque matin avec goal.get envoie l'alerte sur Slack avant que la question se pose.
Troisième usage : le reporting. datapoint.getAll sort les points de données d'un objectif, Return All activé pour tout ramener, et les lignes partent dans Google Sheets pour la revue mensuelle. Sur un compte avec plusieurs objectifs, goal.getAll en amont donne la liste sans qu'il faille la maintenir à la main quelque part.
Tout ce qui sort de ces 18 opérations passe par le nœud HTTP Request, qui appelle n'importe quel endpoint de l'API Beeminder en réutilisant le même credential via l'authentification prédéfinie. C'est la porte de sortie qui évite de bloquer sur une opération absente du catalogue. Pour monter ce type de workflow proprement dès le départ, la Formation n8n couvre la partie n8n.
Comment connecter Beeminder à n8n ?
- 01
Générer le jeton dans Beeminder
Il faut d'abord un compte Beeminder. Le Auth Token personnel se récupère depuis l'option Apps & API des Account Settings, ou en appelant l'endpoint d'API
auth_tokensi tu préfères l'automatiser. Note au passage à quel utilisateur Beeminder ce jeton appartient : cette information est demandée à l'étape suivante, et c'est là que ça coince le plus souvent. - 02
Créer le credential dans n8n
Dans n8n, ouvre le menu Credentials et ajoute un credential Beeminder. Un credential, c'est un jeu d'identifiants enregistré une fois et réutilisé dans tous les workflows. Renseigne le champ User avec le nom de l'utilisateur Beeminder, et le champ Auth Token avec le jeton généré juste avant. Le nœud propose aussi un type de credential OAuth2 si ça colle mieux à ton installation.
- 03
Tester avec une opération qui ne demande rien
Pose un nœud Beeminder dans un workflow et choisis le credential dans la liste déroulante, où il apparaît par son nom. Sélectionne une ressource parmi Goal, Datapoint, Charge et User, puis une opération. Commence par
goal.getAll: aucun champ obligatoire, donc une liste d'objectifs qui revient prouve que le jeton fonctionne avant d'écrire la moindre donnée.
Les 18 opérations Beeminder dans n8n
Le nœud Beeminder expose 18 opérations sur 4 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.
| Ressource | Create | Get | Get Many | Update | Delete | Cancel Step Down | Create All | Get Archived | Refresh | Short Circuit | Step Down | Uncle |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Charge | ✓ | |||||||||||
| Datapoint | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||||
| Goal | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
| User | ✓ |
Sommaire des opérations
Charge
1 opérationCreate a charge
charge.createCe que tu vois dans n8n
Notes & cas d'usage
Cette opération prélève directement sur le compte Beeminder rattaché au credential, sans passer par un objectif. Elle crée la charge et renvoie l'enregistrement correspondant.
Paramètres clés
- Amount : le montant de la charge en USD, saisi comme un nombre.
- Note : l'explication attachée à la charge, en texte libre, à remplir pour que la ligne reste lisible plus tard.
- Dry Run : activé, l'appel est testé sans prélèvement réel. C'est comme ça qu'on construit la branche avant de l'armer.
Datapoint
6 opérationsCreate datapoint for goal
datapoint.createCe que tu vois dans n8n
Notes & cas d'usage
Une valeur, un objectif. C'est l'opération qui porte la majorité des automatisations Beeminder, puisqu'un objectif ne bouge que quand un point de données y arrive.
Paramètres clés
- Goal Name or ID : choisi dans la liste déroulante des objectifs, ou construit par expression quand le nom vient d'un nœud précédent.
- Value : le nombre envoyé à l'objectif, souvent
{{ $json.value }}récupéré à l'étape d'avant. - Timestamp : vaut « maintenant » si rien n'est transmis.
- Request ID : une chaîne qui identifie le point de données de façon unique, pour qu'une exécution rejouée ne compte pas deux fois.
Create multiple datapoints at once
datapoint.createAllCe que tu vois dans n8n
Notes & cas d'usage
Même objectif, plusieurs valeurs, un seul appel. Plutôt qu'une boucle qui rejoue le nœud ligne par ligne, tout le lot part ensemble.
Paramètres clés
- Goal Name or ID : l'objectif auquel appartient tout le lot, donc un appel ne peut pas se répartir sur deux objectifs.
- Datapoints : un tableau d'objets en JSON, chacun avec une valeur et, si besoin, un timestamp ou un commentaire, sur le modèle
[{"value": 1, "comment": "First datapoint"}].
Delete a datapoint
datapoint.deleteCe que tu vois dans n8n
Notes & cas d'usage
Supprime un point de données enregistré sur un objectif. Le graphique se redessine sans lui, ce qui compte quand une valeur fausse a déjà tiré la ligne dans le mauvais sens.
Paramètres clés
- Goal Name or ID : l'objectif sur lequel se trouve le point, pris dans la liste ou résolu par expression.
- Datapoint ID : l'identifiant du point lui-même, pas son commentaire ni sa valeur. Il faut donc l'avoir lu dans un nœud précédent avant de supprimer.
Get a single datapoint
datapoint.getCe que tu vois dans n8n
Notes & cas d'usage
Récupère un point de données précis et renvoie ce que Beeminder a réellement stocké. Utile comme étape de vérification, pas comme source de données nouvelles.
Paramètres clés
- Goal Name or ID : l'objectif dans lequel chercher, un point de données se lisant toujours dans le contexte de son objectif.
- Datapoint ID : l'identifiant exact de l'enregistrement demandé.
Get many datapoints for a goal
datapoint.getAllCe que tu vois dans n8n
Notes & cas d'usage
Renvoie les points de données rattachés à un objectif. C'est l'opération à prendre dès qu'un export ou un rapport est au bout de la chaîne.
Paramètres clés
- Goal Name or ID : le seul champ obligatoire ici.
- Return All : coché, n8n enchaîne les pages de l'API et rapporte tous les points ; décoché, Limit plafonne le nombre d'items renvoyés.
- Sort : l'attribut sur lequel trier.
- Page et Per Page : la pagination commence à la page 1, et Per Page vaut 25 par défaut et reste ignoré tant que Page n'est pas renseigné.
Update a datapoint
datapoint.updateCe que tu vois dans n8n
Notes & cas d'usage
Modifie un point déjà posé sur l'objectif au lieu d'en ajouter un second à côté, ce qui garde le total juste.
Paramètres clés
- Goal Name or ID et Datapoint ID : les deux sont obligatoires et désignent ensemble l'enregistrement à corriger.
- Value : le nombre corrigé à envoyer.
- Comment et Timestamp : rangés dans Update Fields, et sur une mise à jour le timestamp conserve celui qui existait si rien n'est transmis.
Goal
10 opérationsCreate a new goal
goal.createCe que tu vois dans n8n
Notes & cas d'usage
Crée un objectif de zéro, avec la forme de sa ligne décidée dès la création.
Paramètres clés
- Goal Slug : l'identifiant unique de l'objectif, la valeur que les autres opérations attendront ensuite.
- Goal Title : le titre lisible par un humain.
- Goal Type : au choix
hustler,biker,fatloser,gainer,inboxer,drinkeroucustom. - Goal Units : ce qui est compté, par exemple des heures, des pages ou des kilos.
- Rate et Initial Value : le rythme attendu en unités par jour, et la valeur de départ à la date du jour.
- Dry Run : teste l'endpoint sans rien créer.
Get a specific goal
goal.getCe que tu vois dans n8n
Notes & cas d'usage
Relit un objectif et ses attributs. C'est le premier nœud naturel de toute branche qui doit décider quelque chose.
Paramètres clés
- Goal Name or ID : l'objectif à lire, depuis la liste ou par expression.
- Include Datapoints : activé, la réponse embarque les points de données avec l'objectif, ce qui économise un second appel.
- Emaciated : retire les attributs road, roadall et fullroad de l'objet objectif, pour alléger la réponse quand ils ne servent pas.
Get many goals
goal.getAllCe que tu vois dans n8n
Notes & cas d'usage
Liste les objectifs du compte rattaché au credential. Rien n'est obligatoire, donc c'est le chemin le plus court pour vérifier qu'un credential fonctionne.
Paramètres clés
- Emaciated : la seule option disponible ici, qui retire road, roadall et fullroad de chaque objet objectif renvoyé.
Get archived goals
goal.getArchivedCe que tu vois dans n8n
Notes & cas d'usage
Renvoie les objectifs archivés plutôt que les actifs. Autre liste, autre question : ce qui a été suivi avant, pas ce qui tourne aujourd'hui.
Paramètres clés
- Emaciated : même option que sur les autres listes d'objectifs, elle enlève road, roadall et fullroad des objets renvoyés.
Update a goal
goal.updateCe que tu vois dans n8n
Notes & cas d'usage
Modifie un objectif existant, y compris sa ligne. C'est l'opération la plus lourde du côté Goal, et celle à manipuler avec attention.
Paramètres clés
- Goal Name or ID : l'objectif à modifier, seul champ obligatoire.
- Title et Y-Axis : le titre lisible et le libellé de l'axe des ordonnées du graphique.
- Tmin et Tmax : les dates minimale et maximale, toutes deux au format
yyyy-mm-dd. - Road All : un tableau de tableaux qui définit la bright red line, chaque sous-tableau contenant une date, une valeur et un rythme, dont un champ à null.
- Tags : un tableau de tags alphanumériques qui remplace les tags existants.
Refresh goal data
goal.refreshCe que tu vois dans n8n
Notes & cas d'usage
Exécute l'action Refresh goal data sur un objectif. Elle vise l'objectif que tu désignes, et c'est le seul réglage que le nœud propose pour elle.
Paramètres clés
- Goal Name or ID : l'objectif à rafraîchir, sélectionné dans la liste ou construit par expression quand le nom voyage dans l'item.
Short circuit pledge
goal.shortCircuitCe que tu vois dans n8n
Notes & cas d'usage
Exécute l'action Short Circuit Pledge sur un objectif, l'opération de pledge nommée telle quelle dans le catalogue. Elle s'applique au seul objectif que tu désignes.
Paramètres clés
- Goal Name or ID : l'objectif dont le pledge est court-circuité. Rien d'autre n'est demandé, ce qui rend le nœud facile à déclencher par erreur : place-le derrière une condition explicite.
Step down pledge
goal.stepDownCe que tu vois dans n8n
Notes & cas d'usage
Exécute l'action Step Down Pledge sur un objectif. Comme les autres opérations de pledge du nœud, elle ne demande que le nom de l'objectif et s'exécute sans étape de confirmation.
Paramètres clés
- Goal Name or ID : l'objectif à faire redescendre, pris dans la liste déroulante ou résolu depuis l'item entrant.
Cancel step down
goal.cancelStepDownCe que tu vois dans n8n
Notes & cas d'usage
Exécute l'action Cancel Step Down sur un objectif. C'est le pendant de l'opération précédente, celle à câbler dans tout chemin de retour arrière.
Paramètres clés
- Goal Name or ID : l'objectif dont le step down est annulé. Comme pour les autres opérations de pledge, le nom de l'objectif suffit au nœud.
Derail a goal and charge the pledge amount
goal.uncleCe que tu vois dans n8n
Notes & cas d'usage
Fait dérailler l'objectif et prélève le montant du pledge. De tout le nœud, c'est l'opération avec une conséquence financière réelle, et elle s'exécute sans étape de confirmation.
Paramètres clés
- Goal Name or ID : l'objectif à faire dérailler. La description du champ le dit ainsi, donc une expression qui pointe le mauvais item coûte de l'argent au lieu de lever une erreur.
User
1 opérationGet user information
user.getCe que tu vois dans n8n
Notes & cas d'usage
Renvoie l'utilisateur Beeminder rattaché au credential. Aucun champ obligatoire : ce sont les options qui décident de la quantité d'informations qui revient.
Paramètres clés
- Associations : inclut les associations dans la réponse.
- Diff Since : seuls les objectifs et points de données créés ou modifiés depuis cet horodatage sont renvoyés, ce qui transforme une lecture complète en lecture incrémentale.
- Skinny : renvoie des données utilisateur minimales.
- Datapoints Count : le nombre de points de données à inclure.
Besoin d'aide pour automatiser Beeminder avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.