SmartCRM

Sezione: CRM URL: /admin/smartcrm Titolo pagina: SmartCRM

Panoramica

Il modulo SmartCRM è uno strato di integrazione bidirezionale che sincronizza i dati CRMconnect con una piattaforma Smart CRM esterna tramite un'API REST. Invia le entità principali — clienti, lead, progetti, ticket e fatture — al sistema remoto su richiesta o automaticamente tramite una pianificazione cron configurabile, e mostra una dashboard di errori in tempo reale in modo che il personale possa monitorare la salute della sincronizzazione senza lasciare l'applicazione.

Il modulo utilizza un servizio di sincronizzazione dedicato (SmartcrmSyncService), un logger strutturato (SmartcrmLogger) e un client API diretto (ApiSmartcrm). Tutta l'attività di sincronizzazione viene scritta in una tabella tbl_smartcrm_logs, fornendo agli amministratori una traccia di audit continua e statistiche relative agli ultimi sette giorni.

Valore aziendale

Le aziende che utilizzano Smart CRM insieme a CRMconnect hanno bisogno che i dati rimangano coerenti tra entrambi i sistemi. Senza questo modulo, i record dovrebbero essere duplicati manualmente, causando incoerenze e perdita di tempo. SmartCRM automatizza il flusso di dati e fornisce visibilità immediata su eventuali errori di sincronizzazione.

Chi lo utilizza: Amministratori CRM che configurano l'integrazione; responsabili team che monitorano le statistiche di sincronizzazione; personale di supporto che analizza le discrepanze di dati tra i due sistemi.
Vantaggio chiave: Sincronizzazione automatica e pianificata di tutte le entità CRM principali con monitoraggio degli errori integrato e logica di ripetizione configurabile.

Casi d'uso tipici:

Configurare l'endpoint API Smart CRM e il token di autenticazione, quindi eseguire un test di connettività prima di abilitare la sincronizzazione automatica.
Pianificare la sincronizzazione automatica ogni 1, 2, 4, 12 o 24 ore tramite l'opzione cron integrata.
Attivare manualmente una sincronizzazione una tantum per un tipo di entità specifico (lead, clienti, progetti, ticket o fatture) dopo un'importazione massiva di dati.
Rivedere la dashboard degli errori per identificare quali record non sono stati sincronizzati e perché, quindi riprovare dopo aver risolto il problema sottostante.
Ottimizzare i parametri di prestazione come la dimensione del batch, il timeout API e il numero massimo di tentativi per adattarsi alla capacità dell'API remota.

Accesso al modulo

/admin/smartcrm

Concetti chiave

Concetto	Descrizione
URL API	L'endpoint base dell'API REST Smart CRM remota.
Token di autenticazione	Token bearer utilizzato per autenticare ogni chiamata API in uscita.
Sincronizzazione cron	Sincronizzazione automatica opzionale attivata dal job cron di CRMconnect all'intervallo configurato.
Intervallo di sincronizzazione	Con quale frequenza viene eseguita la sincronizzazione automatica: 1, 2, 4, 12 o 24 ore.
Dimensione batch	Numero di record inviati per richiesta API (predefinito 50). Controlla il throughput vs. il carico.
Timeout API	Secondi massimi di attesa per una risposta dall'API remota (predefinito 30 s).
Tentativi massimi	Quante volte una chiamata API fallita viene ripetuta prima che il record venga registrato come errore.
Livello log	Gravità minima scritta nel log di sincronizzazione: DEBUG, INFO, WARNING o ERROR.
Statistiche sincronizzazione	Conteggi aggregati di sincronizzazioni riuscite e fallite negli ultimi 7 giorni, mostrati nella dashboard.
Errori recenti	Le 10 voci di log più recenti a livello ERROR, mostrate nella dashboard per una rapida valutazione.
Test di connessione	Ping API automatico eseguito ogni volta che le impostazioni vengono salvate per validare immediatamente le credenziali.

Azioni comuni

Configurare l'integrazione — Navigare su /admin/smartcrm, inserire l'URL API e il token di autenticazione, regolare la dimensione del batch, il timeout, il numero di tentativi e il livello log, quindi salvare. Viene eseguito automaticamente un test di connessione che riporta il successo o un avviso.
Abilitare la sincronizzazione automatica — Impostare "Sincronizzazione cron" su Sì e scegliere un intervallo di sincronizzazione. La successiva esecuzione pianificata del cron inizierà a inviare dati a Smart CRM.
Sincronizzare manualmente i lead — Fare clic sull'azione "Sincronizza Lead"; il modulo chiama sync_leads_with_smartcrm e restituisce un risultato JSON con conteggi ed eventuali errori.
Sincronizzare manualmente i clienti — Fare clic sull'azione "Sincronizza Clienti" per inviare tutti i record clienti al sistema remoto.
Sincronizzare manualmente i progetti — Fare clic sull'azione "Sincronizza Progetti" per sincronizzare i progetti attivi.
Sincronizzare manualmente i ticket — Fare clic sull'azione "Sincronizza Ticket" per inviare i dati dei ticket di supporto.
Sincronizzare manualmente le fatture — Fare clic sull'azione "Sincronizza Fatture" per inviare i record finanziari.
Monitorare la dashboard — La pagina principale SmartCRM mostra le statistiche di sincronizzazione a 7 giorni e i 10 errori più recenti in modo che gli amministratori possano valutare la salute dell'integrazione a colpo d'occhio.
Rivedere i log dettagliati — Navigare alla vista Log per filtrare per livello log (DEBUG / INFO / WARNING / ERROR) e ispezionare i dettagli completi di richiesta/risposta per qualsiasi operazione di sincronizzazione.
Visualizzare la panoramica degli errori — La pagina Panoramica Errori aggrega i pattern di errore ricorrenti per aiutare a prioritizzare le correzioni.

Fonte: crm-connect-main/app/modules/smartcrm