Chiama il tuo CRM dal tuo codice

L'API Builder è semplice HTTPS e JSON su mcp.workspace369.com/v1, autenticata con un token di accesso personale. POST /v1/tools/{name} esegue qualsiasi strumento MCP consentito dagli scope del tuo token, e le scorciatoie REST coprono clienti, proposte, fatture, contratti, progetti, attività, richieste ed eventi del calendario. La sua specifica OpenAPI è pubblica su /v1/openapi.json. I webhook inviano 27 eventi al tuo endpoint, firmati con HMAC-SHA256. Entrambi sono inclusi in ogni piano da Cadet; una prova ottiene l'accesso una volta salvata una carta.

Inizia gratis

Prova gratuita di 14 giorni. Carta richiesta. Dopo la prova: da $29/mese. Si rinnova automaticamente ogni mese finché non annulli. Annulla in qualsiasi momento in Impostazioni → Fatturazione.

Richiedi una demo

Ogni piano da Cadet; una prova ottiene l'accesso una volta salvata una carta.

AI/Connessioni AIAI/Connessioni AI/Approvazioni

Token di accesso personaliToken per script o agenti AI che si connettono tramite MCP senza accesso al browser.

Un token concede le autorizzazioni scelte a qualsiasi client che lo presenta. Trattalo come una password: viene mostrato una sola volta, al momento della creazione.Crea token

I tuoi token

Nessun token ancoraCreane uno per connettere uno script o un agente.

Accesso

Consenti connessioni AIQuando attivo, i membri possono collegare app AI a questo spazio di lavoro.

Token di accesso personaliToken per script o agenti AI che si connettono tramite MCP senza accesso al browser.

Un token concede le autorizzazioni scelte a qualsiasi client che lo presenta. Trattalo come una password: viene mostrato una sola volta, al momento della creazione.Crea token

I tuoi token

Sincronizzazione fatturemai utilizzato · scade 21 gen 20274 autorizzazioniRevoca

Invia senza chiedereFatture, email, messaggi e contratti attendono la tua approvazione.

Accesso

Consenti connessioni AIQuando attivo, i membri possono collegare app AI a questo spazio di lavoro.

Approvazioni

Le mie richiesteTutti

In attesa di te

Invia fattura #INV-1042 per Juniper Bakery via emailUn token di accesso personale · 2 min faIn attesa

Invia via email la proposta "Rinnovo menu primaverile" al clienteUn token di accesso personale · 14 min faIn attesa

Recenti

Invia fattura #INV-1038 per Orchard Dental via emailApprovato da te · ieriFatto

Invia fattura #INV-1031 per Harbour Yoga via emailRifiutato da te · 3 giorni faRifiutato

Approvazioni

Le mie richiesteTutti

In attesa di te

Invia via email la proposta "Rinnovo menu primaverile" al clienteUn token di accesso personale · 14 min faIn attesa

Recenti

Invia fattura #INV-1042 per Juniper Bakery via emailApprovato da te · appena oraFatto

Invia fattura #INV-1038 per Orchard Dental via emailApprovato da te · ieriFatto

Invia fattura #INV-1031 per Harbour Yoga via emailRifiutato da te · 3 giorni faRifiutato

1 richiesta approvata

Crea token di accesso personaleLimitato al tuo spazio di lavoro corrente. Il token viene mostrato una sola volta.

Sincronizzazione fatture

Permessi4 selezionati

workspace:readclients:readclients:writeinvoices:readinvoices:writeproposals:readproposals:writecontracts:readcontracts:writecontracts:sendprojects:readprojects:writetasks:readtasks:writecalendar:readcalendar:writenotes:readnotes:writetime_entries:readtime_entries:writeproducts:readproducts:writereminders:readreminders:writeinbox:readinbox:sendteam:readteam:writerequests:readrequests:writeautomations:readautomations:write

Trigger di automazione

Consente a Zapier, Make e n8n di avviare le tue automazioni quando succede qualcosa.

webhooks:manage

Scadenza

30 giorni90 giorni1 annoNessuna scadenza

Crea tokenAnnulla

Connessioni AI

Token di accesso personali

Un token concede le autorizzazioni scelte a qualsiasi client che lo presenta. Trattalo come una password: viene mostrato una sola volta, al momento della creazione.Crea token

I tuoi token

Nessun token ancoraCreane uno per connettere uno script o un agente.

Accesso

Consenti connessioni AIQuando attivo, i membri possono collegare app AI a questo spazio di lavoro.

Connessioni AI

Token di accesso personali

Un token concede le autorizzazioni scelte a qualsiasi client che lo presenta. Trattalo come una password: viene mostrato una sola volta, al momento della creazione.Crea token

I tuoi token

Sincronizzazione fatturemai utilizzato · scade 21 gen 20274 autorizzazioni

Invia senza chiedereFatture, email, messaggi e contratti attendono la tua approvazione.

Accesso

Consenti connessioni AIQuando attivo, i membri possono collegare app AI a questo spazio di lavoro.

Approvazioni

Le mie richiesteTutti

In attesa di te

Invia fattura #INV-1042 per Juniper Bakery via emailUn token di accesso personale · 2 min faIn attesa

Invia via email la proposta "Rinnovo menu primaverile" al clienteUn token di accesso personale · 14 min faIn attesa

Recenti

Invia fattura #INV-1038 per Orchard Dental via emailApprovato da te · ieriFatto

Invia fattura #INV-1031 per Harbour Yoga via emailRifiutato da te · 3 giorni faRifiutato

Approvazioni

Le mie richiesteTutti

In attesa di te

Invia via email la proposta "Rinnovo menu primaverile" al clienteUn token di accesso personale · 14 min faIn attesa

Recenti

Invia fattura #INV-1042 per Juniper Bakery via emailApprovato da te · appena oraFatto

Invia fattura #INV-1038 per Orchard Dental via emailApprovato da te · ieriFatto

Invia fattura #INV-1031 per Harbour Yoga via emailRifiutato da te · 3 giorni faRifiutato

Crea token di accesso personaleLimitato al tuo spazio di lavoro corrente. Il token viene mostrato una sola volta.

Sincronizzazione fatture

Permessi4 selezionati

Crea tokenAnnulla

01: 8 risorse con 32 operazioni, più POST /v1/tools/{name} per qualsiasi strumento MCP consentito dagli scope del tuo token.
02: L'invio di una fattura, preventivo, contratto o messaggio restituisce 202 e attende l'approvazione nell'app.
03: 27 eventi webhook firmati, con fino a 6 tentativi di consegna.

Cos'è un'API CRM?

Un'API CRM consente al tuo codice di leggere e aggiornare i record CRM su Internet invece che tramite l'app. L'API Builder di Workspace369 è semplice HTTPS e JSON su mcp.workspace369.com/v1, autenticata con un token di accesso personale. POST /v1/tools/{name} esegue qualsiasi strumento MCP consentito dagli scope del tuo token, e le scorciatoie REST coprono clienti, proposte, fatture, contratti, progetti, attività, richieste ed eventi del calendario. L'invio di una fattura, proposta, contratto o messaggio restituisce un 202 e attende l'approvazione nell'app Workspace369, a meno che l'opzione Invia senza chiedere del token sia attiva. I webhook firmati inviano 27 eventi al tuo endpoint quando il lavoro cambia.

Riferimento prodotto

Revisionato il 4 novembre 2026 dal Team di Prodotto Workspace369. La disponibilità può variare in base al piano, alla regione e alla configurazione dell'area di lavoro.

Leggi la documentazione dell'API Builder

HTTP semplice, risposte reali, rifiuti chiari.

Ogni strumento è una chiamata HTTP: POST /v1/tools/{name} esegue qualsiasi strumento MCP consentito dagli ambiti del tuo token, e le scorciatoie REST coprono clienti, proposte, fatture, contratti, progetti, attività, richieste ed eventi di calendario. Scegli una chiamata per vedere cosa ritorna.

Autentica con un token di accesso personale: Authorization: Bearer mcp_pat_…
8 risorse con 32 operazioni, più POST /v1/tools/{name} per qualsiasi strumento MCP consentito dagli scope del tuo token
Una forma di errore per ogni rifiuto, con un codice su cui il tuo codice può ramificarsi

Apri la specifica OpenAPI Leggi la guida API Builder

Richiesta

GET /v1/clients?query=acme&limit=5

Authorization: Bearer mcp_pat_••••

Risposta

200 OK

{
  "clients": [
    { "id": "cl_93Fa", "name": "Acme Co",
      "email": "billing@acme.test", "lifecycle_stage": "client" }
  ]
}

Le letture tornano subito. Pagina dei risultati con un cursore.

Richiesta

POST /v1/invoices

Authorization: Bearer mcp_pat_••••

{ "client_id": "cl_93Fa",
  "line_items": [{ "description": "October retainer",
                   "unit_price": 1850 }] }

Risposta

200 OK

{
  "invoice": { "id": "inv_7Qm2", "number": "26-14",
               "status": "Draft", "total": 1850 },
  "deduped": false
}

Una bozza viene creata subito e registrata, pronta per la revisione del tuo team.

Richiesta

POST /v1/invoices/inv_7Qm2/send

Authorization: Bearer mcp_pat_••••

Risposta

202 Accepted

{
  "held_for_approval": true,
  "approval_id": "apr_K81x",
  "approval_url": "https://app.workspace369.com/settings/approvals/apr_K81x",
  "approval_expires_at": "2026-10-21T16:00:00Z"
}

In attesa di approvazione: nulla viene inviato finché una persona non lo approva nell'app, a meno che il token non abbia l'opzione "Invia senza chiedere" attivata. La richiesta scade dopo un'ora.

Una forma di errore, codici su cui puoi ramificare.

Ogni rifiuto restituisce { "error": { "code", "message", "details" } } con uno stato su cui il tuo codice può agire.

Codici di errore dell'API Builder
Codice	Stato	Cosa significa
unauthorized	401	Il token di accesso personale non è valido o mancante.
usage_exhausted	402	Lo spazio di lavoro ha utilizzato il suo utilizzo mensile dell'IA. Ricarica e riprova.
plan_required	403	Lo spazio di lavoro non ha ancora un piano. La risposta contiene un link per l'aggiornamento.
insufficient_scope	403	Al token manca uno scope. details.required_scope lo nomina.
payload_too_large	413	Il corpo della richiesta supera 1 MB.
rate_limited	429	Oltre il limite. Attendi l'header Retry-After, quindi riprova.

Scegli gli eventi. Verifica ogni consegna.

In Impostazioni, sotto Dati, scegli Webhook e Nuovo webhook, scegli tra 27 eventi e copia il segreto di firma una volta. Ogni consegna è un JSON POST firmato.

Firmato: X-Webhook-Signature è un HMAC-SHA256 del corpo grezzo più X-Webhook-Timestamp, creato con il tuo segreto di firma. Ruota il segreto in qualsiasi momento.
Ritentato: Rispondi con un 2xx entro 10 secondi. Altrimenti la consegna viene ritentata fino a 5 volte in più, per un totale di 6 tentativi, con lo stesso X-Webhook-Id. Le consegne vengono registrate per 30 giorni.
Sicuro da ripetere: Le consegne possono arrivare fuori ordine o più volte, quindi salta qualsiasi X-Webhook-Id che hai già gestito. Le consegne webhook non utilizzano l'AI.

Leggi il riferimento webhooks

New webhookCreate webhook

Endpoint

Endpoint URLhttps://api.northwind.test/hooks/w369ActivePause to stop deliveries without deleting the webhook.

Events4 selected

Choose which events this endpoint receives.

Time entriesCreatedUpdatedDeleted

TimesheetsSubmittedApprovedRejected

InvoicesCreatedPaidPaidStatus changed

ProposalsSentAcceptedAcceptedDeclined

ContractsSentRecipient completedCompletedCompletedDeclinedVoidedExpired

BookingsCreatedRescheduledCancelledNo show

ClientsCreatedStage changed

RequestsCreatedCreatedConvertedArchived

Cosa riceve il tuo endpoint

POST /hooks/w369

X-Webhook-Id: 7c41e0b9…

X-Webhook-Timestamp: 1792594800000

X-Webhook-Signature: 5d2a9f3c…

"event_type": "invoice.paid",
"entity_id": "inv_7Qm2",
"data": { "invoice_status": "Paid", "balance_due": 0 }

200 OK

Scegli gli eventi di cui hai bisogno.

27 eventi arrivano in 8 famiglie. Iscriviti a quelli che ti servono, fino a 50 webhook per workspace. La gestione dei webhook richiede il permesso Gestisci webhook.

Eventi webhook per famiglia
Famiglia	Eventi
Voci di tempo	time_entry.created, time_entry.updated, time_entry.deleted
Timesheet	timesheet.submitted, timesheet.approved, timesheet.rejected
Fatture	invoice.created, invoice.paid, invoice.status_changed
Proposte	proposal.sent, proposal.accepted, proposal.declined
Contratti	contract.sent, contract.recipient_completed, contract.completed, contract.declined, contract.voided, contract.expired
Prenotazioni	booking.created, booking.rescheduled, booking.cancelled, booking.no_show
Richieste	lead.created, lead.converted, lead.archived
Clienti	client.created, client.stage_changed

Invia email dal codice e collega i tuoi strumenti di automazione.

L'API Email è un endpoint di solo invio con la propria chiave di workspace. L'app Workspace369 per Zapier (beta; iscriviti con il link di invito nella pagina Zapier) avvia Zap da essi, e Make e n8n ascoltano gli stessi webhook firmati.

Create personal access token

Scoped to your current workspace. The token is shown once.

Invoice sync

Permissions4 selected

workspace:readworkspace:readclients:readclients:readclients:writeinvoices:readinvoices:readinvoices:writeinvoices:writeproposals:readproposals:writecontracts:readcontracts:writecontracts:sendprojects:readprojects:write

Expiry

30 days90 days90 days1 yearNo expiry

CancelCreate token

Token created

Copy this now. You won't be able to see it again.

mcp_pat_••••••••••••••••Copy token

Token con limiti scelti da te, e nulla di nascosto.

Una volta che un amministratore attiva le connessioni AI, puoi creare un token di accesso personale in Impostazioni, sotto AI. Trasporta solo gli ambiti e la scadenza che scelgono, e lo spazio di lavoro può vederlo e bloccarlo.

Mai più del suo creatore: Ogni chiamata viene controllata in tempo reale rispetto al ruolo del membro, quindi un token non può fare ciò che il suo creatore non può.
Ogni chiamata viene registrata: Il registro chiamate registra l'app, il membro, lo strumento, l'ambito, l'esito e l'utilizzo dell'IA. Conserva i nomi dei campi, mai i valori.
Gli amministratori possono revocare qualsiasi token: Gli amministratori dello spazio di lavoro vedono i token di ogni membro. Un token revocato smette immediatamente di funzionare.
Un ritmo costante: Fino a 120 chiamate al minuto per token e 600 per spazio di lavoro, condivise con MCP, con un corpo della richiesta di 1 MB. Oltre il limite ricevi un 429 con Retry-After.

L'API e i webhook su ogni piano, da Cadet.

L'API Builder su mcp.workspace369.com/v1 e i webhook firmati sono inclusi in ogni piano da Cadet. Una prova ottiene l'accesso una volta salvata una carta. Ogni chiamata riuscita utilizza lo stesso utilizzo dell'IA della chiamata MCP corrispondente.

Confronta piani

strumenti sul server: 127
eventi webhook: 27
chiamate al minuto per token: 120

Piani	Cadet$29/mese	Voyager$74/mese	Specialist$149/mese	Commander$299/mese	Enterprise$699/mese
API Builder	Ogni piano	Incluso	Incluso	Incluso	Incluso	Incluso
Webhooks	Ogni piano	Incluso	Incluso	Incluso	Incluso	Incluso
Connessioni IA (MCP)	Ogni piano	Incluso	Incluso	Incluso	Incluso	Incluso

Le chiamate fallite o rifiutate non utilizzano l'AI.

Domande su API Builder e Webhook

Quali piani includono l'API Builder?

Ogni piano da Cadet e una prova gratuita ottengono l'accesso una volta salvata una carta in Fatturazione. Un proprietario o amministratore deve aver attivato Consenti connessioni AI in Impostazioni, sotto AI. I webhook sono inclusi anche in ogni piano da Cadet.#

La prova gratuita include l'API?

Sì, una volta salvata una carta. La prova di 14 giorni ha quindi l'API Builder e i webhook come qualsiasi piano.#

Come mi autentico?

Crea un token di accesso personale in Impostazioni, sotto AI, con Crea token. Scegli i suoi permessi e la scadenza (30 giorni, 90 giorni, 1 anno o nessuno), copialo una volta e invialo come Authorization: Bearer mcp_pat_... su ogni richiesta. Ogni chiamata viene controllata rispetto ai permessi attivi del membro che l'ha creata e agli ambiti del token.#

Dove si trova la specifica OpenAPI?

È pubblico, senza token, all'indirizzo /v1/openapi.json sullo stesso host. È costruito dal registro strumenti live, quindi corrisponde a ciò che il server accetta.#

Come verifico un webhook?

Ogni consegna contiene X-Webhook-Signature, X-Webhook-Timestamp e X-Webhook-Id. La firma è un HMAC-SHA256 esadecimale del corpo della richiesta grezza seguito dal timestamp, creato con il tuo segreto di firma. Rispondi con un 2xx entro 10 secondi; le consegne fallite vengono ritentate fino a 5 volte in più, e X-Webhook-Id rimane lo stesso ad ogni tentativo.#

Le chiamate API utilizzano l'utilizzo dell'AI?

Sì. Ogni chiamata riuscita utilizza la stessa AI del corrispondente chiamata MCP, dall'indennità mensile del piano. Le chiamate fallite o rifiutate non usano nulla, e le consegne webhook non usano nulla.#

Devo usare l'API o MCP?

Usa l'API Builder quando il tuo codice o uno script effettua le chiamate. Usa il server MCP quando un'app AI come Claude o ChatGPT le effettua. Entrambi eseguono gli stessi strumenti con le stesse autorizzazioni, approvazioni, limiti di frequenza e registro di controllo.#

Indirizza il tuo codice a uno spazio di lavoro dove gli invii attendono un "sì" per impostazione predefinita.

Avvia una prova, salva una carta, crea un token di accesso personale nelle Impostazioni ed effettua la tua prima chiamata.

Inizia gratis Richiedi una demo

Prova gratuita di 14 giorni. Carta richiesta. Dopo la prova: da $29/mese. Si rinnova automaticamente ogni mese finché non annulli. Annulla in qualsiasi momento in Impostazioni → Fatturazione.

Vedi i prezzi

Inizia gratis Richiedi una demo

14 giorni gratuiti · carta richiesta · poi $29/mese · cancella in qualsiasi momento