Le prospect reçoit deux relances pour le même formulaire. Son entreprise figure déjà dans monday CRM et une commerciale vient de rattacher la demande à une opportunité. La réponse de l’API s’est perdue et le connecteur a créé un deuxième lead. L’équipe doit retrouver le bon dossier avant le prochain appel.
La référence du formulaire doit permettre de retrouver la demande après chaque reprise. Le marketing peut enrichir sa provenance. La commerciale décide de l’étape du dossier. L’ERP fournit le numéro de la commande confirmée. Attribuez ces champs avant d’autoriser une écriture automatique.
Sur un tableau pilote, prenez une demande fictive, DEMO-482. Faites perdre la réponse de création, puis renvoyez la demande après un changement d’étape. La reprise est acceptable si le support retrouve le premier item et si la commerciale conserve l’étape qu’elle a validée.
Pour cadrer les échanges avec vos formulaires, vos équipes et votre ERP, découvrez notre accompagnement en intégration monday CRM.
Choisir le premier flux à ouvrir dans monday CRM
Suivre une demande jusqu’à son attribution
Sur le pilote, prenez un formulaire, un tableau et une règle d’attribution. Envoyez la même demande deux fois, puis demandez à la commerciale de changer l’étape avant le second passage. L’équipe doit pouvoir retrouver une seule demande et constater que le changement d’étape a été conservé.
Si le formulaire arrive avec une entreprise inconnue, créez une demande à qualifier. Si plusieurs entreprises correspondent à la même adresse ou au même domaine, exposez les candidats au commercial. Le coût d’un rapprochement manuel sur quelques dossiers est mesurable. Un faux rattachement peut fausser la relance, le reporting et la commande qui suit.
Commencez avec les nouvelles demandes du formulaire. Laissez l’import historique en lecture jusqu’à avoir rapproché les anciennes références. Ce choix limite la recette aux opérations dont l’origine et la date peuvent être prouvées.
Attribuer chaque champ au marketing, aux ventes ou à l’ERP
Pour DEMO-482, le formulaire fournit sa référence et sa provenance, monday CRM porte le responsable et l’étape, puis l’ERP renvoie son numéro de commande. Le tableau peut afficher les trois informations. Le connecteur doit savoir qui a le droit de modifier chacune d’elles.
- Provenance de la demande. Le marketing enrichit la campagne et conserve la référence de soumission.
- Étape et responsable. La commerciale les modifie dans monday CRM. Un nouvel envoi du formulaire laisse ces valeurs en place.
- Numéro de commande. L’ERP le renvoie après création. Tant que le numéro manque, le support distingue une vente gagnée d’une commande confirmée.
Séparer l’identifiant de la demande et celui du contact
Une adresse partagée peut ouvrir plusieurs demandes. Gardez la clé de soumission pour dédupliquer le formulaire et l’identifiant de l’item monday pour retrouver l’écriture. Pour définir l’identité du compte et de l’opportunité dans les outils voisins, appuyez-vous sur le guide de fiabilisation d’un pipeline CRM.
Si le contact d’une demande est fusionné, gardez la référence de soumission et mettez à jour le lien vers le contact retenu. Le support doit pouvoir expliquer ce changement à partir de l’ancienne et de la nouvelle référence de contact.
Relever les identifiants et les types de colonnes
Relevez le tableau et les colonnes avec le compte technique prévu pour le pilote. Consignez leurs identifiants, leurs types et la version d’API retenue. Testez les droits en lecture, puis une écriture sur un élément de recette. Une copie de tableau peut afficher les mêmes noms de colonnes tout en exigeant un autre mapping.
query ColonnesDuPilote($boardIds: [ID!]!) {
boards(ids: $boardIds) {
id
columns { id title type }
}
}
Envoyez la variable {"boardIds":["1234567890"]} avec l’identifiant du tableau pilote. Vérifiez ensuite l’identifiant retourné. Le libellé aide l’administrateur à reconnaître le champ. L’identifiant et le type déterminent le format à envoyer. Référence monday sur les tableaux et leurs colonnes.
Protéger les colonnes dérivées
Sur le tableau pilote, inventoriez les colonnes miroir et calculées dont les commerciaux se servent pour décider. Si un miroir doit afficher un lien vers une autre entité, testez la relation qui alimente ce miroir. Un contrôle visuel du libellé ne prouve pas que cette relation vise la bonne entreprise.
Dans le registre de mapping, indiquez le tableau source, la colonne de relation et l’identifiant attendu côté compte. Un miroir vide après import oriente alors la recherche vers une relation absente ou des droits insuffisants. L’équipe peut vérifier ces deux points avant d’ouvrir une correction manuelle.
Relier les demandes, les comptes et les opportunités
La demande DEMO-482 mène à un contact déjà connu. Conservez la relation vers ce contact et créez une demande distincte si son objet change. Rattachez-la à l’opportunité après décision du commercial. Vous pouvez alors suivre deux demandes d’un même contact sans transformer chacune en nouvelle opportunité.
Vérifier ce que déclenche un changement d’étape
Avant toute mutation de statut, relevez les automatisations qui réagissent à l’étape sur votre tableau. Dans le pilote, passez une seule fois à l’étape gagnée et vérifiez chaque effet attendu, comme l’envoi vers l’ERP ou la création d’une tâche. Un ancien événement de qualification doit pouvoir revenir sans déclencher à nouveau ces actions.
Si une transition a déjà transmis la commande, comparez les identifiants renvoyés par l’ERP avant de corriger l’étape dans monday. Une correction qui repasse par l’état gagné doit retrouver la commande existante à partir de la même clé métier.
Reprendre une mutation dont la réponse a été perdue
Enregistrez l’opération et la clé d’idempotence avant l’envoi. Après un délai d’attente dépassé, recherchez d’abord l’item par sa référence. Si une nouvelle tentative est nécessaire dans la fenêtre documentée par monday, renvoyez la même requête avec la même clé. Un conflit d’exécution concurrente peut renvoyer un délai dans Retry-After. Conservez le registre de rapprochement même si la réponse est trop volumineuse pour être gardée dans le cache de l’API. Conditions d’idempotence de monday.
Interpréter le résultat GraphQL avant d’enregistrer le succès
Inspectez le champ errors même avec HTTP 200. Si des données partielles sont présentes, relisez l’item et vérifiez les champs attendus avant de clôturer l’opération. Le cache d’idempotence peut restituer la même réponse GraphQL avec ses erreurs pendant 30 minutes. Après cette fenêtre, recherchez l’écriture à partir de la correspondance conservée et de la référence de demande avant d’envisager une nouvelle création. Codes d’erreur de l’API monday.
Un webhook sert à déclencher une lecture ciblée. Pour les événements qui touchent une étape ou une relation, comparez l’état courant à la règle métier avant de lancer une écriture. Le guide du SDK monday CRM sous Symfony couvre le client GraphQL et le mapping.
Choisir la reprise selon ce que le support peut prouver
- L’item existe et sa référence correspond. Enregistrez son identifiant et poursuivez au stade où le traitement s’est arrêté.
- Deux items portent la même référence. Isolez le dossier et faites arbitrer les liens vers l’opportunité avant de reprendre les écritures.
- La lecture échoue ou le tableau a changé. Gardez la demande ouverte et indiquez le motif dans le journal. Le support peut relancer la lecture après rétablissement de l’accès.
Pour DEMO-482, une réponse réseau perdue laisse l’opération en attente de vérification. La lecture retrouve l’item créé. Le connecteur enregistre cet identifiant et reprend uniquement l’enrichissement marketing encore attendu.
Tester cinq situations avant de raccorder la production
- Le formulaire envoie deux fois
DEMO-482. Une seule demande est retrouvée. - Le même contact envoie une autre demande. Les références restent distinctes et pointent vers le même contact.
- La réponse à la création est perdue. La reprise confirme l’item créé et conserve son identifiant.
- La commerciale qualifie l’opportunité. Une notification plus ancienne arrive ensuite. L’étape visible reste qualifiée.
- L’administrateur recrée une colonne dans la copie du tableau. Le contrôle bloque l’écriture et donne l’identifiant attendu.
Pour chaque scénario, notez la référence de départ, l’état visible après reprise et l’action que le support peut effectuer. Lorsqu’une écriture peut créer une commande, vérifiez également la pièce dans l’ERP et conservez son identifiant avec le dossier de recette.
Erreurs fréquentes sur le tableau pilote
Une colonne de statut peut garder son nom après recréation. Dans ce cas, contrôlez son identifiant et son type au démarrage des écritures. Vérifiez aussi la valeur réelle de l’item de recette après une mutation. Un statut visible dans la liste des choix peut déclencher une automatisation différente de celle du tableau de production.
Si le traitement cherche un dossier par adresse seule, testez une adresse de service partagée par deux demandes. Le résultat attendu est deux références distinctes et un rattachement explicite décidé par l’équipe commerciale.
Donner au support les preuves nécessaires pour reprendre un dossier
Sur un incident, le support doit pouvoir chercher DEMO-482 et retrouver le tableau, l’item, l’opération, la réponse et le dernier état contrôlé. Conservez un identifiant de corrélation dans les journaux. Limitez l’accès aux données de contact et gardez les jetons d’accès hors de ces traces.
Surveillez l’âge des dossiers dont l’issue est inconnue et le nombre de demandes mises de côté pour un conflit d’identité. Fixez un délai d’intervention à partir du temps promis pour la première relance. Un seul blocage ancien sur le tableau pilote peut justifier une intervention même si le taux d’erreur global reste faible.
Décider quand étendre le pilote à un second tableau
Étendez le flux si la commerciale retrouve son dossier, si le support sait expliquer une reprise et si l’ERP confirme le même résultat après deux passages. Faites relire le mapping du second tableau à son responsable. Reportez les écritures sur les colonnes partagées jusqu’à ce que leurs propriétaires aient arbitré les conflits.
Guides complémentaires pour surveiller les écarts
Si le connecteur confirme les écritures alors que des dossiers manquent à l’écran, utilisez le guide de rapprochement entre source et cible pour distinguer les dossiers absents, les champs divergents et les notifications en retard.
Lorsqu’un changement d’étape arrive tard, les exercices sur la réception des webhooks permettent de vérifier séparément l’accusé de réception, la mise en file et la reprise de l’événement.
Conclusion — retrouver la même demande après chaque reprise
Choisissez un tableau et une demande de recette que les équipes peuvent suivre du formulaire à la commande. Préparez le mapping avec les propriétaires de chaque champ.
Faites ensuite perdre la réponse d’une écriture et livrez une ancienne notification après un changement d’étape. Demandez au support de retrouver l’état réel à partir de la seule référence de la demande.
Ouvrez le second tableau lorsque la reprise a produit une seule demande et que les décisions prises par la commerciale restent visibles dans monday CRM.
Dawap peut vous accompagner dans l’intégration de monday CRM à votre système d’information, du choix du tableau pilote à la recette des reprises.