La tua impresa edile usa un CRM per gestire la pipeline commerciale (preventivi, opportunità, vinte). Quando una pratica viene chiusa, qualcuno deve copiare manualmente i dati nel gestionale di cantiere: nome cliente, indirizzo, valore, data inizio prevista. Tempo: 15-30 minuti per pratica. Errori frequenti. Vediamo come automatizzarlo via API.
Lo scenario tradizionale
- Commerciale chiude pratica nel CRM.
- Notifica email al responsabile operativo.
- Responsabile apre il gestionale cantieri.
- Crea nuovo cantiere manualmente.
- Copia i dati dal CRM.
- Salva.
- Eventuali errori di trascrizione.
Tempo totale: 15-30 minuti per pratica + 2-5% di errori.
Lo scenario integrato
- Commerciale chiude pratica nel CRM.
- CRM invia chiamata API a Edilgestya.
- Edilgestya crea automaticamente il cantiere con tutti i dati.
- Notifica push al responsabile operativo.
- Responsabile valida e pianifica.
Tempo totale: 30 secondi. Errori: zero (dati identici al CRM).
Come funziona tecnicamente
Edilgestya espone un endpoint API REST:
POST /cantiere/crea
Body JSON:
{
"titolo": "Installazione fotovoltaico Rossi",
"cliente": {
"ragione_sociale": "Costruzioni Rossi srl",
"p_iva": "01234567890",
"indirizzo": "Via Roma 25, Milano",
"telefono": "0212345678",
"email": "info@rossisrl.it"
},
"data_inizio": "2026-06-01",
"data_fine_prevista": "2026-08-15",
"valore_stimato": 12500,
"descrizione": "Impianto fotovoltaico 6kW",
"pratica_id": "PR-2026-1234",
"azienda_origine": "azienda_xyz",
"sistema_origine": "salesforce"
}
Edilgestya:
- Verifica autenticazione (Bearer Token).
- Valida i dati.
- Crea/aggiorna cliente in anagrafica.
- Crea cantiere associato.
- Marca origine (per sync future).
- Restituisce ID cantiere creato.
Vedi modulo Integrazione API.
I CRM compatibili
L'integrazione funziona con qualsiasi CRM moderno che permetta:
- Trigger su evento "deal vinto" / "pratica chiusa".
- Chiamata HTTP/webhook personalizzata.
CRM tipici:
| CRM | Modalità integrazione |
|---|---|
| Salesforce | Apex trigger + outbound message |
| HubSpot | Workflow + webhook |
| Pipedrive | Webhook su deal stage |
| Zoho CRM | Workflow rules + webhook |
| Processi.cloud | Integrazione nativa |
| CRM custom | HTTP POST personalizzato |
Casi d'uso pratici
Caso 1: pipeline vendite standard
Commerciale presenta preventivo, cliente accetta, viene firmato il contratto. Stato del deal nel CRM: "Vinto".
Trigger automatico:
- API call a Edilgestya con dati cantiere.
- Cantiere creato automaticamente.
- Responsabile operativo notificato.
- Pianificazione settimanale può iniziare.
Caso 2: aggiornamento stato cantiere
Cantiere completato in Edilgestya → notifica al CRM:
- Aggiornamento stato deal a "Consegnato".
- Trigger fattura nel CRM.
- Trigger follow-up commerciale per nuovi servizi.
Caso 3: pre-pianificazione attività
Quando una pratica viene chiusa con date specifiche (sopralluogo, installazione, collaudo), il CRM può pre-creare le attività nel planning Edilgestya:
POST /api/sopralluogo/crea
POST /api/installazione/crea
POST /api/collaudo/crea
Risultato: planning operai pre-popolato con le attività della nuova pratica.
Caso 4: sincronizzazione utenti
Quando un nuovo operaio viene assunto e inserito nel sistema HR/payroll:
- Sistema HR chiama API Edilgestya.
- Operaio creato automaticamente con ruolo "operaio".
- Email di onboarding automatica.
POST /api/utenti/sincronizza
Sicurezza dell'integrazione
- Bearer Token: autenticazione robusta.
- HTTPS obbligatorio: dati cifrati in transito.
- Rate limiting: protezione abusi.
- Validazione input: ogni campo validato.
- Audit log: ogni chiamata loggata.
- Multi-tenant: ogni token legato a un'azienda specifica.
Implementazione step-by-step
Step 1: ottieni token API
Da pannello admin Edilgestya, genera Bearer Token per l'integrazione.
Step 2: configura il CRM
Nel CRM, configura webhook su evento "deal vinto" che invia POST a Edilgestya con dati pratica.
Step 3: mappa i campi
Crea mapping: campo CRM → campo Edilgestya. Eventualmente trasformazioni (es. data formato).
Step 4: test in sandbox
Prova con pratica fittizia. Verifica creazione cantiere.
Step 5: produzione
Attivazione integrazione live.
Tempo totale implementazione: 1-3 giornate per l'IT (o consulente).
Rischi se NON integrato
- Dati duplicati: stesso cliente in entrambi i sistemi con dati diversi.
- Errori di trascrizione: 2-5% delle pratiche.
- Cantieri "dimenticati": pratica vinta ma nessuno crea il cantiere.
- Tempo amministrativo: 15-30 min per pratica × 100 pratiche/anno = 25-50 ore/anno.
- Ritardo operativo: 1-3 giorni tra vendita e inizio operativo.
I moduli Edilgestya correlati
Scopri Edilgestya e integra CRM e cantieri.
