Connections

Uma Connection armazena a autorização que permite que a Zaia se comunique com um serviço externo.

Por padrão, cada connection pertence ao workspace em que foi criada. Ela pode ser reutilizada por Channels, MCPs, Tools, Automações e outros fluxos do produto que as suportem dentro desse workspace.

Connections Composio autenticadas em MCPs aparecem em Automações quando a origem do evento externo é Composio. Connections Instagram nativas alimentam o evento Instagram - Novo comentário. Guia: Automações.

Um Custom MCP com Autenticação = OAuth também cria uma connection no workspace, usada só por aquele servidor. Guia: Como Cadastrar um MCP Customizado.

Connections WhatsApp (UR) e WhatsApp (Official) também podem ser compartilhadas com outros workspaces do mesmo Console, sem duplicar credenciais. Veja Compartilhar connections entre workspaces.

Renomeando uma connection

Você pode atualizar o nome de exibição de uma connection existente sem recriá-la ou reconectá-la.

Abra Workspace Settings → Connections.
Abra o menu de ações da connection.
Selecione Edit.
Informe um nome entre 3 e 50 caracteres.
Salve a alteração.

A lista de connections é atualizada com o novo nome após a atualização ser concluída com sucesso.

Renomear altera apenas o nome da connection. Isso não altera:

A autenticação ou as credenciais salvas.
A conta externa conectada.
Os detalhes ou a descrição da connection.
O status da connection.
Channels, MCPs ou outros recursos que já utilizam a connection.

Se a atualização falhar, a janela de edição permanece aberta com o valor informado para que possa ser revisado e enviado novamente.

Permissões

Renomear segue a mesma permissão de workspace usada para gerenciar connections. Usuários sem essa permissão não podem atualizar uma connection.

Somente connections próprias do workspace atual podem ser renomeadas, excluídas ou reconectadas. Connections com o badge Compartilhada vêm de outro workspace: o destino pode usá-las e desvincular o acesso, mas não editá-las.

Compartilhar ou revogar exige ser Owner do workspace proprietário ou owner/admin do Console.

Orientações de nomenclatura

Use nomes que distingam a conta externa ou a finalidade de cada connection, especialmente quando o workspace contiver múltiplas connections do mesmo tipo.