Ligar ferramentas de IA (Claude, ChatGPT)

Pode ligar um assistente de IA como o Claude ou o ChatGPT à sua organização Flowtly e fazer-lhe perguntas sobre os seus dados em linguagem comum. Em vez de abrir o Flowtly e navegar até ao ecrã certo, pode pedir ao seu assistente coisas como "Qual é o total das nossas faturas vencidas este mês?" ou "Mostra as transações deste trimestre da nossa conta bancária principal" e obter uma resposta retirada diretamente dos seus dados Flowtly em tempo real.

A ligação pode ler os seus dados e executar um conjunto selecionado de ações. Por exemplo, pode criar ou atualizar fornecedores, clientes, contratos, contas bancárias, grupos de custos e faturas de venda, e corrigir ou eliminar as faturas que recebe; registar tempo de trabalho e criar ou atualizar tarefas; definir a tarifa a que um projeto fatura; registar, aprovar ou cancelar ausências; reservar ativos; criar etiquetas e categorias de etiquetas; fechar um prospeto ou negócio de vendas; carregar o logótipo ou o banner da sua organização; e integrar um colega — adicioná-lo, convidá-lo a iniciar sessão e definir o que pode aceder. São exemplos, não a lista completa, e são acrescentadas ações ao longo do tempo: para saber se algo é possível, pergunte ao seu assistente, que vê todas as ações que a sua ligação oferece. Nunca faz nada além do que as suas próprias permissões no Flowtly já permitem, e cada ação é uma ferramenta específica e com nome — nunca uma capacidade livre de «fazer qualquer coisa». Baseia-se no Model Context Protocol (MCP), o padrão aberto que as ferramentas de IA usam para se ligar a fontes de dados externas.

O que precisa

Uma conta Flowtly com acesso a, pelo menos, uma organização.
Uma ferramenta de IA que suporte conectores MCP personalizados (por exemplo, o Claude, o ChatGPT ou o Gemini Enterprise num plano que permita adicionar conectores).
O endereço do conector Flowtly: https://mcp.flowtly.eu

Como ligar

Esta configuração é feita uma só vez e demora cerca de um minuto.

No Claude:

Abra Definições → Conectores (num plano que permita conectores personalizados).
Clique em Adicionar conector personalizado.
Cole o endereço Flowtly https://mcp.flowtly.eu e confirme.
Clique em "Connect" junto ao novo conector Flowtly. Abre-se uma janela de início de sessão do Flowtly.

No ChatGPT:

Abra as definições de conectores/integrações e escolha adicionar um conector (um servidor MCP).
Cole https://mcp.flowtly.eu como endereço do servidor e continue.
Quando for solicitado, escolha iniciar sessão / autorizar.

No Claude Code (linha de comandos):

Execute: claude mcp add --transport http flowtly https://mcp.flowtly.eu/mcp
No Claude Code, selecione Authenticate para o novo servidor Flowtly; abre-se uma janela do navegador.

Em qualquer outra ferramenta MCP (incluindo o Gemini Enterprise):

Encontre onde a sua ferramenta adiciona um servidor MCP personalizado ou um conector personalizado. No Gemini Enterprise, é na consola de administração do Google Workspace.
Indique o endereço https://mcp.flowtly.eu. Para a maioria das ferramentas é o único dado necessário — o Flowtly regista a sua ferramenta automaticamente, pelo que não há nada a pedir-nos nem qualquer chave a obter.
Se a sua ferramenta pedir mais do que um endereço, trata-se de uma configuração OAuth padrão e estes são os valores:
- Registo: https://mcp.flowtly.eu/oauth/register
- Autorização: https://mcp.flowtly.eu/oauth/authorize
- Token: https://mcp.flowtly.eu/oauth/token
- Método PKCE: S256 (obrigatório)
- Segredo do cliente: nenhum — os conectores do Flowtly são clientes públicos
Prossiga para o passo de início de sessão abaixo.

Se a sua ferramenta lhe mostrar um ID de cliente, copie-o de uma só vez. É uma única linha longa sem espaços, e alguns formulários de administração quebram-na ao colar, o que impede a ligação de funcionar. Se uma ligação falhar logo a seguir a colar um, apague o valor e cole-o de novo em vez de assumir que a configuração está errada.

Depois, o mesmo para todas as ferramentas:

Inicie sessão no Flowtly na janela que se abre — com o seu e-mail e palavra-passe habituais, tal como na aplicação web. Se já tiver a sessão iniciada, este passo é ignorado.
Aparece um ecrã de consentimento, indicando que o assistente pretende aceder aos seus dados do Flowtly, e mostrando exatamente o que está a ser pedido. Escolha a organização que pretende ligar e, em seguida, clique em "Approve" (ou Recusar para cancelar).
É reencaminhado para a sua ferramenta de IA. O conector Flowtly está agora ativo e pode começar a fazer perguntas sobre essa organização.

Cada ligação está associada a uma organização. Se trabalha em várias organizações, repita os passos e escolha uma organização diferente de cada vez; o assistente mantém-nas separadas.

Como funciona na prática

Depois de ligar, basta conversar normalmente. Por exemplo, escreve:

Quanto temos ainda por receber em faturas este mês?

O assistente reconhece que se trata de uma pergunta relativa ao Flowtly, lê os dados das faturas da organização ligada e responde com o valor — por exemplo "Tem 4 faturas por pagar este mês, num total de 18.200 zł" — retirado dos seus dados em tempo real. Não abriu o Flowtly, não executou um relatório nem exportou nada; fez uma pergunta e obteve uma resposta. Pode continuar a fazer perguntas de seguimento ("quais delas estão vencidas?") na mesma conversa.

O que pode perguntar

Depois de ligado, o seu assistente pode ler as partes da sua organização que já consegue ver no Flowtly, incluindo:

"Transactions" — saldos, movimentos recentes, gastos com uma determinada contraparte ao longo de um período.
"Invoices" — montantes em aberto, o que foi pago ou recebido, totais por estado.
"Contracts" e os respetivos planos de pagamento.
"Counterparties", fornecedores, contas bancárias, grupos de custo e dados de referência relacionados.
Resourcing — o plano comparado com as horas efetivamente registadas, por pessoa por semana; quem está disponível ao longo de um período; o que está reservado para o futuro; e os pedidos de pessoal em aberto, juntamente com o que já foi decidido sobre os anteriores. Se o seu acesso abranger esses dados, os valores de receita, custo e margem subjacentes ao plano também podem ser consultados. As perguntas sobre resourcing requerem o módulo Resourcing na sua subscrição.
Horários de trabalho — os padrões de horário de trabalho definidos pela sua organização, quais estão em vigor numa determinada data e quem está atribuído a cada um.
Recursos humanos — pedidos de contratação em aberto e os candidatos apresentados para os mesmos.

As perguntas sobre um período precisam de uma data de início e de fim — diga qual o período que pretende, por exemplo "entre 1 de abril e 30 de junho" ou "para julho". O assistente lê esta informação; as reservas, horários e pedidos de contratação continuam a ser criados e alterados no Flowtly.

Perguntas úteis para experimentar:

"Quanto gastámos com [contraparte] no trimestre passado?"
"Lista as nossas faturas vencidas."
"Qual é o saldo da nossa conta principal e as últimas cinco transações?"
"Em setembro, quem está disponível?"
"Entre 1 de julho e 30 de setembro, o plano foi cumprido — horas planeadas versus horas registadas por pessoa?"
"Quais os pedidos de pessoal ainda em aberto e algum deles já tinha sido solicitado e recusado anteriormente?"

O assistente apenas devolve valores que existem no Flowtly, e cada resposta baseia-se nos seus dados reais e atualizados da organização que ligou.

Integrar um colega

Dar acesso a alguém tem três partes, e um assistente ligado pode realizar todas elas sem que abra o Flowtly:

Adicionar a pessoa. O assistente cria o registo de funcionário.
Convidá-la a iniciar sessão. O assistente envia um convite para o endereço de e-mail que indicar, e o Flowtly envia à pessoa um convite escrito no idioma de interface configurado para a sua organização. O convite fica pendente até que a pessoa o abra e configure o seu próprio início de sessão; o assistente não pode escolher uma palavra-passe nem iniciar sessão em seu nome.
Definir o que pode aceder. O assistente atribui os grupos de permissões. Os grupos e as pessoas têm de ser identificados pelo respetivo id do Flowtly; um nome de grupo ou qualquer outro valor que não seja um id é recusado e nada é alterado.

O convite e os grupos de permissões são independentes um do outro, pelo que o acesso pode ser concedido antes ou depois de o convite ser enviado. Note que os dois não são substitutos: alguém com grupos de permissões mas que nunca foi convidado continua sem forma de iniciar sessão, e uma pessoa convidada sem grupos de permissões pode iniciar sessão mas ver muito pouco.

Peça-o em linguagem natural, por exemplo «Adiciona Anna Kowalska como funcionária, convida-a em anna.kowalska@example.com e dá-lhe os mesmos grupos de permissões que o resto da equipa de entrega». Convidar alguém requer a mesma permissão que gerir pessoas no Flowtly. Pedir para convidar uma pessoa que já tem início de sessão não altera nada — o assistente informa que já tem um em vez de enviar um segundo e-mail.

Para realizar os mesmos passos no ecrã, consulte as páginas Invite your team, Creating a New Employee e Permission groups.

Fechar um prospeto ou uma oportunidade de negócio

Um assistente ligado pode fechar trabalho de vendas além de o registar. Pode fechar um prospeto que não ganhou, fechar uma oportunidade de negócio como ganha ou perdida, e reabrir qualquer um deles depois.

Fechar como perdida pede um motivo, escolhido na lista fixa que a sua organização mantém — não escrito como texto livre — o que é o que torna o trabalho perdido contabilizável no final do trimestre. Uma nota opcional pode acompanhá-lo. Peça em linguagem natural, por exemplo «Fecha o prospeto da Acme como perdido — escolheram um concorrente», e o assistente faz corresponder o que disse a uma entrada da lista. Um motivo que não está na lista é recusado em vez de registado como escrito.

Duas coisas valem a pena saber antes de pedir:

Fechar é um passo próprio, não uma edição. Um prospeto ou uma oportunidade é fechado(a) por uma ação de fecho dedicada, não editando um campo de estado no registo — por isso peça para fechá-lo, em vez de pedir para alterar o seu estado.
Perdido não é o mesmo que Não contactar. «Não contactar» é um pedido de supressão e bloqueia qualquer registo posterior contra a empresa. Fechar como perdido regista apenas que esta oportunidade particular não se concretizou, e deixa-o livre para abordar a empresa novamente mais tarde.

A reabertura comporta-se de forma diferente para os dois, o que vale a pena saber antes de pedir. Um prospeto reaberto retoma exatamente na fase do funil em que estava. Uma oportunidade reaberta regressa à primeira fase do pipeline, não à fase em que estava quando fechou, pelo que a avança novamente por conta própria.

Definir a tarifa de faturação de um projeto

Um assistente ligado pode definir a tarifa a que um projeto fatura, em vez de apenas substituir o montante de uma única reserva. Uma reserva substituída mantém o montante fixo que lhe foi dado e deixa de seguir a tarifa do projeto, pelo que as alterações de tarifa posteriores não a afetam.

Uma tarifa é um montante fixo ou uma tarifa por unidade, por exemplo por m², e produz sempre efeito a partir de uma data. Uma alteração de tarifa é registada como uma nova tarifa a partir da data em que começa, e não editando a anterior, pelo que a tarifa anterior continua válida para o período antes dela. Peça em linguagem natural, por exemplo «A partir de 1 de novembro, fature o projeto Riverside a 4,20 EUR por m²».

Uma única instrução pode alterar várias linhas. Uma tarifa definida para o projeto como um todo, sem indicar um imóvel específico, é copiada para todas as regras correspondentes do projeto. Depois verá a mesma tarifa em vários sítios; é o comportamento previsto, não um erro a corrigir. Uma tarifa definida para um imóvel indicado altera apenas esse imóvel.

Definir a tarifa de um projeto requer a permissão para gerir projetos. Acrescentar um novo tipo de tarifa, como uma primeira tarifa por m², requer também a permissão para gerir atributos.

Importar os acrónimos Optima a partir da lista do seu gabinete de contabilidade

Se o seu gabinete de contabilidade trabalha no Comarch Optima, um assistente ligado pode preencher os acrónimos Optima das suas contrapartes a partir da lista de contratantes que o gabinete lhe envia. Faz o mesmo trabalho que a caixa de diálogo "Import Optima acronyms" da lista de contrapartes, em dois passos separados.

Verifique primeiro o ficheiro. Entregue ao assistente a lista de contratantes como ficheiro .xlsx, .ods ou .csv. O formato antigo .xls é recusado: guarde a lista num dos três formatos suportados e tente novamente. O assistente associa cada linha a uma contraparte pelo respetivo NIP (identificador fiscal) e mostra o que seria definido. Este passo não altera nada no Flowtly.
Confirme e aplique. Depois de analisar as correspondências e de dizer ao assistente quais manter, este guarda esses acrónimos nas contrapartes.

Aplicam-se duas proteções quando os acrónimos são guardados:

Um acrónimo que escreveu pessoalmente nunca é substituído. Só são preenchidas as contrapartes sem um acrónimo introduzido manualmente.
Um acrónimo que outra contraparte já tem é ignorado. A linha fica de fora em vez de criar um duplicado.

Ambos os passos exigem a permissão para gerir transações na sua organização. Peça em linguagem corrente, por exemplo «Aqui está a lista de contratantes dos nossos contabilistas - verifique com que contrapartes corresponde e não altere nada por enquanto», e depois «Aplique as correspondências exceto as duas últimas».

Os acrónimos importam porque a exportação do Comarch Optima omite um documento cuja contraparte não tem nenhum; consulte Exportações de contabilidade.

Segurança e privacidade

Lê os seus dados e pode executar um conjunto selecionado de escritas. Um assistente ligado pode realizar as ações descritas no início deste artigo — sempre através de ações específicas e com nome, e sempre limitado ao que a sua própria conta tem permissão para fazer.
Algumas ações saem do Flowtly. Convidar um colega envia-lhe um e-mail, pelo que chega a uma pessoa e não se limita a alterar um registo. Está disponível apenas para contas que podem gerir pessoas, vai para o endereço que indicar e não concede nada por si só — a pessoa convidada continua a ter apenas os grupos de permissões que lhe atribuir. Outras ações notificam as pessoas tal como no Flowtly, por exemplo registar ou aprovar uma ausência, ou atribuir alguém a uma tarefa; ao carregar ausências ou tarefas passadas, peça ao assistente que não envie o e-mail. Submeter uma fatura eletrónica envia-a para o KSeF, o sistema nacional polaco de faturação eletrónica.
Eliminar pede confirmação primeiro. Toda a ação que elimina ou cancela um registo é assinalada à sua ferramenta de IA como irreversível, pelo que uma ferramenta que respeite essa marcação lhe pede para confirmar antes de avançar. Se a confirmação aparece e como aparece depende da sua ferramenta de IA; o Flowtly continua a recusar qualquer eliminação que a sua própria conta não tenha permissão para fazer.
Limitado a uma organização. Uma ligação só vê a única organização que selecionou ao conceder o acesso. Não consegue alcançar as suas outras organizações.
Aplicam-se as suas próprias permissões. O assistente vê os dados através da sua conta, pelo que está limitado àquilo que tem permissão para ver nessa organização.
Mantém o controlo. O acesso é concedido por si, para uma organização, e pode desligar o conector da sua ferramenta de IA a qualquer momento para o revogar.

Perguntas frequentes

É seguro entregar isto a uma ferramenta de IA? Sim. A ligação está limitada a uma organização e às permissões da sua própria conta, e utiliza o mesmo início de sessão seguro da aplicação web do Flowtly. O assistente pode ler os seus dados e executar o conjunto selecionado de ações descrito no início deste artigo, mas apenas o que você próprio pode fazer nessa organização. Algumas ações saem do Flowtly, como convidar um colega, registar ou aprovar uma ausência, ou atribuir alguém a uma tarefa, que enviam um e-mail às pessoas em causa; veja Segurança e privacidade acima.

Consegue ver as minhas outras organizações? Não. Cada ligação está vinculada à única organização que escolhe durante o início de sessão. Para trabalhar com outra organização, adicione uma ligação separada para ela.

Como a desligo? Remova o conector Flowtly da sua ferramenta de IA. Depois de removido, deixa de poder ler os seus dados Flowtly. Se o seu início de sessão expirar ou deixar de ser válido, o conector é recusado e a sua ferramenta de IA pede-lhe que inicie sessão novamente; não continua silenciosamente com acesso reduzido. Sem qualquer início de sessão, uma ferramenta só consegue aceder às ferramentas públicas de leitura.

Que ferramentas de IA são suportadas? Qualquer ferramenta que suporte conectores MCP personalizados — entre elas o Claude, o ChatGPT e o Gemini Enterprise, num plano que permita adicioná-los. Não há uma aplicação Flowtly separada para instalar em cada ferramenta nem qualquer aprovação a pedir: aponte o conector para https://mcp.flowtly.eu e siga os passos de início de sessão acima. Uma ferramenta que não esteja aqui indicada funciona da mesma forma, desde que suporte a norma aberta.

Para programadores

A criar uma integração? Veja a referência técnica do MCP — as ferramentas (tools/list / tools/call) e os detalhes JSON-RPC do conetor.

Exemplos de utilização

Faturas em atraso a pedido: Peça ao seu assistente as faturas em atraso deste mês e os respetivos totais, sem abrir o Flowtly.
Planeado face às horas registadas: Pergunte quem está disponível num determinado mês, ou se o planeamento se cumpriu face às horas registadas por pessoa.
Integrar um colega: Peça ao assistente que adicione um colaborador, o convide a iniciar sessão e lhe atribua os grupos de permissões num único pedido.
Encerrar um potencial cliente perdido: Peça ao assistente que encerre um potencial cliente como perdido e escolha o motivo na lista da sua organização.