Comment une agence importe son catalogue CRM dans Seeki.eu

Dernière révision : 2026-08-11

Votre CRM contient déjà chaque bien que votre agence gère, avec les photos, les prix et les descriptions. Placer ce catalogue sur un autre portail se traduit d'ordinaire par un opérationnel qui ressaisit annonce après annonce, ou par un développeur qui devine une spécification de flux que personne n'a écrite. Voici à quoi ressemble réellement le chemin vers Seeki.eu, de l'export CRM aux annonces que les acheteurs de toute l'Europe peuvent trouver.

Que doit réellement faire une agence pour démarrer ?

Cinq étapes, et une seule demande du vrai travail.

1. Lancez d'abord l'abonnement. Une clé API est émise face à un abonnement actif : le tableau de bord ne crée pas de clé avant que vous en ayez un, et l'API d'import refuse une clé dont l'abonnement a depuis expiré. Il n'existe qu'une seule formule, il n'y a donc rien à dimensionner ni à négocier. Ce qu'elle comprend est exposé sur la page agences.
2. Générez une clé API. Le tableau de bord affiche la clé complète une seule fois, à la création, et n'en conserve qu'une empreinte : mettez-la dans votre coffre à secrets avant de fermer la fenêtre. Les clés se renouvellent ou se révoquent ensuite depuis le même écran.
3. Mappez l'export de votre CRM vers un format pris en charge. Trois sont acceptés : le schéma JSON Seeki.eu, documenté champ par champ ; OpenImmo, en XML brut ou en archive zip réunissant le XML et les fichiers photos ; et Idealista XML-ML. Si votre système émet déjà l'un d'eux, cette étape relève surtout du paramétrage.
4. Envoyez le catalogue à l'API d'import, sur ingest.seeki.eu. Les gros catalogues partent en série de lots plutôt qu'en un seul fichier énorme.
5. Surveillez l'écran des imports. Chaque annonce a sa propre ligne avec son état courant, le motif en cas d'échec, et une relance qui n'exige pas de renvoyer tout le flux.

L'étape 3 est celle où se concentre l'effort. Les étapes 4 et 5 tournent de notre côté.

Que devient une annonce une fois arrivée ?

Une annonce n'apparaît pas sur le portail à l'instant où votre requête se termine. Chaque élément est traité séparément et de façon asynchrone : il est validé, son adresse est résolue en un point sur la carte, ses champs dérivés sont calculés, il est écrit dans le catalogue, puis il est scoré. Un problème à l'une de ces étapes marque ce seul élément comme échoué avec un motif précis et laisse le reste du lot suivre son cours.

En pratique, les échecs se concentrent à deux endroits. Le premier est un champ obligatoire manquant, détecté par le schéma avant toute autre chose. Le second est la localisation : une adresse impossible à résoudre en un point, ou des coordonnées qui tombent hors du pays de l'annonce. Les deux sont des problèmes de données en amont, les deux se nomment eux-mêmes dans le tableau de bord, et les deux se corrigent dans le CRM puis se relancent sans renvoyer le flux.

Chaque annonce qui arrive reçoit aussi une note d'annonce et un score de localisation, les deux signaux sur lesquels les acheteurs peuvent filtrer et trier. Ce que mesurent ces deux chiffres vaut dix minutes du temps d'un responsable des opérations, car la note réagit directement à la qualité de votre export : le nombre de champs remplis, le nombre de photos envoyées et la consistance de la description la font toutes bouger.

Combien de temps une annonce importée reste-t-elle en ligne ?

Soixante jours à compter de son dernier import réussi. Une tâche quotidienne dépublie tout ce qui dépasse ce délai, et le tableau de bord signale les annonces qui arrivent à échéance dans la semaine avant que cela n'arrive.

Cette seule règle façonne l'intégration plus que tout le reste de cette page. Renvoyer une annonce recharge sa durée de vie même si rien n'a changé, si bien que le schéma à construire est une resynchronisation nocturne de votre stock actif, non un téléversement massif ponctuel. Une agence qui importe une fois et jamais plus voit son catalogue se vider en silence au bout de deux mois.

Cela vous donne aussi une seconde façon, plus douce, de retirer un bien : cessez de l'inclure dans la resynchronisation et il s'éteint de lui-même.

Saisie manuelle ou import par API : que choisir pour votre agence ?

Deux voies réelles vers la plateforme, conçues pour des échelles très différentes.

Approche	Effort de mise en place	Convient à	Échelle jusqu'à
Saisie manuelle dans le tableau de bord	Aucun. Connectez-vous et commencez à saisir.	Quelques biens premium, ou une agence qui essaie la plateforme avant de brancher quoi que ce soit	Dizaines
Import par flux ou par API	Une matinée d'intégration, moins si votre CRM émet déjà de l'OpenImmo ou de l'Idealista XML	Une agence avec un CRM, des changements fréquents de prix et de statut, ou un stock dans plusieurs pays	Milliers, envoyés par lots

Le choix est généralement pragmatique. Si votre système exporte déjà en OpenImmo, ou si vous avez un développeur capable de produire notre JSON, l'API est la voie la plus économique et la seule qui tienne une actualisation nocturne. Une boutique avec une douzaine de biens premium a intérêt à les saisir à la main et à consacrer la matinée épargnée à la photographie, qui pèse plus sur l'intérêt des acheteurs que la plomberie.

Que montre réellement le tableau de bord des imports ?

L'écran de synthèse porte les compteurs sur lesquels un opérationnel mène sa journée : annonces en ligne, imports encore en cours, imports échoués, et annonces qui expirent dans la semaine. En dessous, l'écran des imports liste chaque élément avec l'identifiant externe utilisé par votre CRM, son état, un code d'erreur et un message en clair quand quelque chose s'est mal passé, filtrable pour n'afficher que les échecs.

Ouvrez une ligne et vous obtenez le payload que nous avons reçu à côté de l'erreur, ce qui suffit en général à distinguer un problème de données dans le CRM d'un problème de mapping dans l'export. Les lignes échouées portent une relance qui remet ce seul élément en file. Pas besoin de renvoyer tout un flux pour quelques enregistrements fautifs.

Pourquoi placer un catalogue national sur un portail paneuropéen ?

Parce que votre acheteur ne vit peut-être pas dans votre pays et ne cherche peut-être pas dans votre langue. Un catalogue qui n'existe que sur un portail national atteint les gens qui y cherchent déjà, dans cette langue, et s'arrête là. Seeki.eu est un portail unique pour tout le continent : le titre et la description d'une annonce se lisent dans la langue de navigation du visiteur, le prix s'affiche dans la devise qu'il choisit, et l'annonce figure dans le même jeu de résultats que des logements de l'autre côté de la frontière pour quiconque compare des marchés.

La portée dépasse aussi le site. Les acheteurs qui cherchent via un assistant IA peuvent atteindre le catalogue depuis ChatGPT et Claude, sans compte et sans configuration de votre côté. Si vous pesez où doit se trouver le stock d'une agence, notre panorama des principaux sites immobiliers d'Europe expose ce à quoi chaque type de portail sert vraiment.

Que couvre l'abonnement ?

Une seule formule : 99 € par mois, ou 990 € par an, soit deux mois de moins. Annonces illimitées, résiliation quand vous voulez. Il n'y a pas de frais par annonce en plus, pas de lot de crédits à acheter, et pas de palier de débit à négocier avant de commencer.

Une conséquence mérite d'être connue avant de souscrire plutôt qu'après. Si un abonnement est résilié ou suspendu, les annonces publiées de cette agence tombent avec lui, et la réactivation les remet en ligne. Une facture simplement en retard ne produit pas cet effet : tant qu'un paiement est en souffrance, les imports continuent de fonctionner et les annonces restent en ligne. L'état de facturation, la fin de période en cours et les factures figurent tous sur l'écran de facturation du tableau de bord, géré via le portail client de Stripe.

Questions fréquentes

Quels formats de flux puis-je envoyer ?

Trois. Le schéma JSON Seeki.eu est le nôtre : une forme plate et documentée qui couvre les champs d'annonce et les URL de photos. OpenImmo, la norme XML que la plupart des systèmes germanophones exportent, est accepté soit en XML brut, soit en archive zip réunissant le XML et les fichiers photos. Idealista XML-ML est accepté pour les systèmes espagnols et portugais dont l'export le parle déjà. La référence de l'API porte la liste complète des champs.

Comment sont gérés les doublons ?

Une annonce est identifiée par votre agence et par l'identifiant externe que votre CRM utilise déjà pour elle. Renvoyer ce même identifiant externe met à jour l'enregistrement existant au lieu d'en créer un second, et recharge du même coup sa durée de vie de 60 jours. C'est ce qui rend sûre une resynchronisation complète nocturne : vous n'avez besoin d'aucune logique de déduplication de votre côté, et renvoyer une annonce inchangée ne vous coûte rien.

Puis-je mettre à jour des annonces en masse ?

Oui, et il n'y a rien de distinct à appeler. Créer et mettre à jour sont la même opération : renvoyez une annonce avec des champs modifiés et l'enregistrement publié est rafraîchi. N'envoyez que le sous-ensemble qui a changé et les annonces absentes de ce lot ne sont pas touchées, avec une réserve qui mérite d'être répétée : une annonce que vous cessez d'envoyer cesse aussi de voir sa durée de vie de 60 jours rechargée.

Comment retirer une annonce ?

Deux façons, et aucune ne passe par un indicateur de statut dans le flux. Suspendez-la depuis l'écran des annonces du tableau de bord agence, ce qui la sort de la recherche et s'annule tout aussi facilement ; ou cessez de l'inclure dans votre resynchronisation et laissez sa durée de vie de 60 jours s'épuiser d'elle-même. Si un bien est vendu et que vous voulez la page hors ligne aujourd'hui, suspendez-la.

Une agence hors UE peut-elle importer un inventaire européen ?

Oui. Le lieu du siège de votre agence n'est pas vérifié. Ce qui compte, c'est que le bien se trouve dans l'un des marchés européens que nous couvrons et que son adresse se résolve en un point situé à l'intérieur de son propre pays. Un cabinet de Londres ou de New York détenant un inventaire espagnol ou tchèque utilise exactement la même intégration. Votre structure fiscale et contractuelle reste sous votre responsabilité ; notre contrat porte sur le service de diffusion.

En combien de temps une annonce importée est-elle en ligne ?

Chaque élément est pris en charge pour lui-même dès son arrivée, sans attendre une reconstruction nocturne, si bien qu'une annonce est normalement trouvable peu après l'acceptation du lot. Son titre et sa description sont traduits à la demande pour les acheteurs qui naviguent dans une autre langue, ce qui signifie qu'elle est trouvable dans sa langue source dès le départ et se lit dans la langue du visiteur dès qu'il l'ouvre.

Que deviennent mes annonces si je résilie ?

Elles sont dépubliées en même temps que l'abonnement, et elles reviennent si vous le réactivez. Un paiement en retard est traité différemment : tant qu'une facture est en souffrance, les imports continuent de fonctionner et les annonces publiées restent en ligne. Rien n'est supprimé à la fin d'un abonnement, si bien que la réactivation restaure le catalogue au lieu de vous obliger à le réimporter.

Étapes suivantes

Si votre agence est prête, le chemin est court : lancez l'abonnement, générez une clé, envoyez un petit lot de test depuis un vrai export CRM, suivez-le dans le tableau de bord, puis activez le flux nocturne. Nous maintenons volontairement la distance la plus courte possible entre « j'ai un export » et « les annonces sont en ligne dans toute l'Europe », et c'est à la plateforme d'absorber la complexité opérationnelle plutôt que de vous la rendre.

La page agences couvre ce que comprend l'abonnement, et la référence de l'API couvre la liste des champs, les codes d'erreur et la console interactive que votre développeur voudra garder ouverte le premier matin.