Як агентства імпортують каталог CRM до Seeki
Останнє оновлення: 2026-04-14
Агентства можуть перенести весь каталог CRM до Seeki через API прийому об'єктів. Потрібно згенерувати ключ у панелі агентства, надіслати пакет оголошень у підтримуваному форматі, і кожне оголошення буде опрацьоване та опубліковане на всіх європейських ринках, де працює платформа, без написання власного коду. Панель керування показує стан кожного запису, відображає помилки та дозволяє повторити спроби без повторного завантаження всього пакету.
Це орієнтаційний матеріал, якого часто бракує керівникам агентств на початку роботи зі Seeki. Тут описано, як виглядає імпорт на практиці: від «маємо тисячі об'єктів у CRM» до «всі вони опубліковані на порталі на кожній мові, яку ми підтримуємо», з поясненням кожного кроку.
5 кроків підключення
- Отримайте API-ключ. Увійдіть до панелі агентства та створіть ключ у розділі «API-ключі». Ключ прив'язаний до вашого агентства.
- Підготуйте формат даних. Перетворіть експорт CRM у підтримуваний формат фіду. Ми приймаємо Seeki-JSON (наш основний формат), OpenImmo (загальноєвропейський стандарт OASIS, широко використовуваний DACH-CRM) та Idealista XML-ML (поширений в Іспанії та Португалії).
- Надішліть пакет. Відправте файл до API прийому. Великі каталоги передаються частинами.
- Стежте за панеллю імпорту. Кожне оголошення має власний рядок із поточним статусом, причиною помилки та кнопкою повторної спроби.
- Оголошення публікуються. Після завершення обробки оголошення стає доступним на всіх підтримуваних мовах і з'являється в пошуку на сторінках країн та в рядку пошуку зі штучним інтелектом.
Більшість роботи на кроці 2. Кроки 3–5 виконуються на боці Seeki.
Що відбувається після надходження оголошення
Оголошення не з'являється на порталі одразу після отримання відповіді 200 на ваш запит. Кожен запис валідується, збагачується похідними даними, оцінюється та публікується асинхронно. Більшість оголошень обробляється за секунди. Якщо в оголошення є виправна проблема (відсутнє обов'язкове поле, фото за URL не завантажується, адресу не вдалося розмістити на карті), воно позначається як помилкове з конкретною причиною, а решта пакету продовжує обробку.
Знати, що відбувається «під капотом», не потрібно. Важливо одне: панель керування точно показує, де знаходиться кожне оголошення, а виправлення одного запису не вимагає повторного завантаження всього фіду.
Ручне введення, веб-імпорт та API-прийом
Три способи публікації на Seeki, підходящі для зовсім різних масштабів.
| Підхід | Зусилля для налаштування | Час на одне оголошення | Найкраще для | Масштаб |
|---|---|---|---|---|
| Ручне введення | Не потрібно, просто авторизуйтесь і почніть | 10–20 хвилин | Кілька преміальних об'єктів, агентства, що тестують платформу | Десятки |
| Веб-імпорт (вставка / завантаження) | Мінімальне, одноразове налаштування | Секунди на оголошення | Агентства середнього розміру без штатного розробника | Сотні або кілька тисяч |
| API-прийом | Кілька годин інтеграційної роботи | Долі секунди на оголошення | Агентства з CRM, частими оновленнями, інвентарем у кількох країнах | Десятки тисяч |
Вибір зазвичай прагматичний: якщо ваш CRM вже експортує в OpenImmo або є розробник, який може сформувати Seeki-JSON, шлях через API є найдешевшим варіантом. Для бутика з кількома десятками преміальних об'єктів ручне введення цілком підходить.
Що показує панель імпорту
Панель імпорту є місцем, де оператор агентства проводить більшість часу після першої відправки пакету. Кожен імпорт відображається підсумком угорі (загальна кількість записів, успішних, в обробці, з помилками), а таблиця нижче показує, що відбувається з кожним записом. Відфільтруйте помилкові, перегляньте стовпець причини, виправте вихідні дані та натисніть «Повторити» для потрібних рядків. Повторно завантажувати весь фід заради кількох поганих записів не потрібно.
Коли оголошення публікується, рядок містить пряме посилання на публічну сторінку, де можна перевірити, як вона виглядає у вибраній мові.
Керуйте імпортами тут після отримання ключа.
Підписка та доступ
API-прийом є платною функцією для агентств. Підключення передбачає крок оформлення підписки через Stripe: ви обираєте тарифний план, вводите дані картки або рахунку, і ваш API-ключ стає активним. Підписки оплачуються щомісяця з можливістю річної передоплати. Якщо підписка завершується, прийом призупиняється. Вже опубліковані оголошення залишаються на порталі, але нові імпорти відхиляються до поновлення оплати. Поточний план, обсяг використання та попередження про продовження відображаються на головному екрані панелі агентства.
Плата за окреме оголошення поверх підписки не стягується. Пропускна спроможність залежить від тарифного плану. Якщо вам потрібна дуже висока паралельна пропускна спроможність, зв'яжіться з нами перед оформленням підписки, щоб підібрати відповідний план.
Поширені запитання
Які формати запитів підтримуються?
Три формати. Seeki-JSON — це наш основний формат: плаский, добре задокументований JSON, що охоплює всі поля оголошення та URL фотографій. OpenImmo (загальноєвропейський стандарт OASIS, широко використовуваний DACH-CRM) приймається як XML або як ZIP-архів з XML та фотографіями. Idealista XML-ML приймається для іспанських і португальських агентств, чий CRM вже підтримує цей формат. Розділ API-ключів у панелі керування містить посилання на повний опис схеми та інтерактивний майданчик для тестування.
Як обробляються дублікати?
Оголошення ідентифікуються за ID вашого агентства та зовнішнім ID оголошення — тим ідентифікатором, який вже використовує ваш CRM. Якщо ви повторно надсилаєте оголошення з тим самим зовнішнім ID, Seeki сприймає це як оновлення, а не новий запис. Це означає, що регулярне оновлення каталогу (щоденне, щогодинне або при кожній зміні в CRM) працює без будь-якої логіки дедублікації на вашому боці.
Чи можна оновлювати оголошення пакетом?
Так. Кінцева точка прийому однакова для створення і оновлення. Повторне надсилання оголошення зі зміненими полями оновлює опублікований запис. Якщо потрібно оновити лише частину, надсилайте тільки ці оголошення — Seeki не торкнеться відсутніх у пакеті записів. Щоб видалити оголошення, позначте його неактивним у CRM та передайте зі статусом «продано» або «знято з продажу». Його буде архівовано з пошуку.
Що з агентствами поза ЄС, які мають об'єкти в Європі?
API не перевіряє, де зареєстроване ваше агентство. Він перевіряє, чи знаходиться об'єкт у країні, яку обслуговує Seeki. Агентство з Лондона або Нью-Йорка з іспанськими чи чеськими об'єктами може використовувати ту саму кінцеву точку прийому. Податкова та договірна відповідальність на вашому боці — на вашій відповідальності. Контракт Seeki стосується послуги розміщення оголошень.
Як швидко з'являються нові оголошення?
Оголошення зазвичай обробляється за секунди. Загальний час від вашого запиту до публікації в пошуку залежить від розміру пакету та поточного навантаження, але невеликі пакети зазвичай публікуються наскрізь менш ніж за хвилину на оголошення. Переклади на інші мови генеруються при першому перегляді: одразу після публікації оголошення шукається на мові джерела, а при першому відкритті в іншій локалі з'являється в перекладеному вигляді.
Що робити, якщо оголошення не пройшло валідацію?
Воно позначається як помилкове з конкретною причиною: відсутнє обов'язкове поле, URL фото недоступний, ціна нижче порогу достовірності тощо. Решта пакету продовжує обробку. Виправте дані у CRM, зробіть повторний експорт і або повторно надішліть весь пакет, або повторіть спробу для помилкових рядків з панелі керування. Штрафу за повторні спроби немає, а дедублікація за зовнішнім ID запобігає випадковим дублікатам.
Наступні кроки
Якщо ваше агентство готове, шлях короткий: отримайте ключ, надішліть невеликий тестовий пакет з експорту CRM, спостерігайте за його появою в панелі керування, а потім увімкніть повний фід. Ми навмисно скорочуємо відстань між «маємо CSV» та «оголошення є в усій Європі» до мінімуму. Завдання платформи — поглинути операційну складність, а не передавати її вам.
Коли будете готові, сторінка підключення проведе вас через налаштування, оплату та перший імпорт в одному потоці.