Utilizatori
Prezentare utilizatori
Sincronizarea profilurilor agenților între CRM și Rentix
Prin API sincronizezi profilurile agenților din CRM-ul tău, pentru ca clienții să vadă informații de contact actualizate.
Anunțurile pot fi publicate fără a fi legate de un agent — în acest caz se afișează informațiile agenției. E convenabil în perioada de tranziție, până când nu toți agenții sunt înregistrați.
Cum funcționează
CRM-ul tău Rentix
┌─────────────┐ ┌─────────────┐
│ Agent #42 │ PUT /users │ Utilizator │
│ externalId: ├────────────────────────►│ id: 15 │
│ "agent-42" │ (nume, contacte, │ externalId: │
│ │ descriere) │ "agent-42" │
└─────────────┘ └─────────────┘
La crearea anunțului indică userId — și acesta va fi legat de acel agent.
Limitare
Crearea utilizatorilor noi prin API nu este disponibilă. Agenții trebuie invitați prin interfața web pentru a-și verifica numărul de telefon.
Cum să inviți un agent
- Autentifică-te pe rentix.md
- Deschide Meniu → Numele agenției → Invitații
- Introdu email-ul agentului și trimite invitația
- După înregistrare, agentul va apărea în listă și poate fi sincronizat prin API
Ce poți face prin API
| Sarcină | Metodă | Endpoint |
|---|---|---|
| Actualizează profilul | PUT | /users |
| Actualizează mai mulți agenți | POST | /users/bulk |
| Obține lista agenților | GET | /users |
| Găsește după ID | GET | /users/:id |
| Găsește după external ID | GET | /users/external/:externalId |
| Leagă external ID | POST | /users/:id/link |
| Dezleagă external ID | DELETE | /users/:id/link |
Structura profilului
{
"id": 15,
"externalId": "agent-42",
"name": "Ion Popescu",
"phone": "+373 22 123 456",
"description": "Agent experimentat în imobiliare rezidențiale...",
"avatar": {
"id": 123,
"variants": [
{ "url": "https://storage.../128.webp", "variantSize": "128" }
]
},
"instagram": "https://instagram.com/ion.popescu",
"youtube": null,
"tiktok": null,
"settings": {
"posting_type": "agent",
"contact_phone": true,
"contact_whatsapp": true,
"contact_viber": false,
"contact_telegram": true
}
}
| Câmp | Descriere |
|---|---|
id | ID intern pe Rentix |
externalId | ID-ul agentului din CRM-ul tău |
name | Numele afișat pe anunțuri |
phone | Telefonul din înregistrare (read-only) |
description | Descrierea profilului agentului |
avatar | Fotografia de profil cu variante optimizate |
instagram, youtube, tiktok | Linkuri rețele sociale |
settings | Setări afișare contacte |
Scenariu tipic
1. Obține lista agenților → GET /users
→ găsește agenții fără externalId
2. Leagă external ID → POST /users/:id/link
→ conectează cu înregistrarea din CRM
3. Sincronizează profilul → PUT /users
→ transmite nume, descriere, contacte
4. Leagă la anunțuri → PUT /listings
→ transmite userId la creare
Pașii următori
- Actualizează profilul agentului — sincronizare date
- Obține lista agenților — căutare și legare external ID