Пользователи
Обзор пользователей
Синхронизация профилей агентов между CRM и Rentix
Через API вы синхронизируете профили агентов из вашей CRM, чтобы клиенты видели актуальную контактную информацию.
Объявления можно публиковать без привязки к агенту — в этом случае отображается информация агентства. Это удобно на этапе перехода, пока не все агенты зарегистрированы.
Как это работает
Ваша CRM Rentix
┌─────────────┐ ┌─────────────┐
│ Агент #42 │ PUT /users │ Пользователь│
│ externalId: ├────────────────────────►│ id: 15 │
│ "agent-42" │ (имя, контакты, │ externalId: │
│ │ описание) │ "agent-42" │
└─────────────┘ └─────────────┘
При создании объявления укажите userId — и оно будет привязано к этому агенту.
Что можно делать через API
| Задача | Метод | Endpoint |
|---|---|---|
| Создать или обновить профиль | PUT | /users |
| Массовые операции | POST | /users/bulk |
| Получить список агентов | GET | /users |
| Найти по ID | GET | /users/:id |
| Найти по external ID | GET | /users/external/:externalId |
| Привязать external ID | POST | /users/:id/link |
| Отвязать external ID | DELETE | /users/:id/link |
Структура профиля
{
"id": 15,
"externalId": "agent-42",
"name": "Иван Петров",
"phone": "+373 22 123 456",
"description": "Опытный агент по жилой недвижимости...",
"avatar": {
"id": 123,
"variants": [
{ "url": "https://storage.../128.webp", "variantSize": "128" }
]
},
"instagram": "https://instagram.com/ivan.petrov",
"youtube": null,
"tiktok": null,
"settings": {
"posting_type": "agent",
"contact_phone": true,
"contact_whatsapp": true,
"contact_viber": false,
"contact_telegram": true
}
}
| Поле | Описание |
|---|---|
id | Внутренний ID на Rentix |
externalId | Ваш ID агента из CRM |
name | Имя, отображаемое на объявлениях |
phone | Телефон из регистрации (read-only) |
description | Описание профиля агента |
avatar | Фото профиля с оптимизированными вариантами |
instagram, youtube, tiktok | Ссылки на соцсети |
settings | Настройки отображения контактов |
Типичный сценарий
1. Создать или синхронизировать → PUT /users
→ передать externalId, имя, телефон
2. Обновить профили → PUT /users
→ передать описание, контакты, аватар
3. Привязать к объявлениям → PUT /listings
→ передать userId или externalUserId при создании
Следующие шаги
- Создать или обновить агента — создание и синхронизация данных
- Получить список агентов — поиск и привязка external ID