Integrazioni: il report dentro il tuo gestionale e il tuo sito

Il report entra negli strumenti che un'agenzia usa già in tre modi, dal più semplice al più completo: un collegamento con l'indirizzo, che chiunque può aggiungere a una scheda o a un'email; il widget dell'indice di vivibilità da mettere negli annunci del sito; le API, per creare i report e scaricare i PDF direttamente dal gestionale. Qui sotto trovi come funziona ognuno, con gli esempi pronti da copiare.

Un collegamento con l'indirizzo

La pagina dell'immobile si apre con la ricerca già fatta quando l'indirizzo è nel collegamento. Per esempio questo apre Via Dante 7 a Milano: mostra il lotto sulla mappa, foglio e particella e l'indice di vivibilità della zona, e da lì si crea il report completo.

Il collegamento accetta tre modi di indicare l'immobile:

Per un terreno si aggiunge &tipo=terreno, e la pagina parte dalla scheda del terreno con superficie, pendenza e quota. Il codice del comune è il codice Istat a sei cifre, lo stesso dei dati catastali. Nell'indirizzo gli spazi e le virgole vanno codificati, come fa da solo qualunque linguaggio di programmazione.

In un gestionale basta un pulsante nella scheda dell'immobile che compone il collegamento con l'indirizzo della scheda:

<a href="https://vicinalia.com/immobile?indirizzo=VIA_NUMERO_COMUNE_CODIFICATI" target="_blank" rel="noopener">Analizza la zona</a>

Il collegamento del partner

Chi aderisce al programma partner aggiunge al collegamento il suo codice, con &rif= seguito dal codice personale. Il cliente arriva sulla pagina dell'immobile, il sito ricorda da chi è arrivato e al suo primo acquisto il partner riceve la provvigione. Per un gestionale vuol dire offrire ai propri clienti un servizio in più e guadagnare su ogni nuovo cliente che lo usa:

https://vicinalia.com/immobile?indirizzo=Via%20Dante%207%2C%20Milano&rif=CODICE

Il widget dell'indice di vivibilità

Con i piani Pro e Studio l'agenzia mette negli annunci del proprio sito l'indice di vivibilità della zona, da 0 a 100, con la sua fascia. Il widget è una pagina da incorporare con un iframe: si registra il dominio del sito in Impostazioni, Widget, e si riceve una chiave che funziona solo su quel dominio.

<iframe src="https://vicinalia.com/widget/vivibilita?chiave=LA_TUA_CHIAVE&indirizzo=Via%20Dante%207%2C%20Milano&lingua=it" width="360" height="220" style="border:0" loading="lazy" title="Indice di vivibilità della zona"></iframe>

Al posto dell'indirizzo si possono passare le coordinate, con lat e lon, e la lingua può essere it o en. Il valore è quello della sezione di censimento dell'indirizzo, calcolato con lo stesso metodo della pagina indice di vivibilità.

Le API

Le API servono a chi vuole creare i report e scaricare i PDF senza passare dal sito: un gestionale che genera il report quando entra un nuovo incarico, un portale che lo allega alla scheda. Sono comprese nei piani Pro e Studio: si chiede l'attivazione da Impostazioni, API, scrivendo l'uso previsto, e dopo la conferma si creano i token di accesso, fino a dieci per account.

Ogni richiesta va a https://vicinalia.com/api/v1 con le intestazioni Authorization: Bearer seguita dal token e Accept: application/json.

I report creati con le API sono quelli del piano, come quelli creati dal sito, e si ritrovano nell'area personale. Ogni token fa fino a 60 richieste al minuto. La guida completa, con gli esempi di risposta, si apre in Impostazioni, API, appena l'accesso è attivo.

Per chi sviluppa un gestionale

Se sviluppi un gestionale per agenzie e vuoi portare il report ai tuoi clienti, il collegamento con l'indirizzo e il codice partner bastano per cominciare: un pulsante nella scheda dell'immobile, nessun sistema da collegare. Per un'integrazione più stretta con le API, o per parlarne insieme, scrivici dalla pagina Contatti. Cosa chiedono oggi le agenzie a un gestionale è nella guida Gestionale per agenzie immobiliari, e cosa trovano nel report è nella pagina per le agenzie immobiliari. I piani sono in Prezzi.