Telegraft

Интеграция

Property Finder как источник данных, а не конкурент

Интеграция с Property Finder читает ваши собственные объявления с портала в Telegram-бота, чтобы подбирать их зарегистрированным покупателям и присылать уведомления. Доступ идёт через ваш фид объявлений или вашу CRM, а не через публичный API, и портал остаётся источником истины о том, что опубликовано.

Property Finder — интеграция: доступ, лимиты и доступность

Модель авторизации
Ключ API
API на чтение
Общедоступного API для поиска по чужим объявлениям нет
Доступность в Заливе
ОАЭ — основной рынок; сопоставимого покрытия порталом в остальных странах Залива не предполагается
Поток данных
5 узлов, через воркер

As of 2025-10-01, Telegram Bot API 13.4

Зачем нужна эта интеграция

Дубайское агентство, размещающееся на Property Finder, уже ведёт там свой пул объектов — обычно через систему управления объявлениями, которая раздаёт их сразу на несколько порталов. Просить агентов заново вбивать те же объекты ещё и в бота — самый быстрый способ гарантировать, что через неделю данные в боте будут неверными: коммерческое давление на точность живёт на портале, а не в боте.

Поэтому правильная форма такая: бот читает, а не владеет. Источником становится та система, которая уже публикует на Property Finder, бот забирает данные из неё, а подбор идёт по покупателям, оставившим свои критерии в Telegram. Вклад бота — это сторона покупателя: помнить, что человек ищет, и за секунды сообщить ему, когда появилось подходящее. А не ещё одно место, куда надо вбивать объявление.

Ограничение, которое стоит назвать прямо: Property Finder не даёт общедоступного API для чтения чужих объявлений, а парсинг портала нарушает его условия и вдобавок служит плохим фундаментом для коммерческого продукта. Доступен ваш собственный пул объектов — как правило, через тот самый фид, который уже формирует ваша система размещения. Для подбора покупателям этого достаточно, а для постройки конкурирующего поиска недостаточно, и это правильный итог.

Как на самом деле движутся данные

Системаразмещенияфид или APIВоркер ботасравнение и обновлениеОбъекты в D1критерии покупателяПодборуведомлениеПокупательв Telegram
Фид сравнивается с предыдущим снимком, а не проигрывается заново, поэтому покупатель получает уведомление о действительно новом объекте, а не при каждом скачивании фида.

На практике интеграция авторизуется не на портале, а в той системе, которая держит ваш пул объектов, — в системе размещения, CRM агентства или на эндпоинте фида. Учётные данные лежат как секреты воркера. Там, где доступен только выгружаемый по расписанию файл фида, он забирается по расписанию и сравнивается с предыдущим снимком, а не опрашивается агрессивно.

Модель доступа: API-ключ

Их лимиты и что они означают для вас

Property Finder не публикует общего API для чтения и поиска чужих объявлений.

Интеграция читает ваш собственный пул объектов из ваших же систем. Тот, кто предлагает программно искать по всему порталу, описывает нарушение условий.

Правила рекламы в Дубае требуют указывать номер разрешения RERA в объявлении о недвижимости.

Разрешение — обязательное поле для любого объекта, о котором бот шлёт уведомление, и объект без него не отправляется. Именно проверка на уровне модели данных не даёт занятому агенту создать проблему с соблюдением требований.

Файл фида — это снимок состояния, а не поток изменений.

Новое, изменившееся и снятое получается только сравнением с предыдущим снимком. Если считать каждое скачивание набором новых объектов, каждый покупатель получит уведомление обо всём пуле — по разу на скачивание.

Статус объекта — как правило, самое запаздывающее поле в любом фиде.

Объект, по которому уже принято предложение, может часами числиться доступным. В уведомлении указано, когда данные обновлялись, а не подразумевается, что они актуальны прямо сейчас, — иначе агенты будут принимать звонки о проданном.

Как это ломается и что происходит потом

Каждый покупатель получил уведомление обо всём пуле объектов.

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

Покупателю пришло уведомление об объекте, по которому вчера приняли предложение.

Запаздывание статуса в фиде. В уведомлении указано время обновления данных, а перед уведомлением о дорогом объекте статус перепроверяется, а не берётся на веру из прошлой синхронизации.

Объект без номера разрешения дошёл до уведомления.

Это должна блокировать модель данных, а не пункт в чек-листе. Поле обязательное, и объект без него удерживается, а не отправляется.

Эндпоинт фида сменился или перестал отвечать без предупреждения.

Срабатывает оповещение о залежавшихся данных, когда фид не обновлялся дольше обычного интервала. Молчание фида неотличимо от рынка, на котором просто нет новых объектов, поэтому его надо отслеживать явно.

Доступность в ОАЭ и остальных странах Залива

Объединённые Арабские Эмираты

Основной рынок Property Finder и тот случай, под который написана эта интеграция. Работа с разрешениями RERA специфична для Дубая и заложена в модель данных.

Саудовская Аравия, Катар и Бахрейн

Присутствие портала различается от рынка к рынку, и рекламное регулирование тоже. Каждый рынок подтверждается отдельно, а не выводится из эмиратской схемы.

Поиск по чужим объявлениям

Недоступен, и строить на этом ничего не стоит. Интеграция читает ваш собственный пул объектов — именно это и нужно для подбора покупателям.

Агентства без системы размещения

Тогда агенты заводят объекты прямо в боте. Так работать можно, но бот становится вторым источником истины, и на это стоит пойти осознанно.

Когда эту интеграцию делать не нужно

  • Вам нужен программный поиск по всему порталу. Он недоступен, нарушает условия и служит плохим фундаментом для коммерческого продукта.
  • Ваш пул объектов обновляется медленно. Подбор срабатывает редко, и между уведомлениями покупатели забывают, что бот вообще существует.
  • Агенты не будут поддерживать актуальность статуса. Уведомления о проданных объектах разрушают доверие быстрее, чем уведомления его набирают.
  • У вас нет системы размещения и заводить её вы не собираетесь. Тогда бот становится вторым источником истины — это решение, а не значение по умолчанию.

На чём это работает

КомпонентВерсияЗачем
Cloudflare WorkerscurrentСкачивание фида по расписанию, сравнение снимков и запуск подбора.
Cloudflare D1currentОбъекты, снимки, критерии покупателей и подавление повторных уведомлений.
Cloudflare R2currentСнимки фида хранятся для сравнения и для разбора спорных случаев.
Zod4.4Валидация записей фида, полнота которых зависит от источника.

Вопросы, которые возникают при оценке

Может ли бот искать по всем объявлениям Property Finder?

Нет. Общедоступного API на чтение чужих объявлений не существует, а парсинг портала нарушает его условия и плохо годится под коммерческий продукт. Интеграция читает ваш собственный пул объектов — именно он и нужен для подбора покупателям.

Почему номер разрешения настолько важен?

Правила рекламы в Дубае требуют его в объявлении о недвижимости, а уведомление — это объявление. Поле обязательное на уровне модели данных, поэтому объект без него удерживается, а не отправляется; так торопящийся агент не создаёт проблему с соблюдением требований за полминуты.

Зачем сравнивать фид с предыдущим снимком?

Потому что файл фида — это снимок, а не поток изменений. Если считать каждое скачивание набором новых объектов, все зарегистрированные покупатели получат уведомление обо всём пуле, по разу на скачивание, — самый быстрый способ добиться того, чтобы бота заглушили.

Насколько актуален статус объекта?

Статус обычно запаздывает сильнее всех остальных полей фида, поэтому объект с уже принятым предложением часами читается как доступный. В уведомлении указано, когда обновлялись данные, а перед уведомлением о дорогом объекте статус перепроверяется.

Что будет, если наш фид перестанет обновляться?

Сработает оповещение о залежавшихся данных, когда фид не менялся дольше обычного интервала. Молчание в фиде выглядит ровно как тихий рынок, поэтому отслеживать его надо явно, а не выводить из того, что уведомлений нет.

Заменит ли это наши объявления на портале?

Нет, и не должно пытаться. Порталы — место, где покупатели вас находят. Бот — место, где покупатели, с которыми вы уже знакомы, первыми узнают о новых объектах. Это дополняющая работа, а не конкурирующая.

Что почитать дальше