Vai al contenuto
Zentra
DemoProva gratuita

Guide

Collega i tuoi strumenti. Passo dopo passo.

Il tuo negozio online e la posta, collegati a Zentra in pochi minuti. Inclusi in ogni formula.

Collegare Shopify

Shopify avvisa Zentra a ogni ordine, pagamento e annullamento. Un collegamento vale per un negozio. Calcola circa dieci minuti.

Cosa ti serve

  • Un accesso da amministratore al tuo negozio Shopify.
  • Il titolare o un amministratore dell’azienda in Zentra.
  • L’indirizzo .myshopify.com del negozio, visibile in Shopify sotto Impostazioni › Domini.

I passaggi

  1. Crea un primo webhook in Shopify.

    Impostazioni › Notifiche › Webhook › Crea webhook. Evento «Creazione dell’ordine», formato JSON. Come indirizzo, inserisci provvisoriamente https://zentraapp.ch: lo sostituirai al passo 4.

  2. Copia la chiave di firma.

    Una volta creato il webhook, Shopify mostra sotto l’elenco la chiave che firma tutti i tuoi webhook. Copiala.

  3. Collega il negozio in Zentra.

    Nell’app, apri Impostazioni › API, negozi e posta, poi Negozi online. Scegli Shopify, inserisci ma-boutique.myshopify.com, incolla la chiave e clicca su «Collega il negozio». Copia l’indirizzo di ricezione che compare.

  4. Inserisci l’indirizzo di ricezione in Shopify.

    Modifica il webhook del passo 1 e incolla l’indirizzo di ricezione. Crea poi «Pagamento dell’ordine» e «Annullamento dell’ordine», in JSON, con lo stesso indirizzo.

  5. Effettua un ordine di prova.

    Compare in Zentra come ordine del cliente da convalidare, e la riga del negozio indica l’ultimo ordine ricevuto.

Cosa succede dopo

  • Un ordine crea un ordine del cliente in bozza: cliente, indirizzo di consegna, articoli, spedizione e IVA ripresi da Shopify.
  • Il pagamento Shopify viene collegato alla fattura dell’ordine.
  • Un annullamento viene segnalato sull’ordine.

Cosa non devi più fare

  • Nessun ordine da ricopiare a mano dall’amministrazione Shopify.
  • Nessuna fattura dimenticata: ogni ordine attende la tua convalida nello stesso posto.
  • I pagamenti del negozio non vanno più spuntati uno a uno: il versamento sul tuo conto viene riconosciuto nella riconciliazione bancaria.

Zentra verifica la firma e il nome del negozio di ogni invio. Un invio ricevuto due volte viene elaborato una sola volta.

Collegare WooCommerce

WooCommerce invia a Zentra ogni ordine creato e ogni cambio di stato. Calcola dieci minuti.

Cosa ti serve

  • Un accesso da amministratore a WordPress, con WooCommerce.
  • Il titolare o un amministratore dell’azienda in Zentra.
  • Un segreto a tua scelta: una lunga serie di lettere e cifre, custodita come una password.

I passaggi

  1. Collega il negozio in Zentra.

    Nell’app, apri Impostazioni › API, negozi e posta, poi Negozi online. Scegli WooCommerce, inserisci l’indirizzo del negozio, per esempio boutique.ch, incolla il tuo segreto e clicca su «Collega il negozio». Copia l’indirizzo di ricezione.

  2. Crea il webhook «Ordine creato».

    In WordPress: WooCommerce › Impostazioni › Avanzate › Webhook › Aggiungi webhook. Stato Attivo, argomento «Ordine creato», URL di consegna: l’indirizzo di ricezione, segreto: lo stesso che in Zentra, versione API WP REST v3. Salva.

  3. Crea il webhook «Ordine aggiornato».

    Stesse impostazioni, con l’argomento «Ordine aggiornato». È lui ad annunciare il pagamento e l’annullamento.

  4. Effettua un ordine di prova.

    Compare in Zentra come ordine del cliente da convalidare. Segnalo come pagato in WooCommerce: il pagamento segue.

Cosa succede dopo

  • Un ordine crea un ordine del cliente in bozza, con il cliente, gli articoli, la spedizione e l’IVA.
  • Un ordine in lavorazione o completato e pagato collega il suo pagamento alla fattura.
  • Un ordine annullato, rimborsato o fallito viene segnalato.

Cosa non devi più fare

  • Niente più doppia registrazione tra WordPress e la tua contabilità.
  • I dati del cliente arrivano con l’ordine: niente da reinserire.
  • L’IVA e le spese di spedizione arrivano già ripartite.

Il primo invio di WooCommerce è un test senza firma: Zentra lo riconosce e lo accetta. Tutti gli altri vengono verificati con il tuo segreto.

Inviare le fatture per posta

Pingen stampa, imbusta e spedisce le tue fatture in Svizzera. Usi il tuo account Pingen; ogni lettera ti viene fatturata direttamente da Pingen.

Cosa ti serve

  • Un account Pingen per la tua azienda.
  • Il titolare o un amministratore dell’azienda in Zentra.
  • Per provare prima, un account di prova Pingen (staging): lì nessuna lettera viene spedita.

I passaggi

  1. Crea un accesso API in Pingen.

    Nel tuo account Pingen, crea un accesso API. Annota l’ID client, il segreto client e l’ID della tua organizzazione.

  2. Registralo in Zentra.

    Nell’app, apri Impostazioni › API, negozi e posta, poi Posta. Scegli Prova o Invii reali, incolla i tre valori e la posizione dell’indirizzo sulle tue fatture: a destra per una busta svizzera. Clicca su «Verifica e salva».

  3. Invia una fattura.

    Apri una fattura emessa. Nel menu «…», scegli «Invia per posta», poi Posta A o Posta B e la stampa a colori o in bianco e nero.

  4. Segui l’invio.

    Lo stato della lettera e il suo prezzo, come lo fattura Pingen, restano visibili sulla fattura.

Cosa succede dopo

  • Zentra invia a Pingen il PDF della fattura, fattura QR compresa.
  • Pingen stampa, imbusta e consegna la lettera alla Posta.
  • Zentra conserva lo stato di ogni lettera con la fattura.

Cosa non devi più fare

  • Niente più stampa, piegatura, busta né francobollo.
  • Niente più passaggi all’ufficio postale per i clienti che vogliono una fattura cartacea.
  • Ogni invio resta annotato con la fattura, se un cliente dice di non aver ricevuto nulla.

Finché non è registrato alcun account Pingen, l’invio per posta resta disattivato. Senza questo account Zentra non spedisce nulla a tuo nome.

Collegare Claude, ChatGPT o Le Chat

Il vostro assistente legge clienti, fatture e attività di Autopilota, prepara preventivi e schede, e conferma su vostra richiesta le attività interne. Accedete con il vostro account Zentra, senza chiavi da copiare. Contate cinque minuti.

Cosa ti serve

  • Un account Claude, ChatGPT o Le Chat che accetta connettori personalizzati.
  • Il titolare o un amministratore dell’azienda in Zentra.

I passaggi

  1. Aprite la pagina degli assistenti.

    Nel vostro account Zentra aprite Integrazioni › Collegare un assistente IA e scegliete il vostro assistente: compaiono i passaggi e l’indirizzo da copiare.

  2. Aggiungete il connettore nell’assistente.

    Incollate l’indirizzo https://zentraapp.ch/api/mcp nei connettori dell’assistente, senza chiave né impostazioni avanzate.

  3. Accedete a Zentra.

    L’assistente apre Zentra: accedete, scegliete l’azienda e cosa può fare l’assistente, poi autorizzate.

  4. Aprite una volta l’app.

    Aprite Zentra su un computer dell’azienda: l’app pubblica i dati e le attività che l’assistente legge.

  5. Fate una domanda.

    Per esempio «Chi mi deve dei soldi?» o «Cosa mi aspetta oggi?». In Claude queste domande sono proposte anche nel menu «+».

Cosa succede dopo

  • L’assistente legge gli importi calcolati da Zentra, senza ricalcolarli.
  • Ciò che prepara arriva come una scheda in Autopilota; la conferma solo se glielo chiedete.
  • Ogni richiesta compare nel vostro account, in Integrazioni, con il suo stato.

Cosa non devi più fare

  • Non serve più aprire l’app per sapere chi sollecitare o cosa vi aspetta.
  • Un preventivo o una scheda cliente si prepara con una frase, dal vostro telefono.
  • Le attività semplici si sbrigano in conversazione: rimandare, ignorare, segnare come fatto.

L’assistente non può inviare, pagare né eliminare nulla. Un clic su «Scollegare», in Integrazioni, gli toglie l’accesso.

Collegare Zentra a Zapier

Zapier collega Zentra a migliaia di applicazioni: Google Sheets, Slack, Mailchimp, il vostro CRM. Zentra avvisa Zapier tramite webhook, e Zapier deposita bozze in Zentra tramite l’API.

Cosa ti serve

  • Un account Zapier con i webhook («Webhooks by Zapier», inclusi nei piani a pagamento).
  • Una chiave API Zentra: Lettura per ricevere, Lettura e bozze per inviare.

I passaggi

  1. Create uno Zap con «Webhooks by Zapier».

    Trigger «Catch Hook». Zapier mostra un indirizzo di ricezione: copiatelo.

  2. Aggiungete questo indirizzo in Zentra.

    Nel vostro account Zentra, Integrazioni › Webhook: incollate l’indirizzo e scegliete gli eventi, per esempio «Fattura pagata». Cliccate su «Invia un test».

  3. Testate il trigger in Zapier.

    Zapier riceve l’evento: tipo, data e, in data.record, il documento completo.

  4. Aggiungete le vostre azioni.

    Per esempio una riga in Google Sheets o un messaggio Slack, con i campi ricevuti.

  5. Per creare in Zentra, chiamate l’API.

    Azione «Webhooks by Zapier › POST» verso https://zentraapp.ch/api/v1/drafts, in JSON, con l’intestazione Authorization: Bearer e la vostra chiave. La bozza arriva in Autopilota.

Cosa succede dopo

  • Ogni evento scelto parte verso Zapier, firmato e reinviato in caso di errore.
  • Ciò che Zapier invia arriva come una scheda da convalidare in Zentra.

Cosa non devi più fare

  • Niente più copia e incolla tra Zentra e i vostri altri strumenti.
  • Le vostre tabelle e i messaggi del team si aggiornano da soli.

Un’app Zentra ufficiale su Zapier, senza webhook da copiare, è in preparazione.

Collegare Zentra a Make

Make riceve gli eventi di Zentra tramite webhook e deposita bozze tramite l’API. Bastano i moduli «Webhooks» e «HTTP».

Cosa ti serve

  • Un account Make.
  • Una chiave API Zentra: Lettura per ricevere, Lettura e bozze per inviare.

I passaggi

  1. Aggiungete il modulo «Webhooks › Custom webhook».

    Create un webhook e copiate il suo indirizzo.

  2. Aggiungete questo indirizzo in Zentra.

    Nel vostro account Zentra, Integrazioni › Webhook: incollate l’indirizzo, scegliete gli eventi, poi cliccate su «Invia un test» perché Make impari la struttura.

  3. Costruite lo scenario.

    Collegate i moduli che preferite ai campi ricevuti: type, data.record.

  4. Per creare in Zentra, aggiungete «HTTP › Make a request».

    POST https://zentraapp.ch/api/v1/drafts, corps JSON, en-tête Authorization: Bearer et votre clé.

Cosa succede dopo

  • Ogni evento scelto avvia lo scenario.
  • Ciò che Make invia arriva come una scheda da convalidare in Zentra.

Cosa non devi più fare

  • Automazioni visive, senza codice, attorno alle vostre fatture e ai vostri clienti.

Make può anche leggere i vostri dati con «HTTP › Make a request», per esempio GET https://zentraapp.ch/api/v1/invoices?status=issued.

Collegare Zentra a n8n

n8n riceve gli eventi di Zentra con il suo nodo Webhook e chiama l’API con il nodo HTTP Request. I suoi agenti IA possono anche usare il server MCP di Zentra.

Cosa ti serve

  • Un’istanza n8n raggiungibile in https da Internet.
  • Una chiave API Zentra: Lettura per ricevere, Lettura e bozze per inviare.

I passaggi

  1. Aggiungete un nodo «Webhook».

    Metodo POST. Copiate l’indirizzo di produzione.

  2. Aggiungete questo indirizzo in Zentra.

    Nel vostro account Zentra, Integrazioni › Webhook: incollate l’indirizzo e scegliete gli eventi.

  3. Verificate la firma se lo desiderate.

    Un nodo Code può controllare l’intestazione Zentra-Signature con il segreto mostrato alla creazione del webhook; l’esempio è nella documentazione dell’API.

  4. Per creare in Zentra, aggiungete «HTTP Request».

    POST https://zentraapp.ch/api/v1/drafts, corps JSON, authentification par en-tête Authorization: Bearer et votre clé.

  5. Per un agente IA, aggiungete «MCP Client Tool».

    Indirizzo https://zentraapp.ch/api/mcp, intestazione Authorization: Bearer e la vostra chiave.

Cosa succede dopo

  • Ogni evento scelto avvia il workflow.
  • Ciò che n8n invia arriva come una scheda da convalidare in Zentra.

Cosa non devi più fare

  • Le vostre automazioni restano sul vostro server, con le vostre regole.

Conservate la chiave API nelle credenziali di n8n, mai in chiaro in un nodo.

E per il resto

Un modulo sul tuo sito, uno strumento interno o un assistente IA: l’API Zentra legge i tuoi dati e invia bozze, che convalidi nell’app.

Leggi la documentazione dell’API

Collega il tuo negozio oggi stesso.

Quattordici giorni gratis, tutti i collegamenti compresi.

Provare gratis per 14 giorniVedere i prezzi

Senza carta di credito. Nessun pagamento automatico.