Conecta-seEntrar na plataforma

Ferramenta personalizada

Executar uma ferramenta personalizada criada no workspace com os parâmetros definidos pela equipe.

Integrações e ferramentasAPIs e operações técnicasConexão: Conexão do workspace ou do canal

O que faz

Executa uma ferramenta habilitada deste workspace usando os campos do seu schema. O código e os segredos permanecem no servidor.

Quando usar: Use quando o seu fluxo precisar executar uma ferramenta personalizada criada no workspace com os parâmetros definidos pela equipe.

Exemplo de situação: Automatizar uma operação técnica sem executar o trabalho manualmente.

Antes de começar

Conexão necessária: Conexão do workspace ou do canal.

Confirme que a integração ou o canal já está conectado no workspace.

Passo a passo

  1. Adicione Ferramenta personalizada ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Confirme que a integração ou o canal já está conectado no workspace.
  3. Revise a ação principal descrita no cartão do bloco.
  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.

Campos

  • Ferramenta do workspace

    Obrigatório

    Informa o identificador exato do recurso na plataforma conectada.

    Exemplo:
    (escolha na lista do campo)

  • Versão revisada

    Obrigatório

    Número da versão revisada da ferramenta personalizada que o bloco vai executar (ex.: 3); se o código ou os campos da ferramenta mudarem, revise de novo e republique a automação.

  • Parâmetros da ferramenta

    Informa dados estruturados ou código no formato exigido pelo campo.

    Exemplo:
    { "chave": "valor" }

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 <ferramentapersonalizada.result>: 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
<ferramentapersonalizada.result>jsonResultado retornado pela ferramenta personalizada.

Exemplo de uso

Objetivo: Automatizar uma operação técnica sem executar o trabalho manualmente.

InícioFerramenta personalizadapróxima etapa
Ferramenta do workspace
(escolha na lista do campo)
Parâmetros da ferramenta
{ "chave": "valor" }

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 <ferramentapersonalizada.result>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
O serviço recusou a chamada ou devolveu erro
Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.

Blocos relacionados