Comment une agence importe son catalogue CRM dans Seeki

Dernière révision : 2026-04-14

Une agence immobilière peut déplacer la totalité de son catalogue CRM dans Seeki via l'API d'ingestion. Depuis le tableau de bord de l'agence, on génère une clé, on envoie un lot d'annonces dans un format pris en charge, et chaque annonce est traitée et publiée sur les marchés européens où nous opérons, sans écrire de code sur mesure. Le tableau de bord affiche l'avancement de chaque élément, indique la raison des échecs et permet de relancer des lignes concernées, sans renvoyer tout le lot.

Cet article est l'orientation que nous voudrions pour tout responsable des opérations d'une agence qui regarde Seeki pour la première fois. Il parcourt l'import de bout en bout, de „on a des milliers d'annonces dans le CRM" à „elles sont en ligne sur le portail dans toutes les langues que nous servons", et décrit ce à quoi s'attendre à chaque étape.

Onboarding en 5 étapes

1. Générer une clé API. Connectez-vous au tableau de bord de l'agence et créez une clé dans la rubrique clés API. La clé est rattachée à votre agence.
2. Formater le payload. Mappez l'export de votre CRM vers un format de flux pris en charge. Nous acceptons Seeki-JSON (notre schéma canonique), OpenImmo (la norme européenne OASIS très répandue dans les CRMs DACH) et Idealista XML-ML (courant en Espagne et au Portugal).
3. Envoyer le lot. Postez le fichier sur l'API d'ingestion. Les très gros catalogues sont envoyés par blocs.
4. Suivre le tableau de bord des imports. Chaque annonce a sa propre ligne avec un statut en temps réel, le motif d'éventuelle erreur et un bouton de relance.
5. Les annonces sont publiées. Une fois traitée, l'annonce est active dans toutes les langues prises en charge et trouvable depuis les pages pays et la recherche IA.

L'essentiel du travail est à l'étape 2. Les étapes 3 à 5 tournent côté Seeki.

Ce qui se passe une fois l'annonce arrivée

Une annonce n'apparaît pas sur le portail à la seconde où votre POST renvoie 200. Chaque élément est validé de manière asynchrone, enrichi de données dérivées, scoré et publié. La plupart des annonces se terminent en quelques secondes. Si une annonce a un problème corrigible (un champ obligatoire manquant, une URL de photo qui ne se charge pas, une adresse qu'on ne peut pas placer sur la carte), elle est marquée comme échouée dans le tableau de bord avec le motif précis, et le reste du lot continue.

Vous n'avez pas besoin de savoir ce qui tourne sous le capot. Ce qu'il faut savoir, c'est que le tableau de bord vous dit exactement où en est chaque annonce, et qu'il n'est pas nécessaire de renvoyer tout le flux pour corriger un enregistrement.

Saisie manuelle, import web et ingestion API

Trois façons de publier sur Seeki, conçues pour des échelles très différentes.

Le choix est généralement pragmatique : si votre CRM exporte déjà en OpenImmo ou si vous avez un développeur capable de produire du Seeki-JSON, la voie API est la plus économique. Si vous tenez une boutique avec quelques dizaines d'annonces premium, la saisie manuelle suffit.

Ce que montre le tableau de bord des imports

C'est dans le tableau de bord que l'opérationnel d'agence passe le plus de temps après le premier lot. En haut, le récapitulatif de chaque import (total, réussis, en cours, échoués), et le tableau dessous dit exactement ce qui se passe pour chaque enregistrement. Vous filtrez les échoués, lisez la colonne motif, corrigez les données dans le CRM et appuyez sur relancer pour les lignes concernées. Pas besoin de renvoyer tout le flux pour quelques enregistrements fautifs.

À la publication, la ligne renvoie directement à la page publique pour vérifier le rendu dans la langue cible.

Gérez vos imports ici dès qu'une clé est créée.

Abonnement et accès

L'ingestion par API est une fonctionnalité payante pour les agences. L'onboarding inclut une étape d'abonnement gérée par Stripe : vous choisissez un palier, saisissez les informations de paiement ou de facturation, et la clé API devient active. La facturation est mensuelle, avec option de paiement annuel anticipé. Si l'abonnement expire, l'ingestion est mise en pause. Les annonces existantes restent publiées, mais les imports nouveaux sont refusés jusqu'à régularisation de la facturation. Le plan en cours, la consommation et les alertes de renouvellement apparaissent dans le tableau de bord depuis l'écran de synthèse.

Il n'y a pas de frais par annonce en plus de l'abonnement. Le débit dépend du palier. Si vous avez vraiment besoin d'un débit concurrent très élevé, contactez-nous avant souscription pour dimensionner le bon plan.

Questions fréquentes

Quel format de payload est pris en charge ?

Trois formats. Seeki-JSON est notre schéma canonique, un schéma JSON plat et bien documenté qui couvre tous les champs d'annonce et les URL de photos. OpenImmo (la norme européenne OASIS très répandue dans les CRMs DACH) est accepté en XML ou en archive zip contenant le XML et les fichiers photos. Idealista XML-ML est accepté pour les agences espagnoles et portugaises dont le CRM parle déjà ce dialecte. La section clés API du tableau de bord renvoie à la référence complète du schéma et à un playground interactif.

Comment sont gérés les doublons ?

Les annonces sont identifiées par votre identifiant d'agence et l'identifiant externe de l'annonce, celui que votre CRM utilise déjà. Si vous renvoyez une annonce avec le même identifiant externe, Seeki la traite comme une mise à jour et non comme une nouvelle annonce. Les rafraîchissements de routine du catalogue (quotidiens, horaires ou à chaque changement émis par le CRM) fonctionnent ainsi sans logique de déduplication de votre côté.

Puis-je mettre à jour des annonces en masse ?

Oui. Le endpoint d'ingestion est le même pour la création et la mise à jour. Renvoyer une annonce avec des champs modifiés rafraîchit l'enregistrement publié. Si vous voulez mettre à jour seulement un sous-ensemble, n'envoyez que ces annonces. Seeki ne touche pas aux annonces absentes du lot. Pour retirer une annonce, marquez-la comme inactive dans votre CRM et émettez-la avec le statut vendu ou retiré. Elle sera archivée de la recherche.

Et les agences hors UE avec un inventaire européen ?

L'API ne vérifie pas où se trouve le siège de votre agence. Elle vérifie si le pays de l'annonce fait partie des marchés européens couverts par Seeki. Une agence basée à Londres ou à New York qui détient un inventaire espagnol ou tchèque utilise le même endpoint d'ingestion. La structure fiscale et contractuelle de votre côté reste sous votre responsabilité. Le contrat avec Seeki porte sur le service de diffusion.

À quelle vitesse les nouvelles annonces apparaissent-elles ?

Une annonce se termine généralement en quelques secondes. Le temps total entre votre POST et la recherche publique dépend de la taille du lot et de la charge actuelle, mais les petits lots se publient habituellement en moins d'une minute par annonce, de bout en bout. Les traductions vers d'autres langues sont produites à la première consultation. L'annonce est donc immédiatement recherchable dans sa langue source et apparaît traduite la première fois que quelqu'un l'ouvre dans une autre localisation.

Et si une annonce échoue à la validation ?

Elle est marquée comme échouée dans le tableau de bord avec le motif précis : champ obligatoire manquant, URL de photo inaccessible, prix sous le seuil de plausibilité, etc. Le reste du lot continue. Corrigez les données dans le CRM, réexportez et soit renvoyez tout le lot, soit relancez les lignes échouées depuis le tableau de bord. Pas de pénalité pour les relances, et la déduplication sur l'identifiant externe évite les doublons accidentels.

Étapes suivantes

Si votre agence est prête, le chemin est court : générez une clé, envoyez un petit lot de test depuis un export CRM, suivez-le dans le tableau de bord, puis activez le flux complet. Nous maintenons volontairement la plus courte distance possible entre „j'ai un CSV" et „les annonces sont en ligne dans toute l'Europe". C'est à la plateforme d'absorber la complexité opérationnelle, pas à vous de la reprendre.

Quand vous serez prêt, la page d'onboarding vous accompagne sur la création de clé, le paiement et le premier import en un seul flux.