> ## 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>.

# Collegare un’app

> Colleghi uno strumento aziendale a Hive tramite OAuth in pochi clic, con passaggi specifici per le regioni di PostHog e le edizioni di Sage 200.

Collegare uno strumento richiede un minuto. Lei accede al fornitore in una finestra sicura, Hive salva
la connessione nel proprio archivio protetto e inizia a leggere i dati non appena il collegamento è attivo: le prime
risposte possono quindi comparire in pochi istanti.

## Prima di iniziare

* **Proprietari e amministratori** possono collegare qualsiasi fornitore del catalogo. Collegare un fornitore per la
  prima volta lo abilita anche per il resto dell’area di lavoro.
* **Altri membri** possono collegare il proprio account una volta che un proprietario o un amministratore ha abilitato quel
  fornitore e possono usare una connessione solo se il fornitore è abilitato. Consulti
  [Abilitare un fornitore per i membri](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md#enabling-a-provider-for-members).
* Per collegare un account serve una licenza **Pro** o **Max**; una licenza **Approvatore** non consente di collegarne alcuno.
  Segnali monitora gli account dei membri con licenza Max, con una casella email monitorata per licenza Max,
  quella del titolare; gli account dei membri Pro vengono usati per letture in tempo reale in Ask, negli agenti e nei flussi di lavoro.
  Un membro che perde la licenza mantiene le proprie connessioni, ma Hive smette di leggerne i dati finché
  non dispone nuovamente di una licenza. Consulti [Fatturazione e piani](https://docs.get-hive.ai/it/admin/billing-and-plans.md#seats).
* Acceda con un account che abbia accesso ai dati che desidera far usare a Hive. Hive può leggere solo ciò
  che quell’account può leggere.

## Come è organizzata la scheda Connettori

**Integrazioni → Connettori** mostra solo le Sue connessioni, indipendentemente dal Suo ruolo: nemmeno proprietari e
amministratori vedono qui le connessioni dei colleghi. Uno strumento collegato da un collega compare
nella Sua galleria come qualsiasi altro, con **Collega** per aggiungere il Suo account. Dall’alto:

* **I conteggi.** Quanti strumenti ha collegato (attivi) e quanti strumenti sono elencati nei gruppi
  per attività sottostanti (il numero di strumenti in tutti i gruppi, quindi uno strumento già collegato
  non viene più conteggiato qui) e, per proprietari e amministratori, quando Hive controllerà nuovamente gli strumenti
  collegati.
* **Ricerca.** Un unico campo per cercare tra tutti gli strumenti, per nome, categoria, gruppo di attività o URL. I gruppi con
  corrispondenze si aprono e ne indicano il numero; quelli senza corrispondenze vengono nascosti.
* **Richiede attenzione.** Compare solo quando qualcosa richiede il Suo intervento: un Suo account con accesso
  scaduto o non riuscito, oppure un Suo server MCP in errore. Indica l’account specifico, ad
  esempio «Gmail · [old@yourfirm.co.uk](mailto:old@yourfirm.co.uk)», anche quando gli altri Suoi account dello stesso strumento funzionano, e ciascuno
  ha il proprio comando **Ricollega**.
* **Collegati.** Le Sue connessioni in righe compatte, ciascuna con stato, account, ultima sincronizzazione e
  relativi comandi: **Lettura**, **Bozza** o **Azione** (consulti
  [Account e autonomia](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md)), **Account**, **+** per aggiungere
  un altro account e **Disconnetti**. Qui sono elencati anche i Suoi server MCP e i webhook in ingresso.
  Uno strumento collegato più volte (due caselle Gmail, due organizzazioni Xero) occupa una sola
  riga che indica quanti account contiene; la apra per vedere ogni account su una riga distinta, con
  il proprio stato, l’ultima sincronizzazione, l’impostazione **Lettura** / **Bozza** / **Azione**, **Ricollega** e
  **Disconnetti**. **Aggiungi account** sulla riga consente di collegarne un altro. Il conteggio in alto conta
  gli strumenti, non gli account.
* **Consigliati per il Suo studio.** Fino a sei strumenti non ancora collegati, ciascuno con il motivo del suggerimento:
  ciò che Hive ha trovato sul sito del Suo studio, uno strumento diffuso per il Suo tipo di studio o uno strumento che funziona
  con uno già collegato. A una società di venture capital o private equity vengono proposti gli strumenti
  usati dalle società di investimento, come Carta e Datasite, anziché strumenti generici per ufficio come Word o
  Excel. Se non è ancora stata effettuata una ricerca sul sito, un proprietario o un amministratore può aggiungere
  qui il sito; consulti [Consigli dal Suo sito web](https://docs.get-hive.ai/it/integrations/overview.md#recommendations-from-your-website).
* **Esplora per attività.** Tutti gli altri strumenti suddivisi per gruppi di attività, come **Email e calendario**,
  **Contabilità e fiscalità** o **Registri pubblici e dati**. I gruppi sono inizialmente chiusi; selezioni un gruppo per aprirlo
  oppure **Mostra tutto** per aprirli tutti. Hive ricorda quali gruppi ha aperto in questo
  browser. Gli strumenti che non rientrano in alcun gruppo si trovano in **Altri strumenti**. Ogni strumento ha un solo riquadro, indipendentemente dal numero di
  modalità di accesso, e la riga sotto il nome ne indica il tipo, ad esempio
  **Contabilità** o **CRM e vendite**.

## Collegare uno strumento

**1. Aprire Integrazioni**

Selezioni il Suo nome in fondo alla barra laterale, scelga **Integrazioni** e rimanga nella
scheda **Connettori**. Digiti nella casella di ricerca in alto: cerca tutti gli strumenti per nome,
categoria, gruppo di attività o URL e apre i gruppi corrispondenti. In alternativa, apra un gruppo di attività, come
**Contabilità e fisco** o **Messaggistica e telefonia**, per esplorarlo. Consulti
[Come è organizzata la scheda Connettori](#how-the-connectors-tab-is-laid-out).

**2. Scegliere lo strumento**

Selezioni il riquadro del fornitore, poi **Collega**. Hive offre un server MCP solo per gli strumenti per cui
non dispone di un’integrazione standard, quindi quasi tutti gli strumenti si collegano in un solo modo. Linear fa eccezione:
**Collega** offre **OAuth gestito**, **Server MCP Linear** o **Usa il proprio token**, perché al momento Ask
legge Linear tramite il suo server MCP. Consulti
[Strumenti che utilizzano la propria integrazione standard](https://docs.get-hive.ai/integrations/mcp-servers.md#tools-that-use-their-regular-integration).
Per uno strumento non presente nel catalogo, selezioni **Aggiungi integrazione** per aprire **Aggiungi un connettore**.

**3. Accedere e approvare l’accesso**

Si apre una finestra di accesso sicura del fornitore. Acceda e approvi le autorizzazioni richieste.
Hive non vede mai la Sua password.

**4. Attendere la prima sincronizzazione**

Tornando in Hive, vedrà «Outlook collegato. Hive sta leggendo i dati e Lei può iniziare subito a fare
domande.» (con il nome dello strumento) non appena la connessione viene salvata, con **Apri Ask**
per andare alla pagina iniziale di Ask, dove **Preparazione dei dati in corso** mostra la prima lettura. La prima sincronizzazione
prosegue poi in background: al
primo collegamento può richiedere alcuni minuti mentre Hive legge l’account e pianifica cosa
monitorare. La scheda Connettori e Segnali si aggiornano automaticamente al termine. Un nuovo
account inizia con **Azione**: in Ask e Segnali, Hive esegue azioni nell’account e Le comunica ciò che
ha fatto. Scelga **Bozza** per approvare prima ogni azione, oppure **Lettura** affinché Hive si limiti a cercare e
riassumere. Un limite impostato per l’app da un proprietario o amministratore può mantenerne il livello più basso. Consulti
[Account e autonomia](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md).

> [!NOTE]
>
> Se Hive non riesce a raggiungere il proprio fornitore di integrazioni, **Integrazioni** mostra **Impossibile caricare le app
> che è possibile aggiungere** al posto della galleria completa. Gli strumenti collegati continuano a funzionare. Selezioni **Riprova**
> dopo qualche istante. **Aggiungi connessione** in un passaggio di un flusso di lavoro mostra lo stesso messaggio al suo posto.

Se la procedura nella finestra di accesso non si conclude, Hive ne indica il motivo quando possibile, ad esempio un popup bloccato, e
spiega come procedere. Consulti [Se il collegamento non riesce](https://docs.get-hive.ai/integrations/health-and-disconnect.md#if-connecting-fails).

### Collegare da una risposta di Ask

Quando Ask ha tentato di leggere i dati di uno strumento per rispondere alla Sua domanda e Lei non lo ha collegato, la risposta può terminare
con **Collega un’app per rispondere** e un pulsante **Collega** per quello strumento, ad esempio **Collega
HubSpot**. Si apre la stessa finestra di accesso di Integrazioni; una volta collegato lo strumento, ripeta
la domanda. Quando lo strumento richiede prima una scelta, come la regione di PostHog o l’edizione di Sage 200, il
pulsante diventa un link, ad esempio **Collega PostHog in Integrazioni**, che apre questa pagina con la ricerca
impostata sullo strumento, così da consentirLe di effettuare qui la scelta (consulti
[Passaggi specifici per fornitore](#provider-specific-steps)). Solo Lei vede questi pulsanti e Ask propone
**Collega** solo per gli strumenti che un proprietario o un amministratore ha già abilitato per l’area di lavoro. Per uno strumento che la Sua
area di lavoro consente ma non ha abilitato, un proprietario o un amministratore vede invece **Attiva** e il nome dello strumento **in
Integrazioni**, ad esempio **Attiva Calendly in Integrazioni**: il link apre questa pagina con la ricerca
impostata sullo strumento e, collegandolo qui, lo si attiva per l’area di lavoro. Gli altri utenti vedono un messaggio che indica che un proprietario
o un amministratore deve attivarlo prima che possano collegarlo. Ask non propone mai WhatsApp Business, i cui
[termini](https://docs.get-hive.ai/integrations/messaging.md#whatsapp-terms) vengono mostrati da Hive quando lo si collega qui. Un pulsante **Collega**
in Ask non abilita mai uno strumento per l’area di lavoro, nemmeno per un proprietario o un amministratore: se lo strumento è stato
disattivato dopo la stesura della risposta, Hive rifiuta il collegamento con il messaggio «Un amministratore dell’area di lavoro deve abilitare
questo fornitore prima che Lei possa collegare un account personale». Questa funzionalità è in fase di rilascio graduale. Consulti
[Collegare o ricollegare un’app dalla risposta](https://docs.get-hive.ai/it/ask/ask-hive.md#connect-or-reconnect-an-app-from-the-answer).

> [!TIP]
>
> Durante la configurazione iniziale, **Collega il Suo lavoro** collega posta e file insieme. Se si collega solo uno dei
> due, ad esempio Outlook ma non OneDrive, scelga **Continua con Outlook** per proseguire
> con quello e aggiungere l’altro qui in seguito. Ogni strumento sotto **Aggiungi in seguito** completa la configurazione e apre
> questa pagina filtrata sullo strumento. Consulti
> [Collegare il proprio lavoro](https://docs.get-hive.ai/it/get-started/set-up-your-workspace.md#connect-your-work).

## Passaggi specifici per fornitore

> [accordion] PostHog: scelga la regione
>
> PostHog chiede in quale regione si trova il Suo progetto: **EU** (`eu.posthog.com`) o **US**
> (`us.posthog.com`). Scelga quella usata dal Suo account PostHog. Una regione errata rimanda a un
> host diverso, quindi le letture non restituiscono dati. Se Hive non Le ha chiesto la regione quando ha
> collegato PostHog, lo scolleghi e lo ricolleghi affinché la regione venga registrata.

> [accordion] Sage 200: scelga l’edizione
>
> Sage 200 chiede quale edizione utilizza: **Sage 200 Standard Online** o **Sage 200 Professional /
> Extra Online**. Hive rileva il sito e l’azienda dopo l’accesso. L’account con cui accede
> deve disporre dell’accesso all’API di Sage 200 e di **Company Access**; in caso contrario, la connessione viene
> rifiutata con un messaggio che lo segnala.

> [accordion] Xero: autorizzazioni per le fatture
>
> I segnali di Hive relativi alle fatture Xero richiedono l’autorizzazione `accounting.invoices.read` (funziona anche una connessione
> precedente a cui è stata concessa `accounting.transactions.read`). Approvi
> l’accesso richiesto da Xero durante l’accesso; se ha effettuato il collegamento con un accesso più limitato, ricolleghi l’account.

> [accordion] Microsoft 365: un riquadro per ogni servizio
>
> Microsoft 365 si collega tramite riquadri separati, così può concedere solo gli accessi necessari: **Outlook**
> (posta e calendario), **Microsoft Teams** (chat e canali), **OneDrive** e
> **SharePoint Online** (file), e **Microsoft Word** e **Microsoft Excel** (documenti).

> [accordion] Gli strumenti con un’integrazione standard non sono disponibili tramite MCP
>
> Stripe, GitHub, Intercom e Notion si collegano solo tramite la loro integrazione standard; Hive
> offre server MCP per gli strumenti per cui non dispone di un’integrazione standard. Le connessioni MCP create
> in precedenza continuano a funzionare. Consulti [Server MCP](https://docs.get-hive.ai/integrations/mcp-servers.md#tools-that-use-their-regular-integration).

## Collegare più account

Può collegare più account dello stesso fornitore, ad esempio una casella di posta condivisa `billing@`
e la Sua casella personale. Appaiono in un unico riquadro con un pannello **Account**. Ogni account:

* è di proprietà del membro che lo ha collegato;
* ha un proprio livello di autonomia (Lettura, Bozza o Azione);
* occupa una posizione nell’ordine di ripiego, con il principale al primo posto. Proprietari e amministratori possono riordinare gli account.

Ricollegare lo stesso account ripristina la connessione esistente anziché aggiungere un duplicato; vengono sostituiti solo i riquadri
non funzionanti dello stesso account. Consulti [Account e autonomia](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md)
e [Stato e disconnessione](https://docs.get-hive.ai/integrations/health-and-disconnect.md#fix-a-connection).

### Organizzazioni contabili

L’organizzazione contabile della Sua area di lavoro (Xero, QuickBooks, FreeAgent o Sage) conta come un
account collegato. Ogni altra organizzazione contabile che collega è una contabilità cliente: non conta mai
come account collegato aggiuntivo, quindi non è mai necessario acquistare [account collegati aggiuntivi](https://docs.get-hive.ai/it/admin/billing-and-plans.md#add-ons)
per le contabilità dei clienti. Con Starter, le contabilità dei clienti rientrano comunque nel limite di 3 account collegati per licenza Pro
o Max.

Le contabilità dei clienti richiedono il componente aggiuntivo Practice. Finché non sarà in vendita, il collegamento di una seconda organizzazione
contabile verrà rifiutato con un messaggio esplicativo dopo l’accesso, mentre le organizzazioni
contabili già collegate continueranno a funzionare. Se un altro membro collega l’organizzazione della Sua area di lavoro,
o la ricollega, non si tratta di una seconda organizzazione e il collegamento avviene normalmente. Per passare a
un altro fornitore di software contabile, scolleghi prima quello già collegato.
[Ci contatti](https://docs.get-hive.ai/help/support.md) per partecipare alla beta di Practice.

## Dopo il collegamento

* **Segnali**: al ciclo orario successivo Segnali legge i dati dell’account nelle Sue
  [pratiche](https://docs.get-hive.ai/signals/matters.md) e inizia a monitorare ciò che richiede la Sua attenzione.
* **Ask**: può porre subito domande sui dati dello strumento. Hive legge i dati in tempo reale dove possibile e
  cita ciò che ha letto.
* **File e posta**: per un archivio di documenti (Google Drive, Docs, Sheets, OneDrive, Word, Excel,
  SharePoint, Dropbox) o una casella di posta (Gmail, Outlook), Hive inizia subito la lettura anziché
  attendere la sincronizzazione oraria. Legge in blocchi di massimo 500 elementi per circa quattro minuti a
  esecuzione e prosegue per un massimo di altre sei esecuzioni; gli elementi rimanenti vengono elaborati dalla
  normale sincronizzazione oraria. In Ask, **Preparazione dei dati in corso** mostra l’avanzamento. Dopo il primo
  allineamento, Hive sincronizza solo ciò che è cambiato.
* **Azioni**: in Ask e Segnali, è il livello dell’account a decidere. Con **Azione**, Hive esegue l’azione
  e Le comunica ciò che ha fatto; un’azione irreversibile, o bloccata da un controllo di sicurezza,
  richiede comunque prima il Suo consenso. Con **Bozza** attende la Sua approvazione, mentre con **Lettura** Le comunica solo
  ciò che ha trovato. Un agente o un flusso di lavoro segue lo stesso livello e lo stesso limite per le azioni selezionate
  per esso e, anche con **Azione**, attende la Sua approvazione quando la destinazione di un invio non è stata indicata
  da Lei.
  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).

> [!TIP]
>
> Non vede ciò che si aspettava? Il riquadro mostra quando Hive ha eseguito l’ultima sincronizzazione e quanti file ed
> email ha letto. Se mostra **Disconnesso** o **È necessario ricollegare**, selezioni
> **Ricollega**. Consulti [Stato e disconnessione](https://docs.get-hive.ai/integrations/health-and-disconnect.md).

## Argomenti correlati

> [card] [Catalogo delle integrazioni](https://docs.get-hive.ai/integrations/catalog.md)
>
> Le funzionalità supportate da ciascun fornitore.

> [card] [Account e autonomia](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md)
>
> Lettura, Bozza e Azione per ogni account.


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