Пользователи
Обзор пользователей
Синхронизация профилей агентов между CRM и Rentix
Через API вы синхронизируете профили агентов из вашей CRM, чтобы клиенты видели актуальную контактную информацию.
Объявления можно публиковать без привязки к агенту — в этом случае отображается информация агентства. Это удобно на этапе перехода, пока не все агенты зарегистрированы.
Как это работает
Ваша CRM Rentix
┌─────────────┐ ┌─────────────┐
│ Агент #42 │ PUT /users │ Пользователь│
│ externalId: ├────────────────────────►│ id: 15 │
│ "agent-42" │ (имя, контакты, │ externalId: │
│ │ описание) │ "agent-42" │
└─────────────┘ └─────────────┘
При создании объявления укажите userId — и оно будет привязано к этому агенту.
Ограничение
Создание новых пользователей через API недоступно. Агентов нужно приглашать через веб-интерфейс для верификации их номера телефона.
Как пригласить агента
- Войдите на rentix.md
- Откройте Меню → Название агентства → Приглашения
- Введите email агента и отправьте приглашение
- После регистрации агент появится в списке и его можно синхронизировать через API
Что можно делать через 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. Получить список агентов → GET /users
→ найти агентов без externalId
2. Привязать external ID → POST /users/:id/link
→ связать с записью в CRM
3. Синхронизировать профиль → PUT /users
→ передать имя, описание, контакты
4. Привязать к объявлениям → PUT /listings
→ передать userId при создании
Следующие шаги
- Обновить профиль агента — синхронизация данных
- Получить список агентов — поиск и привязка external ID