# Ligando Aplicações Externas aos Seus Agentes

Source: https://support.kapsulehost.com/pt-pt/agents-connections

As Ligações Deixam um Agente Especialista Trabalhar Dentro de Aplicações que Já Utiliza, com a Sua Permissão, e São Completamente Separadas do que um Especialista Pode Fazer na Sua Conta KapsuleHost.

## O Que É uma Ligação

Uma ligação é um elo autenticado entre um dos seus especialistas e uma aplicação externa. Uma vez ligado, esse especialista pode utilizar as ferramentas da aplicação numa conversa: ler um documento, redigir uma mensagem, verificar um registo. Sem uma ligação, o especialista não tem acesso nenhum.

Há duas coisas em que vale a pena ser preciso:

- Uma ligação concede acesso a **essa aplicação**, não à sua conta KapsuleHost. Os dois conjuntos de permissões nunca se misturam.
- Qualquer coisa que **altere** algo na aplicação ligada passa ainda pelo mesmo cartão de confirmação que uma alteração na sua conta KapsuleHost. A leitura é imediata; a escrita pede permissão primeiro.

> **Note:** As Ligações ficam em **Agentes**, depois **Gerir Ligações**, ou vá diretamente a `/agents/connections`. A página inicial de Agentes também mostra um cartão de Ligações com algumas aplicações de exemplo.

## Que Especialistas Podem Utilizar Que Aplicações

O repertório é deliberadamente conservador, e cada especialista vê apenas as aplicações de que a sua função precisa. Algumas limitam-se a ferramentas de leitura mesmo quando a aplicação em si pode fazer mais:

| Especialista | Aplicações externas que pode alcançar |
|---|---|
| Mara, Consultor de Negócios | Stripe (apenas leitura) |
| Thea, Escritor Criativo | Notion |
| Sef, Consultor de SEO | GitHub (apenas leitura) |
| Mila, Planeador de Marketing | Gmail, Slack, Notion, Google Calendar |
| Iris, Comunicações com Clientes | Gmail, Slack |
| Ash, Vendas e Divulgação | Gmail, Slack, Stripe (apenas leitura) |
| Pip, Política e Documentação | Nenhuma |

Ligar uma aplicação não a dá a toda a equipa. Fica disponível apenas para os especialistas na linha acima.

![O catálogo de Ligações em Kapsule Agents](https://support.kapsulehost.com/help/screenshots/agents-connections.26935fcd.webp)

## Ligar uma Aplicação

1. Abra **Agentes**, depois **Gerir Ligações**.
2. Navegue no separador **Popular**, mude para **Todas as Aplicações**, ou escreva na caixa de pesquisa. Cada cartão mostra o nome da aplicação e quantas ferramentas expõe.
3. Clique em **Ligar** na aplicação que deseja. O botão muda para **A Abrir...** enquanto a janela de autenticação é preparada.
4. Inicie sessão na aplicação e aprove o acesso que lhe é solicitado.
5. Regressa à página de Ligações com uma confirmação **[app] Ligada**.

Uma vez ligada, o cartão mostra um comprimido **Ligada**, a etiqueta da conta com a qual iniciou sessão, e quando a ligação foi utilizada pela última vez, ou **Ainda não utilizado**.

## Estados da Ligação

| Estado | O que significa | O que fazer |
|---|---|---|
| Ligada | A funcionar. Os seus especialistas podem utilizá-la. | Nada |
| Pendente | A autenticação foi iniciada mas nunca foi concluída. | Clique em **Concluir Ligação** |
| Reconexão Necessária | O acesso expirou ou foi revogado do lado da aplicação. | Clique em **Religar** |

O estado **Reconexão Necessária** é normal ao longo do tempo: a maioria das aplicações expira o acesso que concedem num horário. Religar restaura-o sem perder nada.

## Como Isto Se Mantém Seguro

A página de Ligações apresenta o modelo de segurança em três linhas, e vale a pena compreender em vez de apenas folhear:

- **Processado por um parceiro certificado.** A autenticação numa aplicação é processada pelo nosso parceiro de integração certificado, que detém a autorização. A sua palavra-passe da aplicação nunca toca em KapsuleHost.
- **Confirmação antes da ação.** Os Agentes pedem permissão antes de agir. Qualquer coisa que altere algo precisa do seu consentimento primeiro.
- **Revogação instantânea.** Desligar corta o acesso imediatamente, tanto aqui como na aplicação.

> **Warning:** Trate uma ligação como uma chave que cortou para alguém. Ligue as contas em que quer que os seus especialistas trabalhem, não todas as contas que possui. Se não tiver a certeza de que um especialista precisa de uma aplicação para fazer o trabalho que tem em mente, não a ligue: pergunte primeiro, depois ligue.

## Desligar uma Aplicação

1. Abra **Agentes**, depois **Gerir Ligações**.
2. Clique em **Desligar** na aplicação ligada.
3. Aparece uma confirmação: *A sua equipa perde acesso a [app] imediatamente. Qualquer coisa que já tenha utilizado permanece no seu histórico de conversas.*
4. Clique em **Desligar** para confirmar.

O acesso termina imediatamente. O que isto **não** faz é eliminar o conteúdo da aplicação das conversas que já teve: se um especialista citou um documento numa conversa na semana passada, esse texto ainda está no histórico da conversa. Desligar diz respeito ao acesso futuro, não à apagamento retroativo.

## Quando as Ligações Não Estão Disponíveis na Sua Conta

Se a página de Ligações mostrar um único cartão tranquilo dizendo **As Ligações Ainda Não Estão Disponíveis**, ligar aplicações externas ainda não foi ativado para a sua conta. O cartão deixa explícito que nada está ligado e nada tem acesso, o que é exatamente a verdade nesse estado. Os seus especialistas continuam a trabalhar; apenas não conseguem alcançar fora de KapsuleHost.

O resto de Agentes não é afetado. Conversas, [Competências](https://support.kapsulehost.com/pt-pt/agents-skills) e leituras de conta funcionam normalmente.

## E Se Falhar

**"A permissão não foi concedida, por isso nada foi ligado."** Cancelou ou recusou no ecrã de aprovação da própria aplicação. Nada foi criado. Clique em **Ligar** novamente e aprove o acesso.

**"As Ligações estão indisponíveis neste momento. Tente novamente daqui a pouco."** O serviço de integração não conseguiu ser alcançado. Isto é deliberadamente encerrado com segurança: em vez de mostrar uma lista meio construída, a página mostra nada. Aguarde um minuto e recarregue.

**"As Ligações não conseguiram ser carregadas."** As suas definições estão seguras. Atualize a página. Se persistir, [abra um pedido de suporte](https://support.kapsulehost.com/pt-pt/opening-a-support-ticket).

**Um especialista diz que não consegue alcançar uma aplicação ligada.** Verifique a tabela acima. Nem todos os especialistas têm permissão para todas as aplicações, e uma aplicação ligada para Iris não está automaticamente disponível para Mara.

**Uma ligação fica em Pendente.** A janela de autenticação foi fechada antes de terminar. Clique em **Concluir Ligação** e complete-a.

## O Que as Ligações Custam

Utilizar uma aplicação ligada numa conversa é medido como qualquer outro trabalho. Cada chamada que um especialista faz para uma aplicação externa é cobrada ao peso de chamada de ligação, o que é uma fração do que um texto longo custa. As leituras na sua conta KapsuleHost permanecem gratuitas. O peso completo está em [Como Funcionam os Créditos do Agente](https://support.kapsulehost.com/pt-pt/agents-credits).

## Leitura Relacionada

- [Visão geral dos Agentes Kapsule](https://support.kapsulehost.com/pt-pt/agents-overview)
- [Começar com Agentes Kapsule](https://support.kapsulehost.com/pt-pt/agents-getting-started)
- [Utilizar Competências do Agente](https://support.kapsulehost.com/pt-pt/agents-skills)