Integrare SmartCQ con il CRM o il gestionale che già usi

La maggior parte degli operatori del credito al consumo italiano ha già un gestionale o un CRM: quello imposto dalla mandante, quello scelto anni fa, quello costruito su misura. SmartCQ non vuole sostituirli, vuole sedersi accanto. Per farlo servono due cose: un modo per far uscire i dati quando succede qualcosa di rilevante, e un modo per farli entrare e leggere da fuori. Sono i webhook in uscita e le API REST.

Webhook: i dati arrivano dove servono, quando servono

Un webhook è una notifica automatica che SmartCQ invia a un indirizzo tuo nel momento in cui accade un evento: un contatto che si disiscrive, una campagna che completa l'invio, un nuovo contatto che entra in piattaforma. Configuri l'endpoint una volta da Impostazioni → Webhook e da quel momento il tuo sistema viene avvisato in tempo reale, senza che nessuno debba aprire la dashboard ogni mattina per controllare cosa è cambiato.

API REST: il tuo gestionale legge e scrive

Le API permettono al tuo CRM o gestionale di leggere e scrivere i dati del tuo spazio SmartCQ: contatti, eventi email, campagne. Ogni integrazione usa una chiave dedicata (da Impostazioni → API Keys) che puoi revocare in qualsiasi momento senza toccare le altre. Se domani cambi fornitore di un pezzo della filiera, spegni una chiave e il resto continua a funzionare.

Tre pattern di integrazione che vediamo ricorrenti

• Sincronizzazione bidirezionale con il CRM principale: i contatti di SmartCQ diventano record nel CRM, lo stato del CRM torna in SmartCQ come tag. Nessun doppio inserimento.
• Pipeline analitica: gli eventi email (consegne, aperture, click, disiscrizioni) finiscono via webhook nel tuo data warehouse o nel foglio di analisi che già usi.
• Workflow di automazione: campagna completata → notifica su Slack o Teams al team commerciale, che sa quando partire con le chiamate.

Chi tiene la fonte di verità?

Quale pattern fa per te dipende da una domanda sola: chi tiene la fonte di verità del contatto? Se è il CRM, SmartCQ legge da lui via API e si occupa della parte campagne e deliverability. Se è SmartCQ, il CRM ascolta i webhook e si aggiorna da solo. Non c'è una risposta giusta in assoluto: c'è quella coerente con come lavora il tuo studio.

Da dove partire

Se hai uno spazio SmartCQ attivo: la configurazione dei webhook è documentata nella guida ai webhook, e il riferimento completo delle API copre autenticazione, contatti, campagne ed eventi email, con gli esempi pronti da copiare. Le chiavi si creano da Impostazioni → Sviluppatori. Hai un'integrazione specifica in mente che vorresti vedere documentata? Scrivici: i casi reali sono quelli su cui lavoriamo prima.