Wisegent – gestionale per imprese di pulizie

Wisegent per sviluppatori

I tuoi strumenti.Un unico flusso di lavoro.

Fai dialogare i tuoi sistemi. Collega CRM, sito web o strumenti di reportistica a Wisegent con la nostra API REST pubblica. Meno dati inseriti due volte. Più libertà di lavorare a modo tuo.

Parliamo di API Guarda un esempio

REST · JSON · API v1 · Permessi scelti da te

Il tuo collegamento personalizzato. Dall’altra parte, Wisegent.
  • Clienti e indirizzi
  • Lettura degli eventi del calendario
  • Token API revocabili

Intorno al tuo lavoro quotidiano

I dati giusti. Dove ti servono.

Crea un collegamento adatto al tuo modo di lavorare. Ecco cosa supporta oggi l’API pubblica.

Tieni uniti i dati dei clienti

Leggi, cerca, crea e aggiorna i clienti dal tuo sistema. Usa i tuoi numeri cliente per collegare le anagrafiche.

GET · POST · PUT

Collega l’indirizzo giusto

Leggi gli indirizzi di un cliente, aggiungine di nuovi e aggiorna quelli esistenti. Trasferisci contatti e indirizzi senza inserire tutto due volte.

GET · POST · PUT

Dai più possibilità al tuo calendario

Leggi interventi ed eventi del calendario per un periodo scelto. Usali come base per le tue panoramiche e i tuoi report.

GET /events

Il calendario è di sola lettura nell’API pubblica. Fatture, paghe ed eliminazione dei record non fanno parte dell’API v1.

Dalla richiesta alla risposta

Una richiesta. Una risposta chiara.

Invia il token nell’header Authorization e ricevi dati JSON strutturati. Ecco un esempio di recupero dei dati di un cliente.

RichiestacURL
curl "https://app.wisegent.se/api/public/v1/clients/42" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN"
Estratto della risposta200 OK
{
  "data": {
    "id": 42,
    "type": "company",
    "name": "Example AB",
    "contact_email": "[email protected]",
    "status": 1
  }
}

Esempio con dati fittizi. Qui non viene inviata alcuna richiesta. Sostituisci YOUR_TOKEN e l’ID cliente nella tua integrazione.

Trovi endpoint, campi e codici di errore nella documentazione dell’API. È necessario accedere a Wisegent.

Accesso con confini chiari

Scegli tu cosa può fare il collegamento.

Ogni integrazione usa il proprio token. Concedi solo l’accesso necessario e mantieni il controllo in Wisegent.

  • Scegli i permessi

    Scegli l’accesso in lettura ai clienti, in scrittura ai clienti o in lettura al calendario. Restano validi anche i permessi già assegnati all’account.

  • Solo i dati della tua impresa

    Un token può accedere solo ai dati del titolare dell’account. Clienti e interventi di altre imprese non sono accessibili.

  • Un segreto sotto il tuo controllo

    Il token viene mostrato una sola volta, alla creazione. Conservalo sul tuo server, mai nel codice pubblico del browser. Revocalo nelle impostazioni quando non serve più.

Dall’idea all’integrazione

Tre passi per il tuo collegamento.

Servono un account Wisegent e uno sviluppatore o un partner tecnico che realizzi e mantenga il collegamento.

URL di base dell’APIhttps://app.wisegent.se/api/public/v1

  1. Crea un token

    Il titolare dell’account apre Impostazioni → Integrazioni → API. Assegna un nome al collegamento, seleziona i permessi e copia subito il token.

  2. Prepara la prima richiesta

    Segui la documentazione dell’API e invia il token come Bearer token. Inizia leggendo i dati di un cliente e verificando la risposta nel tuo sistema.

  3. Gestisci il flusso nel tempo

    Gestisci paginazione, errori di validazione e limiti di frequenza. Aggiungi l’accesso in scrittura solo se l’integrazione deve creare o aggiornare clienti.

Prima di iniziare

Domande sull’API.

Parliamo di API
A quali dati possiamo accedere?

L’API v1 permette di leggere, creare e aggiornare clienti e relativi indirizzi, oltre a leggere gli eventi del calendario. Non comprende fatture, paghe, eliminazioni o creazione e modifica degli interventi.

Serve uno sviluppatore?

Sì, un’integrazione API personalizzata richiede sviluppo e manutenzione. Per automazioni pronte senza codice personalizzato, puoi invece scoprire la nostra integrazione con Zapier.

Ci sono limiti di frequenza?

Il limite è di 120 richieste al minuto per titolare dell’account, di cui al massimo 30 in scrittura. Le query del calendario possono coprire fino a 93 giorni. Usa la paginazione e gestisci il codice di risposta 429 nella tua integrazione.

Dove si trova la documentazione?

La documentazione dell’API è nel centro assistenza di Wisegent, dopo l’accesso, con endpoint, autenticazione, esempi e specifica OpenAPI. È raggiungibile anche da Impostazioni → Integrazioni → API.

I tuoi sistemi. Il tuo collegamento.

Cosa vorresti collegare a Wisegent?

Raccontaci come lavori oggi. Ti aiuteremo a capire cosa può supportare l’API e da dove cominciare.

Parliamo di APISenza codice personalizzato? Scopri Zapier