SmartCRM

Secțiune: CRM
URL: /admin/smartcrm
Titlu pagină: SmartCRM

Prezentare generală

Modulul SmartCRM este un strat de integrare bidirecțională care sincronizează datele CRMConnect cu o platformă Smart CRM externă prin intermediul unui REST API. Împinge entitățile de bază — clienți, leads, proiecte, tichete și facturi — către sistemul remote la cerere sau automat printr-un program cron configurabil și afișează un dashboard de erori în timp real astfel încât personalul să poată monitoriza sănătatea sincronizării fără a părăsi aplicația.

Modulul utilizează un serviciu de sincronizare dedicat (SmartcrmSyncService), un logger structurat (SmartcrmLogger) și un client API direct (ApiSmartcrm). Toată activitatea de sincronizare este scrisă într-un tabel tbl_smartcrm_logs, oferind administratorilor o pistă de audit continuă și statistici acoperind ultimele șapte zile.

Valoare pentru business

Companiile care rulează Smart CRM alături de CRMConnect au nevoie ca datele să rămână consistente între ambele sisteme. Fără acest modul, înregistrările ar trebui duplicate manual, ducând la inconsistențe și timp pierdut. SmartCRM automatizează fluxul de date și oferă vizibilitate imediată asupra oricăror eșecuri de sincronizare.

Cine îl utilizează: Administratorii CRM care configurează integrarea; liderii de echipă care monitorizează statisticile de sincronizare; personalul de suport care investighează discrepanțele de date între cele două sisteme.
Beneficiu principal: Sincronizare automată, programată a tuturor entităților CRM cheie cu monitorizare integrată a erorilor și logică de reîncercare configurabilă.

Cazuri de utilizare tipice:

Configurați endpoint-ul API Smart CRM și token-ul de autentificare, apoi rulați un test de conectivitate înainte de a activa sincronizarea automată.
Programați sincronizarea automată la fiecare 1, 2, 4, 12 sau 24 de ore prin opțiunea cron integrată.
Declanșați manual o sincronizare unică pentru un tip de entitate specific (leads, clienți, proiecte, tichete sau facturi) după un import de date în masă.
Revizuiți dashboard-ul de erori pentru a identifica ce înregistrări nu s-au sincronizat și de ce, apoi reîncercați după rezolvarea problemei de bază.
Ajustați parametrii de performanță cum ar fi dimensiunea lotului, timeout-ul API și numărul maxim de reîncercări pentru a se potrivi capacității API-ului remote.

Accesarea modulului

/admin/smartcrm

Concepte cheie

Concept	Descriere
URL API	Endpoint-ul de bază al REST API-ului Smart CRM remote.
Token de autentificare	Token Bearer utilizat pentru autentificarea fiecărui apel API de ieșire.
Sincronizare cron	Sincronizare automată opțională declanșată de job-ul cron al CRMConnect la intervalul configurat.
Interval de sincronizare	Cât de des rulează sincronizarea automată: 1, 2, 4, 12 sau 24 de ore.
Dimensiune lot	Numărul de înregistrări trimise per cerere API (implicit 50). Controlează throughput-ul vs. sarcina.
Timeout API	Secundele maxime de așteptare a unui răspuns de la API-ul remote (implicit 30 s).
Reîncercări maxime	De câte ori se reîncearcă un apel API eșuat înainte ca înregistrarea să fie jurnalizată ca eroare.
Nivel jurnal	Severitatea minimă scrisă în jurnalul de sincronizare: DEBUG, INFO, WARNING sau ERROR.
Statistici sincronizare	Numărătoare agregate de sincronizări reușite și eșuate în ultimele 7 zile, afișate pe dashboard.
Erori recente	Cele mai recente 10 intrări de jurnal la nivel ERROR, afișate pe dashboard pentru triaj rapid.
Test de conexiune	Ping API automat efectuat ori de câte ori sunt salvate setările pentru validarea imediată a credențialelor.

Acțiuni frecvente

Configurați integrarea — Navigați la /admin/smartcrm, introduceți URL-ul API și token-ul de autentificare, ajustați dimensiunea lotului, timeout-ul, numărul de reîncercări și nivelul de jurnal, apoi salvați. Un test de conexiune rulează automat și raportează succesul sau un avertisment.
Activați sincronizarea automată — Setați „Sincronizare cron" pe Da și alegeți un interval de sincronizare. Următoarea execuție cron programată va începe să împingă date către Smart CRM.
Sincronizați manual leads-urile — Faceți clic pe acțiunea „Sincronizează Leads"; modulul apelează sync_leads_with_smartcrm și returnează un rezultat JSON cu numărători și orice erori.
Sincronizați manual clienții — Faceți clic pe acțiunea „Sincronizează Clienți" pentru a împinge toate înregistrările de clienți către sistemul remote.
Sincronizați manual proiectele — Faceți clic pe acțiunea „Sincronizează Proiecte" pentru a sincroniza proiectele active.
Sincronizați manual tichetele — Faceți clic pe acțiunea „Sincronizează Tichete" pentru a împinge datele tichetelor de suport.
Sincronizați manual facturile — Faceți clic pe acțiunea „Sincronizează Facturi" pentru a împinge înregistrările financiare.
Monitorizați dashboard-ul — Pagina principală SmartCRM afișează statisticile de sincronizare pe 7 zile și cele mai recente 10 erori pentru ca administratorii să evalueze sănătatea integrării dintr-o privire.
Revizuiți jurnalele detaliate — Navigați la vizualizarea Jurnale pentru a filtra după nivelul de jurnal (DEBUG / INFO / WARNING / ERROR) și a inspecta detaliile complete ale cererii/răspunsului pentru orice operațiune de sincronizare.
Vizualizați prezentarea generală a erorilor — Pagina Prezentare Generală Erori agregează tiparele de eșec recurente pentru a ajuta la prioritizarea remedierilor.

Warning

Activarea sincronizării cron va împinge TOATE înregistrările corespunzătoare la intervalul configurat. Rulați mai întâi o sincronizare manuală pentru fiecare tip de entitate (leads, clienți, proiecte, tichete, facturi) și verificați rezultatele înainte de activarea sincronizării automate pentru a evita erorile de propagare în masă a datelor.

Tip

Setați nivelul de jurnal la INFO sau DEBUG în timpul configurării inițiale pentru a verifica mapările câmpurilor și a confirma că înregistrările se sincronizează corect. Treceți la WARNING în producție pentru a menține tabelul de jurnale gestionabil, captând în continuare erorile acționabile.

Sursă: crm-connect-main/app/modules/smartcrm