Як агентства імпортують каталог CRM до Seeki.eu

Востаннє переглянуто: 2026-08-11

Ваш CRM уже тримає кожен об'єкт, яким керує ваше агентство, разом із фотографіями, цінами й описами. Розміщення цього каталогу на іншому порталі зазвичай означає, що операційний працівник передруковує його оголошення за оголошенням, або що розробник вгадує специфікацію фіду, якої ніхто не записав. Ось як насправді виглядає шлях на Seeki.eu, від експорту з CRM до оголошень, які покупці по всій Європі можуть знайти.

Що агентству насправді треба зробити для підключення?

П'ять кроків, і лише один із них потребує справжньої роботи.

1. Спершу оформіть підписку. API-ключ видається під активну підписку: панель не створить ключ, доки її немає, а API імпорту відхиляє ключ, підписка якого відтоді завершилася. План один, тож нічого не треба ані розраховувати, ані узгоджувати. Що він включає, викладено на сторінці для агентств.
2. Згенеруйте API-ключ. Панель показує повний ключ рівно один раз під час створення й зберігає лише його хеш, тож покладіть його у своє сховище секретів, перш ніж закриєте діалог. Ключі можна пізніше змінити або відкликати на тому самому екрані.
3. Перетворіть експорт CRM у підтримуваний формат. Приймаються три: JSON-схема Seeki.eu, задокументована поле за полем; OpenImmo, як звичайний XML або як ZIP-архів, що поєднує XML із файлами фотографій; та Idealista XML-ML. Якщо ваша система вже видає один із них, цей крок здебільшого зводиться до налаштування.
4. Надішліть каталог до API імпорту за адресою ingest.seeki.eu. Великі каталоги йдуть серією пакетів, а не одним величезним файлом.
5. Стежте за екраном імпорту. Кожне оголошення отримує власний рядок із поточним станом, причиною, якщо воно не пройшло, та повторною спробою, для якої не треба надсилати весь фід заново.

Крок 3 це те, де лежить зусилля. Кроки 4 і 5 виконуються на нашому боці.

Що відбувається з оголошенням після надходження?

Оголошення не з'являється на порталі в ту мить, коли ваш запит завершується. Кожен запис опрацьовується окремо й асинхронно: він валідується, його адреса зводиться до точки на карті, розраховуються похідні поля, він записується в каталог і оцінюється. Проблема на будь-якому з цих етапів позначає лише цей один запис як помилковий із конкретною причиною й лишає решту пакету в роботі.

На практиці помилки збираються у двох місцях. Перше це відсутнє обов'язкове поле, яке схема ловить іще до всього іншого. Друге це розташування: адреса, яку не вдається звести до точки, або координати, що падають за межі власної країни оголошення. Обидві проблеми стосуються вихідних даних, обидві називають себе в панелі керування, і обидві можна виправити в CRM і повторити без повторного надсилання фіду.

Кожне оголошення, що приземляється, також отримує оцінку оголошення та локаційний бал, два сигнали, за якими покупці можуть фільтрувати й сортувати. Що саме вимірюють ці два числа варте десяти хвилин часу операційного керівника, бо оцінка оголошення напряму реагує на якість вашого експорту: скільки полів ви заповнюєте, скільки фотографій надсилаєте й наскільки змістовний опис, усе це її рухає.

Скільки імпортоване оголошення лишається активним?

Шістдесят днів від останнього успішного імпорту. Щоденне завдання знімає з публікації все, що вийшло за цю межу, а панель попереджає про оголошення, строк яких спливає протягом наступного тижня, ще до того, як це станеться.

Саме це одне правило формує інтеграцію більше, ніж будь-що інше на цій сторінці. Повторне надсилання оголошення оновлює його строк життя, навіть якщо в ньому нічого не змінилося, тож будувати треба схему нічної пересинхронізації активного інвентарю, а не одноразове масове завантаження. Агентство, яке імпортує один раз і більше ніколи, спостерігає, як його каталог тихо витікає за два місяці.

Це також дає другий, м'якший спосіб зняти об'єкт: перестаньте включати його в пересинхронізацію, і він згасне сам.

Ручне введення чи імпорт через API: що підходить вашому агентству?

Два справжні шляхи на платформу, придатні для зовсім різних масштабів.

Підхід	Зусилля для налаштування	Найкраще для	Масштаб
Ручне введення в панелі	Не потрібно. Авторизуйтесь і починайте вводити.	Кілька преміальних об'єктів або агентство, що пробує платформу перед тим, як щось під'єднувати	Десятки
Імпорт фідом або через API	Кілька годин інтеграційної роботи, менше, якщо ваш CRM уже видає OpenImmo чи Idealista XML	Агентство з CRM, частими змінами цін і статусів або інвентарем більш ніж в одній країні	Тисячі, надіслані пакетами

Вибір зазвичай прагматичний. Якщо ваша система вже експортує OpenImmo або є розробник, який може сформувати наш JSON, API є найдешевшим місцем приземлення й єдиним, що переживає нічне оновлення. Бутику з десятком преміальних об'єктів краще ввести їх вручну й витратити зекономлений ранок на фотографію, яка рухає інтерес покупців сильніше, ніж технічна обв'язка.

Що насправді показує панель імпорту?

Головний екран несе показники, за якими оператор проводить день: активні оголошення, імпорти в роботі, імпорти з помилками та оголошення, строк яких спливає протягом тижня. Під ним екран імпорту перелічує кожен запис із зовнішнім ID, який використовує ваш CRM, його станом, кодом помилки та зрозумілим повідомленням, коли щось пішло не так, із фільтром, щоб підняти лише помилкові.

Відкрийте рядок, і ви отримаєте отриманий нами запит поряд із помилкою, чого зазвичай досить, аби відрізнити проблему в даних CRM від проблеми відображення в експорті. Помилкові рядки несуть повторну спробу, що ставить у чергу лише цей один запис. Повторно завантажувати весь фід заради кількох поганих записів не потрібно.

Навіщо розміщувати внутрішній каталог на загальноєвропейському порталі?

Бо ваш покупець може не жити у вашій країні й не шукати вашою мовою. Каталог, що існує лише на національному порталі, дістає людей, які вже шукають там, тією мовою, і на цьому зупиняється. Seeki.eu це один портал для всього континенту: заголовок і опис оголошення читаються мовою, якою переглядає відвідувач, ціна показується у валюті, яку він обирає, і воно стоїть у тому самому наборі результатів, що й житло по інший бік кордону, для кожного, хто порівнює ринки.

Охоплення сягає й за межі сайту. Покупці, які шукають через ШІ-помічника, можуть дістатися каталогу зсередини ChatGPT та Claude, без облікового запису й без жодних налаштувань на вашому боці. Якщо ви зважуєте, де має стояти інвентар агентства, наш огляд основних сайтів нерухомості в Європі розкладає, у чому насправді сильний кожен тип порталу.

Що покриває підписка?

Один план: €99 на місяць або €990 на рік, що виходить на два місяці дешевше. Необмежена кількість оголошень, скасування будь-коли. Плати за окреме оголошення поверх цього немає, немає ані пакетів кредитів для здешевлення, ані тарифу пропускної спроможності, який треба узгоджувати перед стартом.

Один наслідок варто знати до оформлення підписки, а не після. Якщо підписку скасовано або призупинено, опубліковані оголошення цього агентства знімаються разом із нею, а поновлення повертає їх назад. Просто прострочений рахунок цього не робить: поки платіж прострочений, імпорти працюють, а оголошення лишаються активними. Стан оплати, кінець поточного періоду та рахунки живуть на екрані білінгу в панелі керування й обробляються через власний клієнтський портал Stripe.

Поширені запитання

Які формати фіду можна надсилати?

Три. JSON-схема Seeki.eu це наша: плаский задокументований формат, що охоплює поля оголошення та URL фотографій. OpenImmo, XML-стандарт, який експортує більшість німецькомовних систем, приймається або як звичайний XML, або як ZIP-архів, що поєднує XML із файлами фотографій. Idealista XML-ML приймається для іспанських і португальських систем, чий експорт уже ним говорить. Довідник API містить повний перелік полів.

Як обробляються дублікати?

Оголошення ідентифікується за вашим агентством плюс зовнішнім ID, який ваш CRM уже для нього використовує. Повторне надсилання того самого зовнішнього ID оновлює наявний запис замість створення другого й водночас оновлює його 60-денний строк життя. Саме це робить безпечною нічну повну пересинхронізацію: власна логіка дедублікації вам не потрібна, а повторне надсилання незміненого оголошення нічого вам не коштує.

Чи можна оновлювати оголошення пакетом?

Так, і викликати окремо нічого не треба. Створення й оновлення це та сама операція: надішліть оголошення зі зміненими полями заново, і опублікований запис оновиться. Надішліть лише ту частину, що змінилася, і оголошення, відсутні в цьому пакеті, лишаться недоторканими, з одним застереженням, яке варто повторити: оголошення, яке ви перестаєте надсилати, також перестає оновлювати свій 60-денний строк життя.

Як зняти оголошення з публікації?

Двома способами, і жоден із них не є прапорцем статусу у фіді. Призупиніть його на екрані оголошень у панелі агентства, що прибирає його з пошуку й так само легко скасовується, або перестаньте включати його в пересинхронізацію та дайте 60-денному строку життя минути самому. Якщо об'єкт продано і ви хочете, щоб сторінка зникла сьогодні, призупиніть його.

Чи може агентство поза межами ЄС імпортувати європейські об'єкти?

Так. Де зареєстроване ваше агентство, не перевіряється. Значення має те, що об'єкт стоїть в одному з європейських ринків, які ми охоплюємо, і що його адреса зводиться до точки всередині власної країни. Брокер із Лондона чи Нью-Йорка з іспанськими чи чеськими об'єктами користується точно такою самою інтеграцією. Ваша власна податкова та договірна структура лишається вашою відповідальністю, а наш контракт стосується послуги розміщення оголошень.

Як швидко імпортоване оголошення стає активним?

Кожен запис підхоплюється окремо щойно надходить, а не чекає нічної перебудови, тож оголошення зазвичай стає доступним у пошуку невдовзі після прийняття пакету. Його заголовок і опис перекладаються на вимогу для покупців, які переглядають іншою мовою, а це означає, що воно знаходиться мовою джерела від самого початку й читається мовою відвідувача в ту мить, коли він його відкриває.

Що станеться з моїми оголошеннями, якщо я скасую підписку?

Вони знімаються з публікації разом із підпискою й повертаються, якщо ви її поновите. Прострочений платіж трактується інакше: поки рахунок прострочений, імпорти працюють, а опубліковані оголошення лишаються активними. Коли підписка завершується, нічого не видаляється, тож поновлення відновлює каталог, а не змушує вас імпортувати його заново.

Наступні кроки

Якщо ваше агентство готове, шлях короткий: оформіть підписку, згенеруйте ключ, надішліть невеликий тестовий пакет із реального експорту CRM, простежте, як він приземляється в панелі керування, а потім увімкніть нічний фід. Ми навмисно тримаємо відстань між «маємо експорт» та «оголошення є в усій Європі» настільки короткою, наскільки це можливо, і завдання платформи полягає в тому, щоб поглинути операційну складність, а не передати її назад вам.

Сторінка для агентств описує, що включає підписка, а довідник API описує перелік полів, коди помилок та інтерактивну консоль, яку ваш розробник захоче тримати відкритою першого ранку.