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

# Conectar um aplicativo

> Conecte uma ferramenta de negócios ao Hive via OAuth em poucos cliques, com etapas específicas para regiões do PostHog e edições do Sage 200.

Conectar uma ferramenta leva um minuto. Você entra na conta do provedor em uma janela segura, o Hive armazena
a conexão no cofre e começa a ler assim que você se conecta — para que as primeiras
respostas possam aparecer em instantes.

## Antes de começar

* **Proprietários e administradores** podem conectar qualquer provedor do catálogo. Conectar um provedor pela
  primeira vez também o habilita para o restante do espaço de trabalho.
* **Outros membros** podem conectar a própria conta depois que um proprietário ou administrador habilitar esse
  provedor, e só podem usar uma conexão com um provedor habilitado. Consulte
  [Habilitar um provedor para membros](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md#enabling-a-provider-for-members).
* Conectar uma conta exige uma licença **Pro** ou **Max**; uma licença **Aprovador** não permite conectar contas.
  Os sinais monitoram as contas de membros com licença Max, com uma caixa de e-mail monitorada por licença Max,
  a do próprio titular; as contas de membros Pro são usadas para leituras em tempo real no Ask, em agentes e em fluxos de trabalho.
  Um membro que perde a licença mantém suas conexões, mas o Hive para de lê-las até que
  ele tenha uma licença novamente. Consulte [Faturamento e planos](https://docs.get-hive.ai/pt-br/admin/billing-and-plans.md#seats).
* Entre com uma conta que tenha acesso aos dados que você quer que o Hive use. O Hive só pode ler o que
  essa conta pode ler.

## Como a aba Conectores está organizada

**Integrações → Conectores** mostra apenas suas próprias conexões, independentemente da sua função: proprietários e
administradores também não veem as conexões de colegas aqui. Uma ferramenta que um colega conectou aparece na
galeria para você como qualquer outra, com **Conectar** para adicionar sua própria conta. De cima para baixo:

* **As contagens.** Quantas ferramentas você tem conectadas (ativas) e quantas ferramentas os grupos
  por atividade abaixo listam (o número de ferramentas em todos os grupos, de modo que uma ferramenta conectada
  deixa de ser contada ali) e, para proprietários e administradores, quando o Hive verificará novamente suas ferramentas
  conectadas.
* **Busca.** Um único campo que busca em todas as ferramentas por nome, categoria, grupo de atividades ou URL. Os grupos com
  resultados se abrem e informam quantos foram encontrados; os grupos sem resultados ficam ocultos.
* **Precisa de atenção.** Aparece apenas quando algo precisa de você: uma conta sua cujo login
  expirou ou falhou, ou um servidor MCP seu com erro. Identifica a conta exata, como
  “Gmail · [old@yourfirm.co.uk](mailto:old@yourfirm.co.uk)”, mesmo quando suas outras contas dessa ferramenta estão funcionando, e cada
  uma tem seu próprio botão **Reconectar**.
* **Conectados.** Suas conexões em linhas compactas, cada uma com status, conta, última sincronização e
  controles: **Ler**, **Rascunho** ou **Agir** (consulte
  [Contas e autonomia](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md)), **Contas**, **+** para adicionar
  outra conta e **Desconectar**. Seus servidores MCP e webhooks de entrada também são listados
  aqui. Uma ferramenta conectada mais de uma vez (duas caixas de e-mail do Gmail, duas organizações do Xero) ocupa uma
  linha que informa quantas contas tem; abra-a para ver cada conta em sua própria linha, com
  status, última sincronização, configuração **Ler** / **Rascunho** / **Agir**, **Reconectar** e
  **Desconectar** próprios. **Adicionar conta** na linha conecta mais uma. A contagem no topo conta
  ferramentas, não contas.
* **Recomendados para sua empresa.** Até seis ferramentas que você ainda não conectou, cada uma com o motivo da recomendação:
  o que o Hive encontrou no site da sua empresa, uma ferramenta comum para seu tipo de empresa ou uma ferramenta que funciona
  com outra que você já conectou. Para uma empresa de venture capital ou private equity, são oferecidas as ferramentas
  usadas por empresas de investimento, como Carta e Datasite, em vez de ferramentas gerais de escritório, como Word ou
  Excel. Se ainda não houver pesquisa do site, um proprietário ou administrador pode adicionar o
  site aqui; consulte [Recomendações a partir do seu site](https://docs.get-hive.ai/pt-br/integrations/overview.md#recommendations-from-your-website).
* **Explorar por atividade.** Todas as demais ferramentas em grupos por atividade, como **E-mail e calendário**,
  **Contabilidade e tributos** ou **Registros públicos e dados**. Os grupos começam fechados; selecione um grupo para
  abri-lo ou **Mostrar tudo** para abrir todos. O Hive lembra quais grupos você abriu neste
  navegador. As ferramentas que não se encaixam em nenhum grupo ficam em **Outras ferramentas**. Cada ferramenta tem um bloco, independentemente de quantas
  formas de login ofereça, e a linha abaixo do nome informa o tipo de ferramenta, como
  **Contabilidade** ou **CRM e vendas**.

## Conecte uma ferramenta

**1. Abra Integrações**

Selecione seu nome na parte inferior da barra lateral, escolha **Integrações** e permaneça na
aba **Conectores**. Digite na caixa de pesquisa no topo: ela pesquisa todas as ferramentas por nome,
categoria, grupo de atividades ou URL e abre os grupos correspondentes. Ou abra um grupo de atividades, como
**Contabilidade e tributos** ou **Mensagens e telefonia**, para explorá-lo. Consulte
[Como a aba Conectores está organizada](#how-the-connectors-tab-is-laid-out).

**2. Escolha a ferramenta**

Selecione o bloco do provedor e depois **Conectar**. O Hive oferece um servidor MCP apenas para ferramentas sem
integração regular, então quase todas as ferramentas têm uma única forma de conexão. O Linear é a exceção:
**Conectar** oferece **OAuth gerenciado**, **Servidor MCP do Linear** ou **Usar seu token**, pois o Ask
lê o Linear pelo servidor MCP por enquanto. Consulte
[Ferramentas que usam sua integração regular](https://docs.get-hive.ai/integrations/mcp-servers.md#tools-that-use-their-regular-integration).
Para uma ferramenta que não está no catálogo, selecione **Adicionar integração** para abrir **Adicionar um conector**.

**3. Faça login e aprove o acesso**

Uma janela segura de login do provedor é aberta. Faça login e aprove o acesso solicitado.
O Hive nunca vê sua senha.

**4. Deixe a primeira sincronização ocorrer**

De volta ao Hive, você vê “Outlook conectado. O Hive está lendo os dados agora, e você já pode começar a fazer
perguntas.” (com o nome da ferramenta) assim que a conexão é salva, com **Abrir Ask**
para ir à página inicial do Ask, onde **Preparando seus dados** mostra a primeira leitura. A primeira sincronização
então ocorre em segundo plano — na
primeira conexão, pode levar alguns minutos enquanto o Hive lê a conta e planeja o que
monitorar — e a aba Conectores e Sinais são atualizados automaticamente quando ela termina. Uma nova
conta começa em **Agir**: no Ask e em Sinais, o Hive executa ações nela e informa o que
fez. Escolha **Rascunho** para aprovar cada ação antes da execução, ou **Ler** para que o Hive apenas pesquise e
resuma. Um limite definido por um proprietário ou administrador para o aplicativo pode manter o nível mais baixo. Consulte
[Contas e autonomia](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md).

> [!NOTE]
>
> Se o Hive não conseguir acessar seu provedor de integração, **Integrações** mostra **Não foi possível carregar os aplicativos
> que você pode adicionar** em vez da galeria completa. Suas ferramentas conectadas continuam funcionando. Selecione **Tentar novamente**
> após alguns instantes. **Adicionar conexão** em uma etapa de fluxo de trabalho mostra a mesma mensagem no próprio local.

Se o processo na janela de login não for concluído, o Hive informa o motivo quando possível, como um pop-up bloqueado, e
qual é o próximo passo. Consulte [Se a conexão falhar](https://docs.get-hive.ai/integrations/health-and-disconnect.md#if-connecting-fails).

### Conecte a partir de uma resposta do Ask

Quando o Ask tenta ler dados de uma ferramenta para responder à sua pergunta e você ainda não a conectou, a resposta pode terminar
com **Conectar um aplicativo para responder a esta pergunta** e um botão **Conectar** para essa ferramenta, como **Conectar
HubSpot**. Ele abre a mesma janela de login de Integrações; depois de conectar a ferramenta, faça a pergunta
novamente. Quando a ferramenta exige uma escolha prévia, como a região do PostHog ou a edição do Sage 200, o
botão se torna um link, como **Conectar PostHog em Integrações**, que abre esta página com a busca
pela ferramenta para que você possa fazer essa escolha aqui (consulte
[Etapas específicas por provedor](#provider-specific-steps)). Só você vê esses botões, e o Ask oferece
**Conectar** apenas para ferramentas que um proprietário ou administrador já habilitou para o espaço de trabalho. Para uma ferramenta que seu
espaço de trabalho permite, mas ainda não habilitou, um proprietário ou administrador vê **Ativar** e o nome da ferramenta **em
Integrações**, como **Ativar Calendly em Integrações**: isso abre esta página com a busca
pela ferramenta, e conectá-la aqui a ativa para o espaço de trabalho. As demais pessoas veem que um proprietário
ou administrador precisa ativá-la antes que possam conectá-la. O Ask nunca oferece WhatsApp Business, cujos
[termos](https://docs.get-hive.ai/integrations/messaging.md#whatsapp-terms) o Hive exibe quando você o conecta aqui. Um botão **Conectar**
no Ask nunca habilita uma ferramenta para o espaço de trabalho, nem mesmo para um proprietário ou administrador: se a ferramenta tiver sido
desativada após a resposta ser escrita, o Hive recusa a conexão com a mensagem “Um administrador do espaço de trabalho precisa habilitar
este provedor antes que você possa conectar uma conta pessoal.” Esse recurso está sendo disponibilizado gradualmente. Consulte
[Conecte ou reconecte um aplicativo a partir da resposta](https://docs.get-hive.ai/pt-br/ask/ask-hive.md#connect-or-reconnect-an-app-from-the-answer).

> [!TIP]
>
> Na configuração inicial, **Conectar seu trabalho** conecta e-mails e arquivos em conjunto. Se apenas um dos
> dois for conectado, por exemplo, Outlook, mas não OneDrive, escolha **Continuar com Outlook** para prosseguir
> com ele e adicionar o outro aqui depois. Cada ferramenta em **Adicionar depois** conclui a configuração e abre
> esta página filtrada para ela. Consulte
> [Conecte seu trabalho](https://docs.get-hive.ai/pt-br/get-started/set-up-your-workspace.md#connect-your-work).

## Etapas específicas de cada provedor

> [accordion] PostHog: escolha sua região
>
> O PostHog pergunta em qual região seu projeto está: **EU** (`eu.posthog.com`) ou **US**
> (`us.posthog.com`). Escolha a região usada pela sua conta do PostHog. A região errada aponta para um
> host diferente, por isso as leituras não retornam dados. Se o Hive não perguntou sua região quando você
> conectou o PostHog, desconecte e conecte novamente para que a região seja registrada.

> [accordion] Sage 200: escolha sua edição
>
> O Sage 200 solicita sua edição: **Sage 200 Standard Online** ou **Sage 200 Professional /
> Extra Online**. O Hive identifica seu site e sua empresa depois que você faz login. A conta usada para
> entrar precisa de acesso à API do Sage 200 e de **Company Access**; sem eles, a conexão é
> recusada com uma mensagem informando o motivo.

> [accordion] Xero: permissões de faturas
>
> Os sinais de faturas do Xero no Hive precisam da permissão `accounting.invoices.read` (uma conexão
> antiga com a permissão `accounting.transactions.read` também funciona). Aprove o
> acesso solicitado pelo Xero durante o login; se você conectou com acesso mais restrito, reconecte.

> [accordion] Microsoft 365: um bloco por serviço
>
> O Microsoft 365 se conecta em blocos separados para que você conceda exatamente o acesso necessário: **Outlook**
> (e-mail e calendário), **Microsoft Teams** (chats e canais), **OneDrive** e
> **SharePoint Online** (arquivos), e **Microsoft Word** e **Microsoft Excel** (documentos).

> [accordion] Ferramentas com integração própria não são oferecidas via MCP
>
> Stripe, GitHub, Intercom e Notion se conectam apenas pela integração própria; o Hive
> oferece servidores MCP para ferramentas sem integração própria. Uma conexão MCP feita
> anteriormente continua funcionando. Consulte [Servidores MCP](https://docs.get-hive.ai/integrations/mcp-servers.md#tools-that-use-their-regular-integration).

## Conecte mais de uma conta

Você pode conectar várias contas do mesmo provedor — por exemplo, uma caixa de e-mail compartilhada `billing@`
e sua própria caixa de entrada. Elas aparecem em um único bloco com um painel **Contas**. Cada conta:

* pertence ao membro que a conectou;
* tem seu próprio nível de autonomia (Ler, Rascunho ou Agir);
* ocupa uma posição na ordem de contingência, com a principal primeiro. Proprietários e administradores podem reordenar as contas.

Reconectar a mesma conta repara a conexão existente em vez de adicionar uma duplicata; apenas os blocos com falha
da mesma conta são substituídos. Consulte [Contas e autonomia](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md)
e [Integridade e desconexão](https://docs.get-hive.ai/integrations/health-and-disconnect.md#fix-a-connection).

### Organizações contábeis

A organização contábil do seu próprio espaço de trabalho (Xero, QuickBooks, FreeAgent ou Sage) conta como uma
conta conectada. Qualquer outra organização contábil que você conectar é um livro contábil de cliente: ela nunca conta
como uma conta conectada extra, então você nunca precisa comprar [contas conectadas extras](https://docs.get-hive.ai/pt-br/admin/billing-and-plans.md#add-ons)
para livros contábeis de clientes. No Starter, os livros contábeis de clientes ainda contam para o limite de 3 contas conectadas por licença Pro
ou Max.

Os livros contábeis de clientes precisam do complemento Practice. Enquanto ele não estiver à venda, a conexão de uma segunda organização
contábil será recusada com uma mensagem informando o motivo após você fazer login nela, e as organizações
contábeis já conectadas continuarão funcionando. Se outro membro conectar a organização do próprio espaço de trabalho,
ou reconectá-la, isso não será considerado uma segunda organização e a conexão ocorrerá normalmente. Para mudar de
provedor contábil, desconecte primeiro o que já está conectado.
[Entre em contato](https://docs.get-hive.ai/help/support.md) para participar do beta do Practice.

## Depois de conectar

* **Sinais**: no próximo ciclo de sincronização por hora, Sinais lê os dados da conta e os incorpora aos seus
  [casos](https://docs.get-hive.ai/signals/matters.md), passando a monitorar o que precisa de você.
* **Ask**: você pode perguntar sobre os dados da ferramenta imediatamente. O Hive lê os dados em tempo real quando possível e
  cita o que leu.
* **Arquivos e e-mails**: para um repositório de documentos (Google Drive, Docs, Sheets, OneDrive, Word, Excel,
  SharePoint, Dropbox) ou uma caixa de e-mail (Gmail, Outlook), o Hive começa a ler imediatamente, em vez de
  esperar pela sincronização por hora. Ele lê em lotes de até 500 itens por cerca de quatro minutos por
  execução e continua por até mais seis execuções; o que restar depois disso é lido pela
  sincronização regular por hora. No Ask, **Preparando seus dados** mostra o progresso. Após a primeira
  atualização, o Hive sincroniza apenas o que mudou.
* **Ações**: no Ask e em Sinais, o nível da conta determina o comportamento. Em **Agir**, o Hive executa a ação
  e informa o que fez; uma ação que não pode ser desfeita, ou que uma verificação de segurança retém,
  ainda exige confirmação prévia. Em **Rascunho**, ele espera sua aprovação e, em **Ler**, apenas informa
  o que encontrou. Um agente ou fluxo de trabalho segue o mesmo nível e limite para as ações selecionadas
  para ele e, mesmo em **Agir**, espera sua aprovação quando o destino de envio de uma ação não foi fornecido por
  você.
  Consulte
  [O que agentes e fluxos de trabalho fazem por conta própria](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md#what-agents-and-workflows-do).

> [!TIP]
>
> Não está vendo o que esperava? O bloco mostra quando o Hive sincronizou pela última vez e quantos arquivos e
> e-mails ele leu. Se aparecer **Desconectado** ou **Reconexão necessária**, selecione
> **Reconectar**. Consulte [Integridade e desconexão](https://docs.get-hive.ai/integrations/health-and-disconnect.md).

## Conteúdo relacionado

> [card] [Catálogo de integrações](https://docs.get-hive.ai/integrations/catalog.md)
>
> O que cada provedor oferece.

> [card] [Contas e autonomia](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md)
>
> Ler, Rascunho e Agir por conta.


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