Conectores

• —Um conector liga uma aplicação externa ao assistente, para que ele possa consultar dados nela e agir lá. Podem ser ligados o Slack, o Notion, o Google Drive, o HubSpot e cerca de mil outras. «Procura a proposta no Drive e diz-me o que diz sobre os preços.» «Publica esta atualização no canal de vendas.» Os conectores estão em Conectores, na barra lateral.
• —Para ligar uma aplicação, escolha-a na lista, escolha para quem é e o que o assistente pode fazer, e depois termine na página de início de sessão da própria aplicação, ou cole lá uma chave da aplicação. A palavra-passe ou a chave nunca passa pelo chat do OpenEmail, pela API dele nem pelo assistente. O conector fica pendente até terminar, e ativo depois disso.
• —Um conector é só para si ou para todo o espaço de trabalho, e o assistente pode apenas consultar através dele ou também fazer alterações. Pode mudar isso mais tarde, e pausar um conector e retomá-lo. Desligar também retira o acesso na aplicação externa. Se a aplicação deixar de aceitar a ligação, o conector pede para ser ligado de novo, e um link novo repõe-no como o mesmo conector.
• —Num chat, o assistente vê o que está ligado, encontra a ação certa na aplicação e lê de imediato. Para tudo o que altera algo na aplicação, como enviar uma mensagem, criar ou atualizar um registo ou eliminar, mostra primeiro um cartão para aprovar, mesmo quando lho pediu diretamente. Um conector que só consulta recusa alterações, e o que uma aplicação devolve é tratado como informação, nunca como instruções.
• —Uma tarefa só usa conectores quando Conectores está ativado nas Ferramentas extra da tarefa, e só os ligados para o espaço de trabalho, nunca um que pertença a uma só pessoa. Lê sozinha. Cada alteração numa aplicação fica em À sua espera, seja o que for que a tarefa possa fazer sozinha no resto, e uma tarefa que usa conectores nunca responde ao correio sozinha: cada resposta espera a sua aprovação.
• —Cada chamada feita através de um conector fica registada durante 90 dias: quando, que aplicação e que ação, se leu ou alterou algo, se funcionou, e se veio de um chat, de uma tarefa, da API ou de um agente. O OpenEmail nunca guarda o que foi enviado à aplicação nem o que ela devolveu.
• —Três permissões decidem quem faz o quê: uma para ver os conectores e o que foi feito através deles, uma para pôr o assistente a usá-los, e uma para ligar, pausar e desligar aplicações e definir o que o assistente pode fazer. Os proprietários e os administradores têm as três, Member tem as duas primeiras e Viewer a primeira. Quem pode ligar uma aplicação pode ligá-la para si ou para o espaço de trabalho.
• —Um plano comporta 2 conectores no Free, 10 no Starter e 50 no Business para uma conta, e outros tantos para um espaço de trabalho. O Enterprise não define um limite próprio, e nada comporta mais de 200. Quando um espaço de trabalho muda para um plano inferior, os conectores mais recentes que excedem o limite ficam em pausa, não são removidos.
• —As ligações são mantidas por um fornecedor externo, que também guarda um registo do que o assistente envia a uma aplicação e do que a aplicação responde, até um ano. A página Política de Privacidade nomeia-o.
• —Os conectores estão na API REST em /connectors, /connector-apps, /connector-categories e /connector-calls, em cada SDK como connectors, na linha de comandos como openemail connectors e no servidor MCP. Pela API, uma alteração é executada de imediato sem perguntar a ninguém, por isso quem chama é que decide. Três eventos de webhook avisam os seus sistemas quando um conector do espaço de trabalho é ligado, é desligado ou precisa de ser ligado de novo.

Ligar demora um minuto, e o início de sessão acontece na página da própria aplicação.

1. 1Abra Conectores na barra lateral e encontre a aplicação em Explorar, pelo nome ou por uma categoria.
2. 2Escolha para quem é o conector: só para si, ou para todo o espaço de trabalho.
3. 3Escolha o que o assistente pode fazer através dele: só consultar, ou também fazer alterações.
4. 4Termine na página de início de sessão da aplicação, ou cole lá uma chave da aplicação. O conector fica pendente até terminar, e ativo depois disso.

• —A sua palavra-passe ou chave da aplicação nunca passa pelo chat do OpenEmail, pela API dele nem pelo assistente.
• —Quando uma aplicação deixa de aceitar a ligação, o conector indica que precisa de ser ligado de novo. Um link novo repõe-no como o mesmo conector, por isso as tarefas que o usam continuam.
• —Pause um conector para impedir o assistente de o usar, e retome-o quando o quiser de volta.
• —Desligar remove o conector e também retira o acesso que ele tinha na aplicação externa.
• —Os conectores podem ser desativados para todo o serviço. Nesse caso, a página fica oculta.

• —Os proprietários e os administradores têm as três. A função integrada Member tem connectors:read e connectors:use, e Viewer tem connectors:read.
• —A mesma permissão cobre os dois tipos de conector: quem pode ligar uma aplicação pode ligá-la para si ou para o espaço de trabalho.

Os conectores estão na API REST em /connectors, /connector-apps, /connector-categories e /connector-calls, em cada SDK e na CLI em connectors, e nas ferramentas MCP, que o assistente também usa.