Conecta-seEntrar na plataforma

Credencial

Selecionar ou listar credenciais OAuth autorizadas no workspace.

Lógica e processamentoRecurso internoConexão: OAuth

O que faz

Selecione credenciais OAuth do espaço de trabalho ou localize e liste contas da organização em um espaço de trabalho liberado. Listar contas da organização encontra as contas conectadas por provedor, sem precisar de e-mail. Um e-mail exato do cadastro, opcional, restringe a lista. Só retornam contas ativas de integrações permitidas no espaço de trabalho que está executando o fluxo; contas desconectadas ficam de fora. Os resultados são paginados com hasMore e nextCursor. Gerencie os convites nas….

Quando usar: Use quando o seu fluxo precisar selecionar ou listar credenciais OAuth autorizadas no workspace.

Exemplo de situação: Processar os dados antes de seguir para a próxima etapa.

Antes de começar

Conexão necessária: OAuth.

Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.

Passo a passo

  1. Adicione Credencial ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.
  3. Escolha a operação. O painel mostra só os campos que essa operação usa.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Para configurar o gatilho

  1. Escolha se o gatilho dispara com uma nova credencial, uma reconexão ou um formulário enviado
  2. Peça a um administrador da organização para liberar este espaço de trabalho nas configurações de Contas conectadas
  3. Publique o fluxo para começar a receber eventos

Operações

OperaçãoO que faz
Selecionar credencialSeleciona credencial com o bloco Credencial.
Listar credenciaisLista credenciais com o bloco Credencial.
Localizar conta da organizaçãoLocaliza conta da organização com o bloco Credencial.
Listar contas da organizaçãoLista contas da organização com o bloco Credencial.
Localizar conexão MCP da organizaçãoLocaliza conexão MCP da organização com o bloco Credencial.
Listar conexões MCP da organizaçãoLista conexões MCP da organização com o bloco Credencial.

Campos

Mostrar campos de

  • Operação

    Escolhe qual ação este bloco executará.

    Opções:
    Selecionar credencial · Listar credenciais · Localizar conta da organização · Listar contas da organização · Localizar conexão MCP da organização · Listar conexões MCP da organização
    Padrão:
    Selecionar credencial

  • Provedor

    Define a consulta ou o filtro aplicado aos dados.

    Aparece em:
    Listar credenciais
    Exemplo:
    status = 'ativo'

  • Credencial

    Obrigatório conforme a operação

    Seleciona a conta já conectada que autoriza o acesso ao serviço.

    Aparece em:
    Selecionar credencial
    Exemplo:
    (escolha a conta conectada)

  • ID da credencial

    Obrigatório conforme a operaçãoEm campos adicionais

    Informa manualmente a credencial usada pela integração no modo avançado.

    Aparece em:
    Selecionar credencial

  • Provedor

    Obrigatório conforme a operação

    Escolhe uma das opções aceitas por este campo.

    Aparece em:
    Localizar conta da organização

  • Provedores

    Todos os provedores permitidos.

    Aparece em:
    Listar contas da organização
    Exemplo:
    Todos os provedores permitidos

  • Provedor MCP

    Obrigatório conforme a operação

    Escolhe uma das opções aceitas por este campo.

    Aparece em:
    Localizar conexão MCP da organização, Listar conexões MCP da organização

  • E-mail

    Obrigatório conforme a operação

    Opcional em listas; e-mail exato do cadastro.

    Aparece em:
    Localizar conta da organização, Listar contas da organização, Localizar conexão MCP da organização, Listar conexões MCP da organização
    Exemplo:
    cliente@exemplo.com

  • Limite de resultados

    Define um valor numérico, quantidade ou limite da operação.

    Aparece em:
    Listar contas da organização, Listar conexões MCP da organização
    Padrão:
    100
    Exemplo:
    10

  • Cursor

    Marcador para buscar a próxima página da listagem: cole o valor de nextCursor devolvido pela execução anterior; deixe vazio para começar do início.

    Aparece em:
    Listar contas da organização, Listar conexões MCP da organização
    Exemplo:
    nextCursor da página anterior

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <credencial.credentialId>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<credencial.credentialId>stringID da credencial — use nos campos de credencial de outros blocos.
<credencial.displayName>stringNome de exibição da credencial.
<credencial.providerId>stringID do provedor OAuth (ex.: google-email, slack).
<credencial.credentials>jsonCredenciais OAuth com credentialId, displayName e providerId. As contas da organização também trazem email (endereço do cadastro), accountEmail (endereço da conta no provedor), providerSubjectId e providerTenantId.
<credencial.emails>jsonE-mails das contas no provedor nesta página, na mesma ordem das credenciais. Várias contas são mantidas; siga nextCursor enquanto hasMore for true para obter as próximas páginas.
<credencial.count>numberQuantidade de conexões retornadas.
<credencial.email>stringE-mail do cadastro.
<credencial.mcpServerId>stringID da configuração compartilhada do servidor MCP; use credentialId para selecionar a conta.
<credencial.mcpServerName>stringNome do servidor MCP.
<credencial.toolNames>jsonFerramentas disponíveis nesta conexão.
<credencial.mcpConnections>jsonConexões MCP gerenciadas com credentialId, email, mcpServerId, mcpServerName, displayName e toolNames.
<credencial.hasMore>booleanIndica se há outra página disponível.
<credencial.nextCursor>stringCursor da próxima página, ou null.

Exemplo de uso

Objetivo: Processar os dados antes de seguir para a próxima etapa.

InícioCredencialpróxima etapa
Operação
Selecionar credencial
Credencial
(escolha a conta conectada)

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa
Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal
Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte
Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <credencial.credentialId>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
O campo que eu procuro não aparece
Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
Erro de autorização ou permissão (401/403)
A conta conectada perdeu o acesso ou não tem permissão para esta operação. Reconecte a conta no campo de credencial e confirme as permissões pedidas.

Blocos relacionados