POST /external-integration/sale, /acquisition, /rental) appliquent automatiquement une logique de déduplication et d’allocation.
1. Déduplication du contact
- Recherche d’un contact existant par téléphone ou email dans le groupe d’agences.
- Si trouvé : mise à jour des informations du contact.
- Sinon : création d’un nouveau contact.
2. Déduplication de la transaction
Si un contact existant est trouvé, recherche d’une fiche de ce contact à rapprocher :- Vente : vente active à la même adresse pour ce contact.
- Location : la location la plus récente de ce contact à la même adresse, quelle que soit son étape. Une location archivée (
RARC) est rouverte à l’étape calculée (ou àsettings.step). - Acquisition : une acquisition du contact, quelle que soit son étape (une acquisition n’a pas d’adresse : ce sont des critères de recherche). Si le contact en a plusieurs, la priorité suit l’étape :
ANGT,ASRC,AQUL,ACLS,AOFR, puisAARC. Une fiche archivée n’est reprise que si le contact n’en a pas d’autre.
parsingCustomId est enregistré sur la fiche mais n’intervient pas dans
la déduplication : seuls le téléphone, l’email et l’adresse servent au
rapprochement. Deux envois avec le même parsingCustomId et deux adresses
différentes créent deux ventes. Une fois la fiche connue, ciblez-la par son
identifiant avec PATCH Sale.La déduplication peut être désactivée par requête via
settings.allocation.disableDeduplication: true.3. Allocation
- Attribution automatique d’une agence et d’un utilisateur selon les règles configurées.
- Vous pouvez forcer l’attribution via
settings.allocation:agencyId: force l’agence, qui doit figurer dans GET AgenciesuserId: force l’utilisateur (nécessiteagencyId)
4. Étape (routing)
- L’étape d’une nouvelle transaction est calculée automatiquement selon le projet et la configuration de l’agence, ou forcée via
settings.step. - Sur une transaction retrouvée par la déduplication,
settings.stepest ignoré, sauf pour rouvrir une location archivée. Changez l’étape d’une vente avec PATCH Sale, celle d’une acquisition avec Qualifier un acquéreur.
Alertes
Par défaut, un email d’alerte « nouveau lead » est envoyé à l’utilisateur attribué. Désactivez-le par requête avecsettings.disableAlerts: true. Ce réglage ne coupe que cet email : les autres notifications de l’agence, comme le message Slack « nouveau lead » d’une vente, partent quand même.