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.
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.
Ligar uma Aplicação
- Abra Agentes, depois Gerir Ligações.
- 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.
- Clique em Ligar na aplicação que deseja. O botão muda para A Abrir... enquanto a janela de autenticação é preparada.
- Inicie sessão na aplicação e aprove o acesso que lhe é solicitado.
- 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.
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
- Abra Agentes, depois Gerir Ligações.
- Clique em Desligar na aplicação ligada.
- 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.
- 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 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.
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.