Un prestataire ouvre deux conversations Intercom pour deux clients. Le CRM connaît déjà sa fiche de contact et affiche les deux dossiers sous le compte renseigné lors du premier échange. Le commercial du compte A voit alors la référence d’une demande qui concerne le compte B.
Le risque vient du raccourci entre la personne qui écrit et le compte concerné. Un même contact peut représenter plusieurs organisations. Le flux doit confirmer à quel compte appartient chaque conversation avant de la publier.
Le cas fictif IC-482 suit une conversation qui change d’équipe après la fusion d’un ancien contact. Il montre quelles données relire, quelle décision conserver et comment retrouver la fiche CRM après une reprise.
Pour définir ce parcours avec vos équipes, consultez notre accompagnement à l’intégration d’Intercom au CRM.
Définir ce que le CRM doit afficher
Dans IC-482, le commercial doit voir qu’un dossier est ouvert pour le compte B, quelle équipe le suit et quand la synthèse a été actualisée. L’agent support continue de répondre dans Intercom. Le CRM tient le compte commercial et les droits associés. Intercom fournit l’état de la conversation et son affectation.
Commencez par cette vue de lecture. Un titre libre, un message ou une pièce jointe peut révéler des informations qu’une simple référence suffit à retrouver dans Intercom. Si l’équipe demande une synthèse, validez ses champs et son public avant d’étendre la copie.
Retrouver le contact après une fusion
Le connecteur conserve l’identifiant du contact dans son workspace Intercom et le lien confirmé avec sa fiche CRM. Si l’application renseigne external_id, définissez le référentiel qui produit cette valeur. L’email peut servir à rechercher des candidats. Une boîte partagée ou une adresse modifiée exige une validation supplémentaire.
Suivre le contact conservé sans déplacer l’historique
Après une fusion Intercom d’un lead vers un utilisateur, l’ancien identifiant renvoie un 404. Conservez un alias dans l’intégration quand la cible a été confirmée, par exemple à partir du résultat de l’opération. Un 404 isolé ne suffit pas à identifier la cible. Fusion d’un lead et d’un utilisateur dans l’API Intercom.
Le support peut alors retrouver qui avait ouvert IC-482. Le compte qui porte cette conversation reste soumis à sa propre décision. Paradoxalement, une identité de contact mieux rapprochée peut provoquer une fuite si le flux en profite pour réattribuer toutes ses anciennes conversations au dernier compte connu.
Choisir le compte de la conversation
La lecture d’une conversation Intercom expose des participants et peut fournir une entreprise associée selon la réponse et la version utilisées. Le connecteur vérifie la correspondance de cette entreprise avec le compte CRM. Une référence de commande déjà rattachée au dossier peut aussi donner une preuve. Champs retournés par la lecture d’une conversation.
Intercom permet de lister les entreprises associées à un contact. Dans IC-482, cette liste contient A et B. Les deux restent des candidats tant que le support n’a pas confirmé la commande CMD-482 du compte B. Si l’entreprise associée à la conversation et la commande désignent des comptes différents, alors la publication attend un arbitrage. Liste des entreprises rattachées à un contact Intercom.
Définir le contrat de publication dans le CRM
Le contrat d’entrée associe le workspace, l’identifiant de la conversation et la preuve du compte retenu. La sortie donne une seule fiche de suivi avec l’état, l’équipe, la date de lecture et un accès à Intercom selon les droits de l’utilisateur. Le support tient la responsabilité du rapprochement en cas d’écart. Le guide d’intégration CRM au SI aide à formaliser les responsabilités par champ.
Le journal interne de recette peut conserver cette forme. Les champs ci-dessous appartiennent à l’intégration.
{
"case": "IC-482",
"workspace": "support-b2b",
"conversation_id": "482",
"crm_account": "B",
"proof": "CMD-482",
"decision": "publish"
}
À 10 h 16, l’équipe support confirme la commande de B. Si un agent corrige ce choix plus tard, la mise à jour doit porter la nouvelle preuve et remplacer la décision de publication dans le CRM. Le journal garde les deux décisions. La vue du compte suit uniquement celle qui est en vigueur.
Recevoir et vérifier les notifications
Le récepteur contrôle la signature X-Hub-Signature sur le corps reçu avec le secret de l’application. Il identifie ensuite le workspace d’après la configuration de la souscription et enregistre durablement l’identifiant de notification et les références nécessaires avant de répondre. Le worker prend en charge la lecture et la publication. Signature et structure des notifications Intercom.
Un événement ancien peut être traité après un événement récent. Si le changement touche le rattachement, l’accès ou l’affectation, alors relisez la conversation et comparez-la à la décision publiée. Fixez la version d’API utilisée et testez les topics réellement configurés avec le compte d’intégration.
Deux notifications distinctes peuvent aussi concerner le même changement d’équipe. Dédupliquez la réception par identifiant de notification, puis rendez la mise à jour de la fiche idempotente sur sa propre clé. Si un worker a déjà publié la même affectation pour le compte confirmé, le suivant peut clôturer son traitement sans créer une autre fiche.
Répartir les droits de modification
Le CRM fournit le niveau de service du compte. Intercom tient l’équipe qui traite la conversation. Un transfert de conversation peut mettre à jour l’équipe affichée dans le CRM sans modifier le responsable du compte commercial. Le connecteur documente les deux champs et la règle d’écriture associée.
Si une mise à jour du niveau de service envoyée vers Intercom revient dans une notification, le worker peut reconnaître l’effet attendu à partir de sa trace d’opération et du champ relu. Limitez la suppression à cet effet précis. Une autre modification sur la même conversation doit encore être examinée.
Limiter l’accès au contexte support
Le compte technique peut avoir besoin d’une visibilité plus large que celle d’un commercial. La vue CRM contrôle l’accès au compte à chaque consultation, puis laisse Intercom vérifier l’accès à la conversation à l’ouverture du lien. Le journal des reprises conserve des références et des décisions, avec les droits et la durée de conservation définis pour cet usage.
Si IC-482 a déjà été publiée sous A, commencez par retirer son accès sous A. La nouvelle publication attend la vérification des droits sur B. Contrôlez aussi les vues qui indexent la fiche et les exports qui peuvent l’inclure. Testez le retrait avec des comptes de recette ayant les droits de A et de B.
Retrouver une fiche après une réponse perdue
Si la création de la fiche CRM perd sa réponse, gardez le dossier en rapprochement. La clé de publication peut associer workspace et conversation, avec un type d’effet si d’autres écritures sont prévues. Une contrainte locale empêche les workers concurrents de traiter simultanément la même intention.
Recherchez cette clé dans le CRM si le modèle cible le permet. Si une fiche correspondante existe, vérifiez le compte et attachez son identifiant à la tentative. Si le CRM ne permet aucune preuve fiable, gardez la reprise automatique suspendue jusqu’à l’arbitrage. Idempotence et reprise des écritures métier.
Contrôler les écarts après une interruption
Après une coupure, relisez les conversations modifiées depuis la dernière fenêtre confirmée avec un léger chevauchement. La recherche POST /conversations/search accepte un filtre sur updated_at. Si une page échoue, reprenez la fenêtre avec ses filtres d’origine et rapprochez les dossiers déjà traités par identifiant. Avancez le point de contrôle après la dernière page confirmée. Recherche et pagination des conversations Intercom.
Conservez aussi la liste des écarts qui nécessitent une décision. Le rattrapage peut se terminer alors que le support doit encore vérifier le compte d’un dossier. La documentation des webhooks décrit des situations où une notification peut manquer après plusieurs tentatives. Livraison et limites des notifications Intercom.
Comparez l’état et le compte des conversations retenues au CRM. Un historique incomplet se signale séparément. La lecture d’une conversation peut retourner jusqu’à 500 parties, avec les plus récentes lorsque cette limite est dépassée. Le diagnostic sur l’historique Intercom et la limite des 500 parties détaille le contrôle de la copie.
Suivre la décision de rattachement
Suivez les conversations sans compte confirmé, l’âge de la plus ancienne décision en attente et les fiches CRM retrouvées après une coupure. Si les dossiers sans compte augmentent uniquement pour un workspace, commencez par vérifier son contrat de données et sa configuration. Un tableau qui compte seulement les webhooks reçus ne montre pas le résultat de la publication.
Rejouer le dossier IC-482
Associez un contact de test à A et B. Livrez deux fois la même notification, puis inversez l’ordre du transfert et de la mise à jour. La recette passe si la commande confirmée rattache la conversation à B, si l’affectation affichée correspond à l’état relu et si A n’accède à aucune fiche de B.
Simulez ensuite une fusion confirmée et une perte de réponse après l’écriture CRM. Le support doit retrouver le contact conservé et une seule fiche pour IC-482. Fixez le seuil du pilote à zéro publication sous un compte erroné, même si le délai de synchronisation reste dans la cible.
Erreurs fréquentes lors du rapprochement
- Prendre le premier compte de la liste. Attendez une référence qui désigne le compte de la conversation.
- Redéduire les anciens comptes après une fusion. Conservez la preuve historique et traitez chaque changement d’accès avec le support.
- Relancer tout le lot après une coupure. Comparez d’abord les états et les références avant d’écrire à nouveau.
Ouvrir le flux sur une équipe pilote
Commencez par un workspace et un motif de conversation dont le compte peut être vérifié à partir d’une référence de commande. Le support dispose d’une file pour les cas ambigus. L’équipe commerciale vérifie ses droits dans le CRM et confirme que les champs affichés suffisent à son usage.
Étendez ensuite une seule dimension à la fois. Si une publication apparaît sous le mauvais compte, alors suspendez les nouvelles publications du flux concerné, retirez les accès erronés et faites vérifier les autres dossiers de la même règle avant de rouvrir.
Approfondir l’historique et le rapprochement
Quand le CRM doit aussi exposer des messages, le guide sur la reprise de l’historique Intercom aide à documenter la couverture de la copie et les parties manquantes.
Pour examiner un dossier déjà publié, le guide de réconciliation entre la source et la cible propose de vérifier la correspondance, la fraîcheur et l’action de reprise séparément.
Conclusion
Choisissez une conversation dont le contact travaille pour deux comptes. Faites valider la preuve qui identifie le bon dossier.
Rejouez la fusion, le transfert et la perte de réponse avec le support. Le test doit retrouver la fiche existante et vérifier qui peut l’ouvrir.
Ouvrez le flux suivant quand ces vérifications restent possibles depuis l’identifiant de conversation, même après une interruption.
Notre équipe peut vous aider à cadrer les correspondances, les droits et la recette de votre intégration Intercom et CRM.