Azione Webhook

La fase di processo “Webhook” di onOffice consente di richiamare determinati servizi automaticamente e in background. In parole povere, un Webhook è il richiamo di una pagina web appositamente preparata che trasmette informazioni mirate senza la necessità di interrogazioni costanti (“polling”).

Questi servizi operano in background, invisibili all’utente, e vengono attivati da azioni specifiche – ad esempio quando cambiano i campi di un immobile durante il salvataggio. È possibile utilizzare webhook legati ai servizi di Marketplace oppure webhook personalizzabili tramite GET o POST.

Contesto “Webhook legato ai servizi Marketplace”

Questo contesto permette l’inoltro di informazioni a un servizio di un partner del Marketplace di onOffice. Ciò significa che verrà attivato il Webhook del rispettivo fornitore.

Esempi:

• Valutazione immobiliare PriceHubble: Se cambiano, ad esempio, i campi relativi al prezzo o alla superficie di un immobile, è possibile attivare il Webhook di PriceHubble per avviare una nuova valutazione.
• Newsletter Connector: Per il trasferimento automatizzato dei dati a un servizio di newsletter.

Requisito: Il servizio del Marketplace deve essere eseguito dal fornitore come Webhook e configurato di conseguenza nel suo servizio.

Servizio / Parametri

Qui trovi tutti i servizi del Marketplace attivati nel tuo account che contengono un Webhook. Seleziona il servizio desiderato e inserisci, se necessario, i valori dei parametri che verranno passati all’URL durante il richiamo del Webhook. I parametri possibili sono stabiliti dal rispettivo fornitore.

Informazioni per gli esperti

I Webhook sono ideali per utilizzare il servizio di un fornitore del Marketplace all’interno di un processo – ad esempio in caso di modifiche a un immobile – per ricalcolare il valore di mercato.

In caso di domande sui singoli webhook, consulta la documentazione del fornitore in questione o contatta direttamente il fornitore del servizio Marketplace. Se hai delle domande sulla fase del processo “Webhook”, contatta l’assistenza di onOffice (assistenzaclienti@onoffice.com / +39 011 19270400).

Contesto “Webhook personalizzabile” – GET

Nel contesto “Personalizzabile” di tipo GET, puoi inserire un URL di webhook; quando la fase del processo viene eseguita, l’URL specificato viene richiamato in background.

Puoi aggiungere ulteriori informazioni all’URL con apposite macro. Per farlo, aggiungi i valori desiderati alla fine dell’URL usando “?” e poi “&”:

Ad esempio: https://meineurl.de?meinlabel1=_makro1&meinlabel2=_makro2

“mylabel” rappresenta a titolo di esempio il nome del rispettivo campo nel sistema di destinazione.

Nota bene: verranno elaborate solo le macro per le quali la fase di processo ha un contesto. Si tratta principalmente di macro delle categorie immobili, contatti, utenti, gruppi regionali, dati aziendali e altre categorie generali come i valori CI.

Timeout: definisci nel campo “Timeout in secondi“ (1-999) il tempo massimo di attesa per una risposta dal server di destinazione. Per impostazione predefinita sono impostati 30 secondi.

Contesto “Webhook personalizzabile” – POST

Oltre al metodo GET, il process manager supporta le richieste POST per inviare payload strutturati nel corpo della richiesta.

Configurazione di base e timeout

Nella fase del processo, seleziona il contesto “Personalizzabile” e il tipo POST. Dopo aver inserito l’URL di destinazione, puoi impostare nel campo “Timeout in secondi“ (1-999) il tempo massimo di attesa per una risposta dal server di destinazione, se necessario. Il superamento di questo limite comporta l’annullamento della richiesta e contrassegna la fase di processo come fallita.

Configurazione Header

Il sistema invia gli header Content-Type: application/json e Content-Lengthper impostazione predefinita. Il valore di Content-Length viene determinato solo in fase di esecuzione, poiché la risoluzione delle macro influisce sulla lunghezza effettiva del payload.

Per aggiungere altri parametri (ad esempio per l’autenticazione tramite Authorization), clicca sull’icona della matita accanto alla visualizzazione degli header. Nella finestra che si apre, è possibile creare coppie chiave-valore personalizzate.

Definizione del Payload (Body)

Il contenuto della richiesta viene definito in formato JSON nel campo Webhook Body. Qui possono essere utilizzate le macro di OnOffice, che verranno sostituite in fase di esecuzione dai dati concreti del record collegato. Il corpo del messaggio è limitato dal sistema a una lunghezza massima di 4096 caratteri. I contenuti che superano questa lunghezza (comprese le macro elaborate) verranno troncati al momento dell’invio.

Diagnostica errori

Se un Webhook fallisce (ad es. per timeout o codici di stato HTTP 4xx/5xx), questo viene segnalato nella lista dei processi da un simbolo di avviso rosso (triangolo). I dettagli dell’errore e la risposta del server possono essere visualizzati passando il mouse su questa icona.