Documentazione

Collegare Cadulis a servizi esterni


Collega il tuo Cadulis al tuo ambiente aziendale

Cadulis si interfaccia facilmente con i tuoi strumenti esterni grazie a connettori dedicati o tramite webservice configurabili.

Puoi così automatizzare flussi come:

  • La creazione di interventi
  • L’aggiornamento delle schede clienti
  • Il recupero di documenti dalla tua contabilità

Questa guida ti accompagna passo dopo passo nella configurazione delle principali tipologie di accesso esterno.


1. Accedere alle integrazioni

Dal menu laterale sinistro:

  1. Clicca su Impostazioni
  2. Seleziona Collega Cadulis a servizi esterni
  3. Clicca su Accesso esterno
  4. Poi su Crea un accesso esterno

2. Scegliere il tipo di accesso esterno

Ecco le principali tipologie proposte con le loro specificità:

🔁 Webservice REST

Connessione bidirezionale tra Cadulis e uno strumento terzo (CRM, portale clienti, ERP…).

Campi da compilare:

  • Nome e descrizione
  • Restrizioni di accesso (tipi di interventi, visibilità)
  • Permessi dettagliati: consultare, modificare, creare, chiudere…
  • Regole di gestione dei campi (fusione, sovrascrittura…)

🎯 Raccomandazione: attiva solo i permessi strettamente necessari.

La documentazione tecnica è disponibile tramite swagger qui: 👉 Swagger API entrante Cadulis


📋 Webhooks Kizeo Forms

Connessione tra i moduli Kizeo Forms e Cadulis.

  • Nome, descrizione
  • Permessi: creare, modificare, chiudere
  • Inserimento automatico di campi personalizzati
  • Trasformazione JSON modificabile

🔗 Ricezione dati da HubSpot

Connessione diretta al tuo account HubSpot per recuperare contatti o clienti.

Fasi:

  1. Crea l’accesso (nome, BU, descrizione)
  2. Salva
  3. Modifica > Collega HubSpot tramite reindirizzamento sicuro
  4. Monitoraggio tramite i log di scambio

📘 Ricezione dati da Notion

Automatizza la creazione di attività Cadulis a partire da elementi Notion (ticket, task…).

  • Crea l’accesso (nome, BU)
  • Connessione sicura a Notion
  • Accesso ai log tecnici

📄 Ricezione documenti di fatturazione da EBP

Connessione con EBP - Gestione commerciale.

⚠️ Richiede l’attivazione dell’API Rest EBP (tramite il loro supporto).

  • Inserisci il Client ID e il Client Secret in Cadulis
  • I documenti contabili vengono ricevuti automaticamente
  • Monitoraggio tramite registri di scambio ed errori

💼 Connessione con Pennylane (tramite trigger)

Trasforma automaticamente i tuoi interventi Cadulis in preventivi o fatture su Pennylane.

Prerequisiti:

  • Account Cadulis + account Pennylane attivo
  • Numerazione definita in Pennylane

Fasi:

  1. Attiva la gestione finanziaria in Cadulis:
    • Impostazioni > Catalogo
    • Seleziona il tipo di attività > Attiva i dati di fatturazione
  2. Crea un trigger in Impostazioni > Trigger
  3. Seleziona Fattura con Pennylane
  4. Collega il tuo account Pennylane tramite reindirizzamento sicuro
  5. Configura le condizioni e i dati da trasmettere

Una scheda cliente viene creata automaticamente in Pennylane se non esiste già.


📬 Casella email esterna

Permette a Cadulis di leggere automaticamente una casella email ed estrarre informazioni per creare o modificare attività.

  • Import automatico ogni 15 minuti
  • POP3 / IMAP, SSL, porte, credenziali
  • Mapping tramite tag personalizzati:
    • {campo} per estrazioni su una sola riga
    • {{campo}} per estrazioni su più righe
  • Possibile estrazione degli allegati

3. Buone pratiche

Per integrazioni affidabili e sicure

  • Utilizza ambienti di test
  • Non concedere mai più permessi del necessario
  • Documenta ogni accesso (nominativo, utilizzo, descrizione)
  • Crea un accesso distinto per ogni utilizzo o strumento collegato
  • Consulta i log fin dai primi scambi

Approfondimenti

Consulta le guide specifiche per ogni connettore: