Come inviare i progetti da Home Planner al tuo CRM

Collega HubSpot, Pipedrive, Bitrix24, Salesforce, Fogli Google o il tuo sistema personalizzato e invia progetti completi di stanze, prodotti, prezzi e planimetria in un solo passaggio.

Ogni progetto inviato arriva nel tuo CRM come un singolo record con il link al progetto, le stanze, i prodotti con i codici SKU, le quantità, i prezzi, il totale e la planimetria in formato PDF. Nessun copia e incolla dagli screenshot e nessuna trascrizione dei preventivi.
Questa guida spiega come collegare HubSpot, Pipedrive, Bitrix24, Salesforce o Fogli Google tramite Zapier e come connettere qualsiasi altro sistema tramite il relativo URL.
Come funziona
- Collega una volta sola. Aggiungi una connessione nell'app: scegli il tuo CRM o incolla l'URL del tuo sistema.
- Progetta. Pianifica le stanze insieme al cliente e arredale inserendo prodotti e prezzi.
- Invia. Con il progetto aperto, seleziona Condividi → Invia a…. Il progetto arriverà nel tuo CRM in pochi secondi.
Prima di iniziare
| Requisiti | Motivazione |
|---|---|
| Piano PRO++ o prova gratuita | L'invio al CRM fa parte del piano PRO++. Se non disponi del piano PRO++, la creazione della prima connessione avvierà una prova gratuita di 14 giorni, senza alcun pagamento richiesto. |
| Un account Home Planner | Le connessioni sono collegate al tuo account e funzionano su tutti i tuoi dispositivi. L'app ti chiederà di accedere al momento di salvare la prima connessione. |
| Un progetto salvato sul cloud | Un progetto archiviato solo su questo dispositivo non può essere inviato. Il record contiene infatti il link alla copia online del progetto. |
| Un account Zapier (per HubSpot, Pipedrive, Bitrix24, Salesforce e Fogli Google) | Zapier trasmette il progetto al tuo CRM. Zapier offre piani gratuiti e a pagamento. A partire da ottobre 2026, l'utilizzo con Salesforce richiede un piano Zapier a pagamento (consulta i prezzi di Zapier). |
Collega il tuo CRM tramite Zapier
I passaggi da seguire sono gli stessi per tutti i sistemi. L'unica differenza riguarda l'azione per il CRM al passaggio 5 in Zapier (consulta la tabella seguente).
In Home Planner
- Vai su Impostazioni → Azienda → CRM e fogli di calcolo. In alternativa, apri un progetto qualsiasi e seleziona Condividi → CRM e fogli di calcolo.
- Seleziona Aggiungi connessione e scegli il tuo sistema.
- Seleziona Copia chiave. La chiave collegherà Zapier al tuo account Home Planner. Se non hai il piano PRO++, questa operazione avvierà la tua prova gratuita di 14 giorni.
In Zapier
- Aggiungi Home Planner al tuo account Zapier. L'app Home Planner è attualmente in fase di revisione da parte di Zapier. Fino al suo inserimento nell'elenco ufficiale, inviaci un'email per richiedere un invito e ti risponderemo inviandoti un link. Se nell'app viene visualizzata l'opzione Apri lo Zap già pronto, seleziona direttamente quella: il trigger e il passaggio relativo al tuo CRM risulteranno già impostati.
- Crea uno Zap impostando il trigger Home Planner → Project Sent.
- Connetti un nuovo account e incolla la chiave nel campo Chiave di connessione. Zapier mostrerà il nome della connessione definito nell'app.
- Esegui un test del trigger. Zapier caricherà un progetto di esempio per consentirti di mappare i campi prima del tuo primo invio effettivo.
- Aggiungi l'azione specifica per il tuo CRM e mappa i vari campi (fai riferimento alla tabella).
- Attiva lo Zap. Tornando nell'app, lo stato della connessione passerà a Attiva. Se viene ancora mostrato il messaggio «Lo Zap non è ancora attivo», disattiva e riattiva lo Zap.
| Sistema | Azione in Zapier | Mappatura consigliata |
|---|---|---|
| HubSpot | Create Deal | Project name → deal name; totals.sum → amount; Project link, Products (text) e PDF link → description |
| Pipedrive | Create Deal | Project name → title; totals.sum e totals.currency → value; Products (text) → note |
| Bitrix24 | Create Deal oppure Create Lead | Project name → title; totals.sum → amount; Products (text) → comment |
| Salesforce | Create Record → Opportunity | Project name → name; totals.sum → amount; Project link → description. Richiede un piano Zapier a pagamento (aggiornato a ottobre 2026). |
| Fogli Google | Create Spreadsheet Row | Project name, totals.sum, Project link e updated in colonne distinte, con una riga per ciascun progetto inviato |
Invia un progetto
- Apri il progetto. Assicurati che il preventivo sia pronto, controllando che prodotti, quantità e prezzi siano quelli corretti da mostrare al cliente.
- Seleziona Condividi → Invia a…. Ogni connessione attiva disporrà di una propria riga, come ad esempio Invia a HubSpot.
- Verifica il risultato. L'app mostrerà il messaggio Progetto inviato a HubSpot con il conteggio di stanze e prodotti. Se il tuo sistema non risponde, l'app mostrerà la scritta Riproveremo automaticamente: Home Planner effettuerà dei nuovi tentativi dopo 1 minuto, 10 minuti e 1 ora.
Hai inviato lo stesso progetto due volte? Se un progetto non ha subito modifiche e viene reinviato entro 24 ore, non verrà duplicato. Modificando un qualsiasi elemento (un prezzo, una quantità o la planimetria), l'invio successivo creera un nuovo record.
Contenuto di un record
A Zapier e al tuo URL personalizzato arrivano i medesimi campi. Prezzi e totali corrispondono a quelli del preventivo del progetto nell'app.
| Campo | Descrizione del contenuto |
|---|---|
| planName | Nome del progetto |
| revisionUrl | Link al progetto online. Il cliente potrà aprirlo all'interno del browser o direttamente nell'app. |
| pdfUrl | PDF della planimetria. È presente se la tua planimetria include l'esportazione del disegno; il file viene conservato per 7 giorni, pertanto si consiglia di salvarlo nel proprio CRM. |
| totals.sum, totals.currency, totals.items | Importo totale del preventivo, valuta utilizzata e numero di righe presenti |
| productsText | L'intero preventivo formattato come testo leggibile: stanze, prodotti, SKU e la formula quantità × prezzo. È la soluzione ideale per i campi dedicati a note o descrizioni. |
| rooms[] | Dettaglio di ciascuna stanza: nome, tipologia, superficie, dimensioni ed elementi contenuti |
| rooms[].items[] | Dettaglio di ciascun prodotto o materiale: itemNumber (SKU), nome, quantità, prezzo, totale, imageURL e componenti |
| client_reference_id | Identificativo univoco dell'invio effettuato |
| created, updated | Data e ora di creazione del progetto e del suo ultimo salvataggio |
Esempio di productsText:
Living room:
- Sofa Oslo (SOFA-1042): 1 × 899.00 = 899.00 USD
- Cushion (CUSH-17): 2 × 25.00 = 50.00 USD
- Oak flooring (Floor_Oak_01): 1 × 540.00 = 540.00 USD
Total: 1489.00 USDCollega un sistema personalizzato tramite URL (webhook)
Opzione indicata per i sistemi non presenti nell'elenco o per i server proprietari. Home Planner invierà il record sotto forma di JSON al tuo indirizzo HTTPS.
- Seleziona Aggiungi connessione → Altro sistema (il tuo URL). Inserisci un nome per il pulsante (massimo 24 caratteri) e il relativo URL, che deve obbligatoriamente iniziare con https://.
- L'app invierà una richiesta di prova e mostrerà un messaggio di conferma, ad esempio: Verificato: risposta 200 in 0.4 s.
- Consigliato: copia la Chiave di firma e usala sul tuo server per verificare ogni richiesta in ingresso.
La richiesta
| Componente | Valore |
|---|---|
| Metodo, body | POST, Content-Type: application/json, il record descritto in precedenza |
| X-HomePlanner-Signature | t=<unix time>,v1=<hex>, dove v1 = HMAC-SHA256(secret, t + "." + body) |
| X-HomePlanner-Delivery | ID di consegna. Rimane invariato a ogni nuovo tentativo: utilizzalo per ignorare gli invii duplicati. |
Verifica la firma confrontandola con il body grezzo della richiesta, esattamente come viene ricevuto e prima di qualsiasi parsing del JSON. Se il body viene elaborato e serializzato di nuovo, la firma non corrisponderà mai.
const crypto = require('crypto');
// rawBody: the request body exactly as received (Buffer or string), before JSON parsing.
// Express: app.post('/home-planner', express.raw({ type: 'application/json' }), handler)
function isFromHomePlanner(rawBody, header, secret) {
if (!header) return false;
const parts = Object.fromEntries(header.split(',').map(p => p.split('=', 2)));
if (!parts.t || !parts.v1) return false;
if (Math.abs(Date.now() / 1000 - Number(parts.t)) > 300) return false;
const expected = Buffer.from(
crypto.createHmac('sha256', secret).update(`${parts.t}.${rawBody}`).digest('hex'), 'hex');
const received = Buffer.from(parts.v1, 'hex');
return expected.length === received.length && crypto.timingSafeEqual(expected, received);
}La risposta del tuo server
- Qualsiasi codice 2xx restituito entro 15 secondi conferma la corretta consegna.
- In assenza di risposta o a fronte di codici 5xx, 408 o 429, Home Planner eseguirà dei nuovi tentativi dopo 1 minuto, 10 minuti e 1 ora, per poi interrompere l'invio trascorse 2 ore.
- Qualsiasi altro codice 4xx, così come i reindirizzamenti o gli errori relativi al certificato, è da considerarsi definitivo: la connessione passerà allo stato Errore. I reindirizzamenti non vengono seguiti.
- Gli indirizzi appartenenti a reti private o locali non sono consentiti (ad esempio localhost, 127.*, 10.*, 172.16–31.*, 192.168.* e 169.254.*).
Fogli Google senza Zapier. Una web app creata con Google Apps Script può essere utilizzata come URL. La sua consueta risposta 302 verso script.googleusercontent.com viene considerata come una consegna avvenuta con successo.
Stati ed errori
| Nell'app | Significato | Azione richiesta |
|---|---|---|
| Attiva | I progetti raggiungono correttamente Zapier o il tuo URL. | Nessuna azione richiesta. |
| Connessa | Lo scenario è collegato; i progetti vengono recapitati finché rimane attivo. | Mantieni lo scenario attivo. |
| Lo Zap non è ancora attivo | Zapier non si è ancora iscritto a questa chiave. | Attiva lo Zap. Se risulta già attivo, prova a disattivarlo e riattivarlo. |
| Disattivata | La connessione è stata disattivata manualmente. La relativa riga nel menu Condividi è nascosta. | Riattivala all'interno delle impostazioni della connessione. |
| Errore | L'ultimo invio non è andato a buon fine. Il motivo dell'errore è mostrato sotto lo stato. | Risolvi il problema segnalato e riprova a inviare dal menu Condividi. |
| Il server non ha risposto | Nessuna risposta ricevuta entro 15 secondi. | Verifica che il tuo server sia online e raggiungibile. |
| Server response: 404 | Il tuo sistema ha rifiutato la richiesta. | Controlla l'URL inserito e i log del tuo server. |
| Il certificato del sito non ha superato la verifica | Il certificato HTTPS è scaduto o non è valido. | Rinnova il certificato. |
| Non è stato possibile consegnare per 2 ore — l’invio è stato interrotto | Tutti i tentativi di invio sono falliti. | Risolvi il problema sul sistema ricevente e riprova l'invio. |
| Questo progetto è archiviato solo su questo dispositivo | Il progetto non è stato salvato sul cloud. | Attiva il salvataggio sul cloud per questo progetto. |
Domande frequenti
Quanto costa la funzionalità?
L'invio al CRM è incluso nel piano PRO++. Se non hai mai attivato il piano PRO++, la creazione della tua prima connessione avvierà una prova gratuita di 14 giorni. Zapier offre piani sia gratuiti sia a pagamento. A partire da ottobre 2026, l'integrazione con Salesforce richiede un piano Zapier a pagamento: verifica i prezzi di Zapier.
Cosa succede al termine del periodo di prova o del piano PRO++?
Le opzioni Invia a… scompariranno dal menu Condividi. Le connessioni salvate rimarranno memorizzate, permettendoti di disattivarle o eliminarle. Passando al piano PRO++, torneranno nuovamente operative senza dover configurare nulla.
Quante connessioni è possibile configurare?
Puoi configurare fino a 3 connessioni; ad esempio, HubSpot per la gestione delle trattative e Fogli Google per lo storico dei prezzi.
Ho generato una nuova chiave. Per quale motivo i progetti non arrivano più?
La creazione di una nuova chiave disattiva immediatamente quella precedente. Incolla la nuova chiave all'interno di Zapier, quindi disattiva e riattiva lo Zap.
Alcuni prodotti non hanno un codice SKU. Cosa viene inviato?
Vengono inviati utilizzando i codici prodotto interni di Home Planner. L'app ti mostrerà il numero di prodotti interessati subito dopo l'invio.
Il cliente ha visibilità su questi dati?
No. Il record viene trasmesso esclusivamente alla connessione che hai configurato (Zapier o il tuo URL personalizzato). Il cliente potrà accedere al progetto solo se deciderai di condividerne direttamente il link.
I dati presenti nel mio CRM sono al sicuro?
Home Planner si limita a inviare i dati e non legge mai le informazioni presenti nel tuo CRM. Puoi rigenerare la chiave o la chiave di firma in qualsiasi momento selezionando Nuova chiave o Nuova chiave di firma.
Note sui marchi registrati. Home Planner è un software indipendente e non è affiliato, sponsorizzato o approvato da HubSpot, Inc. Home Planner è altresì indipendente dagli altri marchi citati in questa pagina e non è da essi approvato, sponsorizzato o affiliato.
Provalo sul tuo progetto
App gratuita per iPhone, iPad, Mac, Android e Windows.


