Integrações

Integrações são conexões autenticadas a serviços de terceiros como Gmail, Slack, GitHub e HubSpot. O Zoen cuida do fluxo OAuth, do armazenamento de tokens e da renovação automática — você conecta uma vez e seleciona a conta em qualquer bloco que precise dela.

Você pode conectar várias contas por serviço — por exemplo, duas contas Gmail separadas para workflows diferentes.

A página Integrations

Clique em Integrations na barra lateral do workspace. A página mostra suas contas Connected, uma lista Featured e uma caixa de busca cobrindo todos os serviços disponíveis.

A segunda aba da página, Skills, guarda as skills de agente do seu workspace.

Abra um serviço para ver o que ele oferece:

Skills — capacidades prontas que você adiciona com um clique, como upsert-contact no HubSpot.
Templates — workflows iniciais construídos em torno do serviço.
+ Add to Zoen — conecta sua conta.

Conectando uma conta

Abra a página do serviço e clique em + Add to Zoen.
Informe um Display name para identificar esta conexão (ex.: "Work Gmail" ou "Sales HubSpot") e, opcionalmente, uma Description.
Revise as Permissions requested — esses são os scopes que o Zoen vai pedir ao provedor.
Clique em Connect e conclua o login e a aprovação do provedor.

Quando o provedor redirecionar você de volta, a conexão aparece em Connected.

Usando integrações em workflows

Blocos que exigem autenticação (ex.: Gmail, Slack, HubSpot) exibem um seletor de conta. Selecione a conta conectada que aquele bloco deve usar.

Você também pode conectar outra conta diretamente pelo bloco selecionando Connect another [service] account no final do dropdown.

Se um bloco exige uma integração e nenhuma está selecionada, o workflow falha nesse passo.

Usando um credential ID

Cada conexão tem um credential ID único que você pode usar para referenciá-la dinamicamente. Isso é útil quando você tem várias contas do mesmo serviço e quer alternar entre elas de forma programática — por exemplo, roteando execuções diferentes para contas Gmail diferentes com base em uma variável.

Para copiar um credential ID, abra a conexão na lista Connected e use o controle de cópia ao lado do nome.

Em qualquer bloco que exige uma integração, clique em Switch to manual ID ao lado do seletor de conta para mudar do dropdown para um campo de texto.

Cole ou referencie o credential ID nesse campo. Você pode usar uma referência {{SECRET}} ou uma variável de saída de bloco para torná-lo dinâmico.

Gerenciando uma conexão

Abra uma conexão na lista Connected para gerenciá-la:

Edite o Display name e a Description.
Gerencie Members — convide colegas e atribua a eles a função Admin ou Member. Admins podem editar, reconectar, desconectar e gerenciar o acesso; Members podem usar a conexão em workflows. Quando você conecta uma conta, você é o Admin dela.
Reconnect — reautorize se a conexão expirou ou se você precisa de permissões atualizadas.
Disconnect — remove a conexão por completo.

Se você desconectar uma integração usada em um workflow, esse workflow falhará em qualquer bloco que a referencie. Atualize os blocos antes de desconectar.

Common Questions

Sim. Quando uma integração é usada durante a execução, o Zoen verifica se o access token expirou e o renova automaticamente com o refresh token armazenado antes de fazer a chamada à API. Você não precisa cuidar da renovação de tokens manualmente.

Sim. Você pode conectar várias contas por serviço (por exemplo, duas contas Gmail separadas). Cada bloco permite selecionar qual conta usar no dropdown de conta. Isso é útil quando workflows diferentes precisam de identidades ou permissões diferentes.

Cada conexão tem um credential ID único que você pode usar no lugar do seletor dropdown. Isso permite passar a credencial dinamicamente — por exemplo, a partir de uma variável ou da saída de um bloco anterior — para o mesmo workflow usar contas diferentes conforme o contexto. Copie o ID na visão de detalhes da conexão e use Switch to manual ID em qualquer bloco para colar ou referenciá-lo.

Se a renovação falhar (ex.: o usuário revogou o acesso ou o refresh token expirou), o workflow falha no bloco que usa essa integração. Abra Integrations na barra lateral, encontre a conexão e reconecte para reautorizar.

Sim. Tokens OAuth são criptografados antes de serem armazenados no banco e nunca são expostos no editor de workflows, nos logs ou nas respostas da API.

Qualquer bloco que referencie a integração desconectada falhará em tempo de execução. Atualize esses blocos antes de desconectar, ou reconecte a integração para restaurar o acesso.