Anexus envoie chaque contact capturé sur le tableau que vous nous indiquez, sous forme de nouvel élément. Toute l'intégration repose sur une question que monday.com pose et que les autres CRM ne posent pas : dans quelle colonne typée chaque valeur doit-elle aller ?
Tableaux, éléments et colonnes — le vocabulaire de monday
Rien dans monday.com ne s'appelle « enregistrement » ni « objet prospect ». Trois mots portent toute l'intégration, et les connaître rend chaque étape ci-dessous évidente :
- Tableau — la table où vivent vos prospects. Il a un identifiant numérique et se trouve dans un espace de travail. Un tableau est Principal (visible par l'espace de travail), Partageable (invités inclus) ou Privé (seuls ses abonnés le voient — y compris via l'API).
- Élément — une ligne. Son nom est le seul champ que chaque élément possède à coup sûr. Les éléments se rangent dans des groupes (les bandes colorées du tableau).
- Colonne — un champ typé : courriel, téléphone, texte, texte long, statut, personne, date, nombres. Le type est figé dès la création de la colonne, et monday.com rejette une valeur qui ne correspond pas au type au lieu de la convertir.
Si vous utilisez le produit monday CRM, ses tableaux Prospects et Contacts sont des tableaux ordinaires en dessous — mêmes identifiants numériques, mêmes colonnes typées, même API. Indiquez le tableau Prospects à Anexus et il se comporte comme n'importe quel autre tableau.
Avant de commencer
- Un forfait monday.com qui inclut l'accès à l'API (la plupart des forfaits payants en disposent). L'allocation API du compte évolue selon le niveau de forfait, et monday.com la mesure selon la complexité des requêtes autant que selon leur nombre.
- Un tableau prêt à recevoir des éléments. Un simple tableau « Prospects » avec une colonne Courriel, une colonne Téléphone et une colonne Texte suffit. Si vous n'en avez pas, créez-le d'abord dans monday.com.
- Un utilisateur monday.com disposant de droits de modification sur ce tableau, à partir duquel générer le jeton. Un jeton hérite exactement des permissions de son propriétaire — un siège Observateur ou Invité peut lire un tableau mais ne peut pas y créer d'éléments.
Étape 1 — Préparez le tableau avant toute connexion
Faites-le en premier, pas en dernier. L'identifiant interne d'une colonne monday.com est attribué une seule fois, à sa création, et renommer la colonne ensuite ne le modifie pas. Bien configurer les colonnes avant de connecter prend une minute et vous évite de courir après des éléments à moitié vides ensuite.
Ouvrez (ou créez) le tableau qui accueillera vos prospects.
Ajoutez une véritable colonne Courriel, une véritable colonne Téléphone et une colonne Texte (ou Texte long) — choisies dans le sélecteur de types de colonnes de monday. Une colonne texte simplement intitulée « Courriel » reste une colonne texte.
Nommez-les Email, Phone et Text. Anexus cherche une colonne Texte nommée « notes » ou « text » pour y placer le message : conservez donc ce nom anglais même sur un tableau en français. Nommer les deux autres de la même façon garde le tout lisible. Restez simple — une colonne Courriel, une colonne Téléphone, une colonne Texte.
Étape 2 — Copiez votre jeton API personnel
Dans monday.com, cliquez sur votre avatar de profil (en bas à gauche) → Developers pour ouvrir le Developer Center.
Ouvrez My access tokens (mes jetons d'accès) et cliquez sur Show à côté de votre jeton personnel.
C'est un JWT : une longue chaîne eyJ..., généralement de plus de 200 caractères, en trois segments séparés par des points. Copiez-la en entier. Un JWT tronqué à un saut de ligne a encore l'air correct et échoue immédiatement à la validation.
Le jeton est personnel. Anexus demande un jeton API personnel, et ce jeton agit en votre nom — il est lié à une seule personne. Si cet utilisateur est désactivé, retiré du compte ou rétrogradé à un siège Observateur, le jeton ne peut plus créer d'éléments. Sur un compte partagé, générez-le à partir d'un utilisateur qui sera encore là l'an prochain.
Étape 3 — Relevez l'identifiant du tableau dans l'URL
Ouvrez le tableau sur lequel vous voulez créer les éléments.
Regardez l'URL dans votre navigateur. Elle ressemble à :
https://yourcompany.monday.com/boards/1234567890
Les chiffres qui suivent immédiatement /boards/ sont l'identifiant du tableau. Copiez uniquement les chiffres.
Si l'URL contient autre chose ensuite — /views/… ou /pulses/… — ignorez-le. Un identifiant de vue et un identifiant d'élément (monday appelle les éléments « pulses » en interne) sont des nombres totalement différents, et coller l'un des deux est la cause la plus fréquente d'une erreur « tableau invalide ».
Étape 4 — Connectez dans Anexus
Dans Anexus, allez à Paramètres → Intégrations CRM → monday.com → Connecter.
Remplissez :
- Identifiant du tableau : l'identifiant numérique copié depuis l'URL
- Jeton API personnel : le JWT
eyJ...complet
Cliquez sur Enregistrer et connecter.
Ce qu'un contact Anexus devient sur votre tableau
Un contact capturé devient un élément. Le nom de l'élément est la seule partie toujours écrite; toute autre valeur a besoin d'une colonne typée correspondante pour atterrir.
| Ce qu'Anexus a capté | Où cela atterrit dans monday.com | Colonne nécessaire |
|---|---|---|
| Nom complet | Le nom de l'élément | intégré — bascule sur l'adresse courriel si aucun nom n'a été fourni |
| Courriel | La colonne Courriel du tableau | toute colonne de type courriel |
| Téléphone | La colonne Téléphone du tableau | toute colonne de type téléphone |
| Message | Une colonne Texte nommée « notes » ou « text » | type texte ou texte long, trouvée par ce nom |
| Entreprise, titre du poste | Ne fait pas partie des colonnes remplies automatiquement | ajoutez vos propres colonnes et remplissez-les dans monday, ou consultez-les dans le Mini CRM d'Anexus |
| Un contact sans courriel valide | Aucun élément n'est créé | ignoré avant d'atteindre monday.com |
Si votre tableau utilise des colonnes nommées différemment, l'élément est tout de même créé avec seulement son nom — rien n'est jeté parce qu'une colonne manque, et vous pourrez compléter le reste à la main ensuite. Pour de meilleurs résultats, nommez vos colonnes email, phone et text.
Le titre d'une colonne et son identifiant sont deux choses différentes
Chaque colonne monday.com porte deux noms. Le titre est ce que vous voyez sur le tableau et que vous pouvez renommer à volonté. L'identifiant de colonne est généré une seule fois, à la création, et ne change jamais — renommer une colonne intitulée « Courriel professionnel » en « Email » laisse donc son identifiant exactement tel qu'il était. L'API désigne les colonnes par leur identifiant, jamais par leur titre.
C'est pourquoi un tableau qui semble parfait peut quand même produire des éléments vides, et pourquoi renommer une colonne n'y change rien. Relevez les vrais identifiants avant de toucher au tableau — le paragraphe suivant explique comment. Ne supprimez pas une colonne qui contient déjà des données pour tenter de forcer un autre identifiant : supprimer une colonne monday.com supprime toutes les valeurs qu'elle contient, sur tous les éléments du tableau. Si une colonne refuse toujours de se remplir, rien n'est perdu — la fiche complète reste sur le contact dans le Mini CRM d'Anexus. Complétez le tableau à la main et contactez le soutien.
Pour voir les vrais identifiants, utilisez l'API playground du Developer Center de monday et interrogez les colonnes de votre tableau — il renvoie côte à côte l'id, le title et le type de chaque colonne, ce qui règle la question en une dizaine de secondes.
Un tableau n'est pas une base de contacts — prévoyez les doublons
Les CRM classiques traitent l'adresse courriel comme une clé unique et fusionnent discrètement une seconde soumission dans l'enregistrement existant. Un tableau monday.com n'a pas cette notion : un élément est une ligne, et la même personne rencontrée deux fois donne deux lignes. Composez avec cela plutôt que de lutter — triez ou groupez le tableau par la colonne Courriel, ou ajoutez une automatisation monday.com (« lorsqu'un élément est créé… ») pour attribuer un responsable, notifier quelqu'un ou déplacer l'élément dans un groupe de révision afin que rien ne reste sans suite.
Si quelque chose ne fonctionne pas
« monday : tableau invalide »
L'identifiant du tableau est incorrect, ou le tableau est hors de portée de votre jeton. Vérifiez dans cet ordre :
- Vous n'avez copié que les chiffres après
/boards/— pas un identifiant de vue, pas un identifiant de pulse (élément), pas de barres obliques - Le tableau est privé. Un tableau privé est invisible pour quiconque n'y est pas abonné, API comprise — ajoutez le propriétaire du jeton comme abonné du tableau, ou passez le tableau en Principal
- Le tableau n'a pas été archivé ni mis à la corbeille. Un tableau archivé conserve son identifiant mais cesse d'accepter de nouveaux éléments
- Vous pouvez ouvrir ce tableau en étant connecté en tant que la personne dont vous avez collé le jeton — pas en tant que vous-même, si ce sont deux personnes différentes
L'élément apparaît, mais toutes les colonnes sont vides
C'est le symptôme classique de monday.com et ce n'est presque jamais le jeton — le jeton a manifestement fonctionné, puisque l'élément existe. Soit les colonnes du tableau portent des identifiants internes qui ne sont pas ceux attendus par l'intégration (voir plus haut), soit le type de colonne ne correspond pas à la valeur : une adresse courriel proposée à une colonne statut ou nombres est refusée d'emblée plutôt que stockée comme texte. Vérifiez le type et le véritable identifiant de chaque colonne dans l'API playground avant de modifier quoi que ce soit, et ne supprimez pas une colonne qui contient déjà des données. Si elle refuse toujours de se remplir, acceptez la saisie manuelle et gardez la fiche complète dans le Mini CRM d'Anexus.
La colonne Téléphone reste vide alors que Courriel se remplit bien
La colonne téléphone de monday.com ne stocke pas une simple chaîne — elle stocke un numéro accompagné d'un pays. Un numéro saisi sans indicatif de pays, ou entouré d'espaces, de tirets et de parenthèses, peut être accepté puis s'afficher vide. Si la plupart de vos prospects sont canadiens et écrivent 514-555-0123, attendez-vous à cela. Le numéro n'est pas perdu : il reste sur le contact dans le Mini CRM d'Anexus, et demander l'indicatif de pays sur votre formulaire d'échange est le remède le plus propre.
Ça fonctionnait depuis des mois, puis l'autorisation a cessé
Les jetons personnels meurent avec l'accès de leur propriétaire. Vérifiez si cet utilisateur monday.com a été désactivé, retiré du compte, rétrogradé à un siège Observateur, désabonné du tableau — ou si quelqu'un a cliqué sur Regenerate sur le jeton. Générez un nouveau jeton, collez-le à nouveau, et utilisez le bouton Tester de la carte connectée pour confirmer avant de vous y fier.
Une grosse exécution de « Synchroniser les contacts passés » cale en cours de route
Le budget API de monday.com se mesure par compte, pas par application, et il compte la complexité des requêtes autant que les appels. Un rattrapage entre donc en concurrence avec toutes les autres intégrations, automatisations et applications installées sur le même compte monday.com. Les contacts refusés restent en attente et le prochain clic sur Synchroniser les contacts passés les reprend — lancez donc le rattrapage en dehors de votre heure la plus chargée, puis recliquez ensuite.
Les éléments ne sont pas où je les cherche
Avant de conclure que rien n'est arrivé, vérifiez deux choses. Regardez dans tous les groupes du tableau, pas seulement celui que vous surveillez. Et les vues de tableau mémorisent leurs filtres — une vue filtrée sur un statut ou un responsable masque les toutes nouvelles lignes qui n'en ont ni l'un ni l'autre. Passez à la vue Tableau principal et effacez le filtre.
Se déconnecter et faire tourner le jeton
Cliquez sur Déconnecter dans Anexus et nous cessons immédiatement de créer des éléments. Les éléments déjà sur le tableau restent exactement où ils sont — nous ne retournons jamais dans monday.com pour supprimer quoi que ce soit.
Pour révoquer les identifiants d'accès du côté de monday : Avatar de profil → Developers → My access tokens → Show → Regenerate. Un avertissement propre à monday.com — un jeton personnel est une seule et même clé, pas une clé par application. Le régénérer l'invalide pour tous les outils, scripts et automatisations où cet utilisateur l'a déjà collé, pas seulement Anexus.