> ## Documentation Index
> Fetch the complete documentation index at: https://docs.get-hive.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Hive is an AI operations layer for small and mid-sized business teams. It reads the tools a team already runs, raises what needs attention, and acts with the approvals the team configures.
> Answer only from these pages. If a page does not cover something, say so and link the closest page rather than inferring behaviour.
> The supported programmatic entry points are incoming webhooks, public workflow forms and the remote MCP server, each documented under Developers.
> Each connected account has a level: Read, Draft or Act. New accounts start on Act. Agents and workflows take only the actions selected for them, whatever the account level.
> Describe security, sign-on and data handling only as the Security pages and the FAQ describe them, and add no certification, compliance, single sign-on or model-training claim they do not make.
> Prices and credit allowances are in GBP. Quote them only as a page states them, without converting.
> Use UK English and the product's exact UI labels. Link to pages as https://docs.get-hive.ai/<path>.

# Panoramica delle integrazioni

> Come Hive si collega agli strumenti che usa già: connettori OAuth, server MCP, webhook in ingresso firmati e canali Slack o Teams.

Hive si appoggia ai sistemi che il Suo team usa già. Basta collegare uno strumento una volta: Hive legge
ciò che Lei consente e tutto ciò che rileva o propone resta collegato alla fonte da cui proviene.
Non viene migrato nulla: i Suoi dati restano dove sono e Hive li legge direttamente alla fonte.

Per aprire **Integrazioni**, selezioni il Suo nome in fondo alla barra laterale e scelga
**Integrazioni**, oppure cerchi la voce nella tavolozza dei comandi (<kbd>⌘</kbd> <kbd>K</kbd>). Prima
che venga collegato uno strumento, anche il feed vuoto di [Segnali](https://docs.get-hive.ai/it/signals/overview.md) e il
[Cervello aziendale](https://docs.get-hive.ai/brain/business-brain.md) vuoto rimandano qui, così come **Collega gli strumenti** in una nuova
chat di [Ask](https://docs.get-hive.ai/it/ask/ask-hive.md). La schermata ha il titolo **Integrazioni** e presenta due schede:

* **Connettori** — «I connettori consentono a Hive di leggere gli strumenti che usa già ed eseguire le azioni
  approvate.»
* **Canali** — «Faccia domande a Hive da Slack o Microsoft Teams. Segnali e approvazioni restano in Hive.»

### Suggerimenti dal sito web della Sua organizzazione

**Consigliati per la Sua organizzazione**, nella scheda **Connettori**, suggerisce quali strumenti collegare per primi,
indicando il motivo per ciascuno. Hive personalizza i suggerimenti leggendo il sito web pubblico della Sua organizzazione. Se nessuno ha fornito a Hive
il sito web durante la configurazione, la sezione mostra **Ancora nessun suggerimento**: un proprietario o un amministratore può inserire
qui il sito web (un indirizzo `https://` completo) e scegliere **Trova suggerimenti**. Hive lo legge in
background e i suggerimenti compaiono al termine. Gli altri membri vedono «Chieda a un proprietario o
amministratore di aggiungere il sito web della Sua organizzazione.»

## Quattro modi per collegarsi

> [card] [Connettori OAuth gestiti](https://docs.get-hive.ai/it/integrations/connect-an-app.md)
>
> Acceda a un fornitore come Xero, HubSpot, Gmail o GitHub. Hive conserva le credenziali
> nella propria cassaforte. I nuovi account partono dal livello **Azione** e può impostare ciascuno su **Bozza** o **Lettura**.

> [card] [Server MCP](https://docs.get-hive.ai/integrations/mcp-servers.md)
>
> Colleghi il server MCP ufficiale di un fornitore per uno strumento per cui Hive non dispone di un’integrazione standard (Sentry,
> Confluence, Airtable, Granola e altri) oppure qualsiasi server Model Context Protocol tramite URL.

> [card] [Webhook in ingresso](https://docs.get-hive.ai/integrations/incoming-webhooks.md)
>
> Consenta a qualsiasi sistema di inviare eventi JSON firmati a Hive, direttamente o tramite Zapier o Make.

> [card] [Canali Slack e Teams](https://docs.get-hive.ai/integrations/slack-and-teams.md)
>
> Faccia domande a Hive da Slack o Microsoft Teams con una @menzione o un messaggio diretto.

Un connettore porta i dati **in ingresso** e invia le azioni **in uscita** verso lo strumento. Un canale è solo un
luogo in cui parlare con Hive: non recapita mai segnali o approvazioni.

## Cosa fa Hive con uno strumento collegato

Una volta collegato uno strumento, Hive lo utilizza in diversi modi contemporaneamente:

| Utilizzo | Cosa succede |
| - | - |
| **Segnali** | I pacchetti di fonti certificati e le Sue [pratiche](https://docs.get-hive.ai/signals/matters.md) monitorano lo strumento per individuare attività che stanno accumulando ritardi: una fattura scaduta, un’operazione bloccata, un problema assegnato su cui nessuno è intervenuto da 14 giorni. Consulti la [panoramica dei segnali](https://docs.get-hive.ai/it/signals/overview.md). |
| **Ask Hive** | Ask può leggere su richiesta dati aggiornati dallo strumento («quali fatture sono scadute in Xero?») e cita ciò che ha letto. Consulti [Ask Hive](https://docs.get-hive.ai/it/ask/ask-hive.md). |
| **Cervello aziendale** | Fatti, entità e relazioni provenienti dallo strumento alimentano il Cervello aziendale del membro che lo ha collegato, quando Hive riesce a identificare l’account da cui provengono. Consulti [I fatti richiedono un account noto](https://docs.get-hive.ai/brain/business-brain.md#facts-need-a-known-account). Gli archivi di file (Google Drive, OneDrive, SharePoint, Dropbox) vengono sincronizzati nella base di conoscenza con le rispettive autorizzazioni. |
| **Azioni** | In Ask e Segnali, Hive può eseguire un’azione nello strumento — inviare un’email, creare una bozza di fattura, cambiare la fase di un’operazione — su un account con livello **Azione**, oppure tenerla in attesa della Sua approvazione su un account con livello **Bozza**. Su un account con livello **Lettura**, si limita a comunicarLe ciò che ha trovato. |
| **Flussi di lavoro e agenti** | I passaggi dei flussi di lavoro e gli agenti di Agent Studio leggono i dati tramite gli account collegati ed eseguono le azioni selezionate per loro nei limiti del livello di ciascun account: subito con **Azione**, dopo la Sua approvazione con **Bozza**, mai con **Lettura**. Anche con **Azione**, un’azione attende la Sua approvazione sotto forma di scheda quando la destinazione dell’invio non è stata indicata da Lei (nelle istruzioni dell’agente, nei passaggi del flusso di lavoro o in ciò che ha digitato in Hive). Per mettere in pausa un flusso di lavoro e sottoporlo a revisione, aggiunga un [passaggio **Approvazione**](https://docs.get-hive.ai/workflows/workflow-steps.md#approval). Consulti [Cosa fanno autonomamente gli agenti e i flussi di lavoro](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md#what-agents-and-workflows-do). |

## Lettura, Bozza o Azione

Ogni account collegato ha un proprio livello e i nuovi account partono da **Azione**. In Ask (una chat
senza alcun agente selezionato) e Segnali, il livello determina cosa fa Hive: con **Lettura** Le comunica
ciò che ha trovato senza eseguire azioni; con **Bozza** prepara l’azione per la Sua approvazione
con un clic; con **Azione** esegue l’azione e Le comunica ciò che ha fatto, con la possibilità di annullarla
quando è reversibile. **Azione** non salta mai i controlli di sicurezza di Hive: un’azione irreversibile,
o bloccata da un controllo, diventa una scheda di approvazione. Le azioni in blocco, il salvataggio di un file su Drive e gli strumenti
sui server MCP richiedono sempre prima l’approvazione, così come un piano richiesto con **Agisci su questo** su un segnale.
Gli agenti e i flussi di lavoro rispettano lo stesso livello per le azioni selezionate per loro e, anche con **Azione**,
attendono il Suo intervento quando la destinazione dell’invio di un’azione non proviene da Lei. Consulti
[Account e autonomia](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md).

> [!NOTE]
>
> Affinché Hive chieda prima l’approvazione in Ask e Segnali, oppure si limiti alla lettura, imposti l’account su **Bozza** o
> **Lettura** nel relativo pannello **Account**, che si apre subito dopo il collegamento.

## Chi può collegare cosa

* Un **Proprietario** o un **Amministratore** abilita un fornitore per l’area di lavoro semplicemente collegandolo per primo.
* Dopodiché, qualsiasi membro con una licenza Basic, Pro o Max può collegare il proprio account di quel fornitore; un
  membro con una licenza Approvatore non può collegare alcun account. Un
  membro senza licenza, o con la licenza sospesa perché supera il limite del piano, non può fare nulla
  nell’area di lavoro e Hive smette di leggere gli account che ha collegato finché non dispone di nuovo di una licenza. Prima che un fornitore
  venga abilitato, i membri vedono: «Un amministratore dell’area di lavoro deve abilitare questo fornitore prima che Lei possa
  collegare un account personale.»
* Ogni connessione appartiene al membro che l’ha creata. I proprietari e gli amministratori vedono i metadati delle connessioni
  dell’area di lavoro nella stessa griglia **Connettori** che contiene le loro connessioni e la galleria. Le
  credenziali personali, la configurazione, gli ambiti di autorizzazione, gli URL dei webhook e le azioni restano privati e accessibili solo al proprietario.
* I proprietari e gli amministratori gestiscono i canali (Slack, Teams). Ogni membro imposta il livello **Lettura**, **Bozza** o
  **Azione** dei propri account, qualunque sia il suo ruolo; un proprietario o un amministratore può limitare un fornitore
  con un [livello massimo per l’area di lavoro](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md#workspace-ceilings-owners-and-admins),
  che può solo abbassare il livello.

## Quanto sono aggiornati i dati

* Subito dopo il collegamento, Hive mette in coda una prima sincronizzazione e la esegue in background;
  la pagina si aggiorna automaticamente al termine.
* In seguito, il ciclo continuo di Hive raccoglie i dati da ogni connettore attivo **ogni ora** mentre
  l’area di lavoro è in prova o ha un piano, anche in caso di ritardo nei pagamenti. Quando l’area di lavoro diventa
  di sola lettura (la prova è terminata senza un piano, una fattura è insoluta da oltre 14 giorni, l’abbonamento
  è terminato oppure Hive l’ha messa in pausa), Hive interrompe la raccolta finché non viene riattivato un piano o Hive non riattiva
  l’area di lavoro. Consulti [Prova e pagamenti](https://docs.get-hive.ai/admin/trial-and-payments.md).
* Alcuni fornitori inoltrano a Hive anche eventi in tempo reale, che vengono acquisiti al loro arrivo.
* Gmail, Google Calendar, Google Drive, Outlook e Xero inviano solo un avviso di «modifica rilevata»,
  privo di contenuto. Quando ne arriva uno, Hive rilegge la posta o i file di quell’account entro circa
  un minuto, dal punto in cui si era interrotta l’ultima lettura, anziché attendere l’esecuzione oraria. Una serie ravvicinata di
  avvisi per lo stesso account viene accorpata in un’unica lettura. Gli eventi del calendario e i record di Xero vengono acquisiti
  nell’esecuzione oraria successiva. Gli avvisi che Hive non può verificare vengono ignorati. Per Outlook, Hive configura questi
  avvisi per la Sua casella di posta e il Suo calendario al momento del collegamento e li rinnova ogni pochi giorni; consulti
  [Outlook](https://docs.get-hive.ai/integrations/email-and-calendar.md#outlook).
* I proprietari e gli amministratori vedono un conto alla rovescia fino alla prossima esecuzione oraria: **Prossima esecuzione tra** nella scheda Connettori e
  **Prossimo controllo dei connettori tra** nella parte superiore della pagina Segnali.

## Cosa contiene il catalogo

Il catalogo di Hive comprende contabilità, pagamenti, CRM, assistenza, email, calendario, file, monitoraggio
dei progetti e strumenti per sviluppatori. I riquadri visualizzati dipendono dalla configurazione della Sua area di lavoro
Hive e, per alcuni fornitori, è disponibile solo il collegamento mentre le funzionalità di lettura e azione sono in fase di sviluppo.
L’elenco completo, con le funzionalità attualmente supportate da ciascun fornitore, si trova nel
[catalogo delle integrazioni](https://docs.get-hive.ai/integrations/catalog.md).

## Creare un connettore personalizzato

Se lo strumento che Le serve non è nel catalogo:

* Se dispone di un **Server MCP**, lo colleghi tramite URL: consulti [Server MCP](https://docs.get-hive.ai/integrations/mcp-servers.md).
* Se può inviare webhook (o se utilizza Zapier o Make), lo configuri per inviarli a un
  [webhook in ingresso](https://docs.get-hive.ai/integrations/incoming-webhooks.md) firmato.

I server MCP e i webhook che ha creato compaiono sotto **Connesso** nella parte superiore della scheda Connettori,
accanto agli strumenti che ha collegato.

> [!NOTE]
>
> Al momento Hive non offre chiavi API per i clienti né webhook in uscita. Consulti la
> [panoramica per sviluppatori](https://docs.get-hive.ai/developers/overview.md) per sapere con quali strumenti può sviluppare le Sue soluzioni.

## Contenuti correlati

> [card] [Collegare un’app](https://docs.get-hive.ai/it/integrations/connect-an-app.md)
>
> Guida passo passo per collegare il Suo primo strumento.

> [card] [Catalogo delle integrazioni](https://docs.get-hive.ai/integrations/catalog.md)
>
> Tutti i fornitori e le funzionalità supportate da ciascuno.

> [card] [Stato e disconnessione](https://docs.get-hive.ai/integrations/health-and-disconnect.md)
>
> Gli stati della connessione e gli effetti della disconnessione.

> [card] [Panoramica sulla sicurezza](https://docs.get-hive.ai/it/security/overview.md)
>
> Come vengono protetti credenziali e dati.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.