Esta funcionalidade permite executar um fluxo temporário, montado em memória, sem criar e guardar previamente um fluxo no Dablio Robô. O JSON pode ser enviado pelo próprio URL da página ou por um evento JavaScript CustomEvent.

É indicado para integrações entre sistemas, painéis internos, ERPs, links de ação rápida, webhooks indiretos, páginas que necessitem de acionar automações locais no browser e cenários onde o fluxo é gerado dinamicamente por uma aplicação externa.

Parâmetros disponíveis no URL

Como codificar o JSON para Base64URL

Os parâmetros dablioroboWorkflow, dablioroboCommands e dablioroboData devem ser enviados como Base64URL para evitar problemas com aspas, acentos, chaves, barras, espaços e caracteres especiais dentro do URL.

function toBase64Url(obj) {
  const json = JSON.stringify(obj);
  const utf8 = new TextEncoder().encode(json);
  let binary = '';

  utf8.forEach(byte => {
    binary += String.fromCharCode(byte);
  });

  return btoa(binary)
    .replace(/\+/g, '-')
    .replace(/\//g, '_')
    .replace(/=+$/g, '');
}

const workflowBase64 = toBase64Url(workflowJson);
const commandsBase64 = toBase64Url(commandsJson);

Exemplo 1 — Enviar workflow completo através do URL

Neste formato envia o workflow inteiro, semelhante a um fluxo exportado pelo Dablio Robô. O fluxo não será guardado no armazenamento local.

{
  "nome": "Consulta rápida no Google",
  "ativo": true,
  "blockDelay": 500,
  "startBlockId": "start",
  "trigger": {
    "tipo": "manual",
    "config": {}
  },
  "blocks": [
    {
      "id": "start",
      "type": "trigger",
      "config": []
    },
    {
      "id": "abrir_google",
      "type": "new-tab",
      "config": {
        "ativo": true,
        "url": "https://www.google.com",
        "criarNa": "janelaAtual",
        "aguardarCarregamento": true,
        "definirAbaAtiva": true
      }
    },
    {
      "id": "digitar_busca",
      "type": "forms",
      "config": {
        "ativo": true,
        "seletor": "textarea[name='q'], input[name='q']",
        "aguardarSeletor": true,
        "tempoAguardarSeletor": 15000,
        "acao": "text",
        "valor": "Dablio Group",
        "limparCampo": true
      }
    },
    {
      "id": "enviar_form",
      "type": "forms",
      "config": {
        "ativo": true,
        "seletor": "form[action*='/search']",
        "aguardarSeletor": true,
        "tempoAguardarSeletor": 10000,
        "acao": "submit"
      }
    }
  ],
  "connections": [
    {
      "from": { "blockId": "start", "port": "default" },
      "to": { "blockId": "abrir_google", "port": "in" }
    },
    {
      "from": { "blockId": "abrir_google", "port": "default" },
      "to": { "blockId": "digitar_busca", "port": "in" }
    },
    {
      "from": { "blockId": "digitar_busca", "port": "default" },
      "to": { "blockId": "enviar_form", "port": "in" }
    }
  ]
}

https://www.google.com/?dablioroboWorkflow=BASE64URL_DO_WORKFLOW&runToken=SUA_SENHA&dablioroboOnce=1&dablioroboNow=1

Exemplo 2 — Enviar comandos sequenciais através do URL

Neste formato envia apenas uma lista de comandos. O robô monta automaticamente o bloco inicial, os blocos intermédios e as ligações sequenciais.

[
  {
    "type": "open",
    "url": "https://www.google.com",
    "wait": true
  },
  {
    "type": "type",
    "selector": "textarea[name='q'], input[name='q']",
    "value": "Dablio Group",
    "wait": true,
    "clear": true
  },
  {
    "type": "submit",
    "selector": "form[action*='/search']",
    "wait": true
  },
  {
    "type": "click",
    "selector": "h3",
    "wait": true
  }
]

https://www.google.com/?dablioroboCommands=BASE64URL_DOS_COMANDOS&runToken=SUA_SENHA&dablioroboOnce=1&dablioroboNow=1

Aliases aceites em comandos curtos

Enviar variáveis juntamente com o fluxo

Use dablioroboData para enviar dados iniciais para a execução. Estes dados entram no contexto do fluxo e podem ser consumidos pelos blocos como variáveis.

https://www.google.com/?dablioroboWorkflow=BASE64URL_DO_WORKFLOW&dablioroboData=BASE64URL_DAS_VARIAVEIS&runToken=SUA_SENHA&dablioroboOnce=1&dablioroboNow=1

Exemplo 3 — Executar workflow temporário através do CustomEvent

Utilize este formato quando a página já está aberta e pretende acionar a automatização por JavaScript, sem recarregar o URL.

window.dispatchEvent(new CustomEvent('dabliorobo:execute-workflow', {
  detail: {
    runToken: 'SUA_SENHA',
    workflow: {
      nome: 'Fluxo temporário via evento',
      ativo: true,
      blockDelay: 500,
      startBlockId: 'start',
      trigger: {
        tipo: 'manual',
        config: {}
      },
      blocks: [
        {
          id: 'start',
          type: 'trigger',
          config: []
        },
        {
          id: 'aguardar_1s',
          type: 'delay',
          config: {
            ativo: true,
            tempoMs: 1000
          }
        }
      ],
      connections: [
        {
          from: { blockId: 'start', port: 'default' },
          to: { blockId: 'aguardar_1s', port: 'in' }
        }
      ]
    },
    data: {
      cliente: '123',
      origem: 'meu-sistema'
    }
  }
}));

Exemplo 4 — Executar comandos através do CustomEvent

window.dispatchEvent(new CustomEvent('dabliorobo:execute-workflow', {
  detail: {
    runToken: 'SUA_SENHA',
    commands: [
      {
        type: 'open',
        url: 'https://www.google.com',
        wait: true
      },
      {
        type: 'type',
        selector: "textarea[name='q'], input[name='q']",
        value: 'Dablio Group',
        wait: true,
        clear: true
      },
      {
        type: 'submit',
        selector: "form[action*='/search']",
        wait: true
      }
    ],
    data: {
      origem: 'custom-event'
    }
  }
}));

Capturar o retorno da execução

Após receber o pedido, o content script devolve o resultado pelo evento dabliorobo:execute-workflow:result. Este retorno informa se o fluxo foi recebido, se foi iniciado e qual o erro em caso de bloqueio.

window.addEventListener('dabliorobo:execute-workflow:result', function (event) {
  console.log('Resultado Dablio Robô:', event.detail);

  if (event.detail.ok) {
    console.log('Fluxo recebido e iniciado:', event.detail.instanceId);
  } else {
    console.error('Falha ao iniciar fluxo:', event.detail.error);
  }
});

Validação de segurança com runToken

Principais erros de bloqueio

O bloco Gatilho é o ponto de partida obrigatório de qualquer fluxo. Ele define quando e como o fluxo será iniciado. Cada fluxo deve ter exatamente um Trigger.

Define como e quando o fluxo começa. Suporta disparo manual, por intervalo, dia da semana, quando visita um site, numa data/hora específica, quando abre o browser, por menu de contexto ou atalho de teclado.

// Disparar pelo ID do fluxo
window.dispatchEvent(new CustomEvent('dabliorobo:execute-workflow', {
  detail: { id: 'workflow-id' }
}));

// Passar variáveis para o fluxo
window.dispatchEvent(new CustomEvent('dabliorobo:execute-workflow', {
  detail: {
    id: 'workflow-id',
    data: {
      variables: {
        nome: 'João Silva',
        busca: 'produto XYZ'
      }
    }
  }
}));

Chama outro fluxo como sub-rotina. O fluxo filho recebe automaticamente as variáveis ​​e tabelas do pai e, após a conclusão, o pai continua normalmente pelo caminho padrão.

Executa outro fluxo de trabalho a partir deste ponto. Partilha automaticamente variáveis, tabelas e o separador alvo entre o fluxo pai e o filho.

Verifica em tempo real se outro fluxo está a ser executado neste momento. Útil para evitar execuções paralelas ou aguardar que um fluxo concorrente termine.

Verifica se um fluxo específico está a ser executado neste momento. Retorna verdadeiro (em execução) ou falso (parado).

Interrompe a execução do fluxo atual ou de outros fluxos em curso. Pode terminar com o estado de Sucesso ou lançar um Erro para ativar os blocos de tratamento de falhas.

Interrompe a execução do fluxo atual ou de outros fluxos em curso. Pode terminar com sucesso ou lançar um erro.

Pausa a execução durante o tempo configurado antes de avançar para o bloco seguinte. Essencial para aguardar carregamentos, animações de página e janelas de tempo entre ações.

Faz uma pausa na execução do fluxo durante um tempo configurado em milissegundos antes de avançar para o bloco seguinte.

Exporta os dados recolhidos pelo fluxo para ficheiros locais. Suporta tabelas de dados, variáveis ​​individuais e conteúdo personalizado, com múltiplos formatos de saída.

Exporta os dados recolhidos (tabelas, variáveis ou texto personalizado) para um ficheiro local em vários formatos.

Realiza pedidos HTTP/HTTPS para APIs externas. Suporta todos os verbos REST, autenticação através de cabeçalhos, múltiplos formatos de corpo e tipos de resposta.

Faz um pedido HTTP para APIs ou serviços externos. Suporta todos os métodos, cabeçalhos personalizados, tipos de corpo e recebe a resposta como JSON, texto ou Base64.

Authorization: Bearer {{meuToken}}
Content-Type: application/json
X-Api-Key: minha-chave-secreta

{
  "status": 200,
  "data": {
    "nome": "Lista de preços",
    "valores": [
      { "id": 1, "preco": 4000 },
      { "id": 2, "preco": 24000 }
    ]
  }
}

[
  ["campo", "valor"],
  ["arquivo", "C:\\Downloads\\documento.pdf"],
  ["imagem", "https://exemplo.com/foto.png"]
]

{
  "nome": "{{nomeCliente}}",
  "email": "{{emailCliente}}",
  "total": {{valorTotal}}
}

Lê ou escreve dados na área de transferência do sistema (Ctrl+C/Ctrl+V). Útil para transferir dados entre o fluxo e o sistema operativo.

Copia texto para a área de transferência do sistema ou lê o conteúdo atual copiado pelo utilizador.

Espera que todos os blocos anteriores ligados terminem antes de continuar. Útil para sincronizar fluxos paralelos.

Agrupa visualmente outros blocos dentro de um contentor para organizar e estruturar o fluxo. Não executa qualquer ação por si só.

Bloco de anotação visual. Não executa qualquer ação durante o fluxo. Serve exclusivamente para documentar e organizar o canvas.

Apresenta alertas visuais para o utilizador: como notificações nativas do Windows (canto do ecrã) ou como popups flutuantes dentro da página ativa no browser.

Apresenta uma notificação para o utilizador no sistema operativo Windows e/ou como popup HTML dentro da página ativa, com diferentes estilos visuais.

Reproduz um alerta sonoro para chamar a atenção do utilizador durante ou após a execução de tarefas. Útil quando o fluxo corre em segundo plano.

Toca um alerta sonoro durante um tempo determinado. Útil para sinalizar a conclusão de tarefas ou eventos importantes.

Exibe uma sobreposição semitransparente com indicador de carregamento sobre a página, impedindo o utilizador de clicar ou interagir enquanto o robô trabalha.

Apresenta um ecrã de bloqueio com indicador de carregamento para impedir a interação do utilizador enquanto o fluxo está em execução.

Apresenta uma janela modal interativa dentro da página. Pode ser simples (informação com OK) ou um mini-formulário com campos de texto, selects e múltiplos botões de acção.

Apresenta uma caixa de diálogo no ecrã e aguarda a ação do utilizador. Suporta múltiplos botões de resposta, campos de texto, selects e checkboxes.

Define qual o separador do browser que será o alvo dos próximos blocos. Altera o contexto de execução para o separador encontrado pelo critério configurado.

Foca-se numa aba específica e define-a como alvo para todos os próximos blocos do fluxo.

Abre um novo separador no browser com o URL configurado e oferece controlo total sobre a janela, identificação e comportamento de carregamento.

Abre um novo separador no browser com controlos avançados de janela, identificação de página e aguardo de carregamento completo.

Alterna o foco de execução para outro separador já aberto no browser, identificado por URL, título, índice ou posição relativa.

Alterna o foco para outro separador com base no URL, título, índice, posição relativa ou página guardada.

Abre uma nova janela do browser, separada dos separadores atuais. Suporta o modo privado/anónimo, popups sem barra de endereço e dimensões personalizadas.

Abre uma nova janela do browser com opções avançadas: modo privado/anónimo, tipo, estado inicial e dimensões personalizadas.

Navega para a página anterior no histórico do separador ativo, equivalente ao botão Voltar do browser.

Volta à página anterior no separador ativo, equivalente ao botão Voltar do browser.

Navega para a página seguinte no histórico do separador ativo (apenas se existir), equivalente ao botão Seguinte do browser.

Avança para a página seguinte no separador ativo, equivalente ao botão Seguinte do navegador.

Fecha separadores ou janelas específicas durante o fluxo. Suporta múltiplos critérios de seleção e pode fechar mais do que um separador de uma só vez.

Fecha separadores ou janelas por critério: separador ativo, separador visível, janela, por URL, título, índice ou página guardada. Suporta fechar múltiplos.

Capta imagens do ecrã em 4 modos: área visível da página, página completa com scroll, elemento específico ou elemento completo com altura superior ao ecrã.

Tira uma captura de ecrã da área visível, página completa, elemento específico ou elemento completo com scroll.

Faz uma pausa no fluxo aguardando um evento específico do browser ou da página: separador aberto/fechado, clique, digitação, envio de formulários, scroll e muito mais.

Faz uma pausa no fluxo até que um evento específico ocorra no browser ou num elemento da página.

Configura um servidor proxy para toda a navegação do browser, útil para contornar restrições geográficas ou rotacionar IPs em automatizações de scraping.

Configura um servidor Proxy (HTTP/HTTPS/SOCKS4/SOCKS5) para toda a ligação do browser ou remove a configuração atual.

Muda o contexto de execução para dentro de um <iframe> na página. Necessário quando o elemento com o qual se pretende interagir está dentro de um frame embebido.

Muda o foco de execução para um iFrame específico da página ou volta para a página principal.

Controla o modo de visualização da janela do browser ou de elementos específicos da página, útil para capturas de ecrã e sistemas que exijam ecrã completo.

Altera o modo de visualização: janela (normal/maximizado/minimizado/ecrã inteiro), página inteira ou expande um elemento específico.

Recarrega um ou mais separadores do browser, equivalente ao F5. Útil para atualizar dados em dashboards ou após modificações que exijam recarga.

Recarrega um ou mais separadores por critério: separador ativo, visível, por título, índice ou URL.

Captura o URL e/ou o título de separadores abertos e guarda-os em variáveis do fluxo para utilização posterior.

Obtém o URL e/ou o título de um ou mais separadores abertos e guarda-os em variáveis.

Gere cookies do navegador para sites específicos: lê valores, cria/atualiza ou remove cookies de sessão.

Lê, cria, atualiza ou remove cookies do site atual.

Interceta e gere downloads de ficheiros: pode aguardar que um download inicie, descarregar diretamente por URL ou extrair media (imagens, vídeos, áudios) de elementos da página.

Aguarda um download iniciar, descarrega ficheiro por URL direto ou extrai media (img, audio, video) de elementos da página.

Realiza cliques em elementos da página utilizando seletores CSS ou XPath. O bloco mais utilizado nas automatizações web.

Clica num ou mais elementos da página utilizando o seletor CSS ou XPath, com suporte para aguardar que o elemento apareça.

Extrai conteúdo de elementos da página: texto puro, HTML interno ou valores de campos de formulário. Guarda em variável para utilização nos blocos seguintes.

Extrai texto, HTML interno ou valores de elementos da página. Suporta múltiplos elementos (retorna array).

O bloco mais versátil para a interação com formulários: preenche campos de texto, seleciona opções, marca checkboxes, clica em radio buttons e pode extrair todos os dados de um formulário de uma só vez.

Interage com formulários: preenche campos de texto, seleciona opções em listas, marca checkboxes e radio buttons, ou extrai dados do formulário.

Desloca a página ou um elemento com scrollbar para uma posição específica ou para apresentar um elemento no ecrã.

Faz scroll na página ou num elemento específico na horizontal e/ou vertical, com suporte de scroll para visualização e animação suave.

Lê, define ou remove atributos HTML de qualquer elemento. Abrange desde os atributos standard (href, src, class) até aos atributos de dados personalizados (data-id, data-value).

Lê, define ou remove atributos HTML de elementos como href, src, class, style, data-id e qualquer outro atributo personalizado.

Injeta e executa JavaScript diretamente na página (contexto MAIN world) ou no service worker. Tem acesso completo ao DOM, às variáveis ​​do fluxo e às APIs da extensão.

Executa JavaScript na página (contexto da página) ou em background (service worker). Utilize 'return' para guardar o resultado numa variável do fluxo.

// Lê variável do fluxo
const usuario = vars.nomeUsuario;

// Manipula DOM
document.querySelector('#campo-login').value = usuario;

// Faz uma requisição assíncrona
const resp = await fetch('/api/verificar?user=' + usuario);
const dados = await resp.json();

// Salva resultado no fluxo
vars.usuarioAtivo = dados.ativo;

// Retorna para variável configurada
return dados.ultimoAcesso;

// Ler variável do fluxo
const cliente = vars.nomeCliente;

// Modificar DOM da página
document.querySelector('#campo-busca').value = cliente;

// Fazer requisição assíncrona (await funciona normalmente)
const resp = await fetch('https://api.exemplo.com/dados?q=' + cliente);
const dados = await resp.json();

// Gravar resultado de volta no fluxo
vars.totalResultados = dados.total;

// Retornar valor para a variável configurada no bloco
return dados.items[0].nome;

Dispara eventos DOM nos elementos da página, simulando interações que outros blocos não cobrem. Essencial para sistemas que apenas respondem a eventos nativos de JavaScript.

Dispara eventos DOM em elementos da página: rato, teclado, formulário, clipboard, touch e outros, com opções avançadas de modificadores e coordenadas.

Simula a passagem do rato sobre um elemento da página (mouseover/hover), revelando menus dropdown, tooltips e conteúdos que apenas aparecem com o cursor sobre o elemento.

Simula a passagem do rato sobre um elemento da página (evento mouseover/hover), útil para exibir menus, tooltips e conteúdos dinâmicos.

Simula a ação de arrastar e largar (drag and drop) elementos da página. Útil para interfaces com frames Kanban, ordenação de listas, sliders e ferramentas de edição.

Simula o arrastar de um elemento de um ponto A para um ponto B com as definições de posição, velocidade e botão premido.

Realiza o upload de ficheiros em campos input[type=file], contornando a limitação de que o browser não permite a automatização direta do seletor de ficheiros do sistema operativo.

Faz o upload de ficheiros via URL/Base64, pasta local, caminho absoluto ou simula clique para o utilizador selecionar manualmente.

Simula o pressionar de teclas e atalhos do teclado, ou digita um texto completo tecla a tecla com timing configurável.

Pressiona um atalho de teclado (ex: CTRL+S) ou digita um texto tecla a tecla, com foco opcional em elemento alvo.

Injeta HTML, CSS e JavaScript personalizados diretamente na página numa posição relativa ao elemento alvo. Permite estender visualmente qualquer site sem modificar o seu código.

Insere código HTML, CSS e JavaScript na página numa posição específica em relação ao elemento alvo.

<div style='position:fixed;bottom:20px;right:20px;z-index:9999;background:#1a6eff;color:white;padding:12px 20px;border-radius:8px;cursor:pointer;font-family:sans-serif;box-shadow:0 4px 20px rgba(26,110,255,0.4)' onclick='window.__dablioExportar()'>&#128190; Exportar Dados</div>
<script>
window.__dablioExportar = function(){
  window.dispatchEvent(new CustomEvent('dablio-export'));
};
</script>

Verifica se um elemento está presente no DOM da página, com múltiplas tentativas configuráveis antes de concluir. Retorna exists ou fallback.

Verifica se um elemento existe na página com múltiplas tentativas antes de seguir pela porta de sucesso ou fallback.

Lê o atributo href de um elemento de link e navega para o destino — mais robusto do que clicar diretamente pois não depende de comportamentos CSS ou JavaScript do link.

Lê o atributo href de um elemento e navega para o link no mesmo separador, novo separador ou nova janela.

Verifica a existência de um ficheiro numa pasta local antes de tentar processá-lo, evitando erros em fluxos que dependem de ficheiros externos.

Verifica se um ficheiro existe numa pasta local selecionada. Suporta a pesquisa por nome exato, nome base ou expressão regular.

Bloco de decisão que compara dois valores e direciona o fluxo para o caminho Verdadeiro ou Falso.

Compara dois valores e direciona o fluxo pelo caminho Verdadeiro ou Falso. Suporta valores literais, variáveis, textos de elementos, atributos HTML e código JavaScript.

Itera sobre todos os elementos encontrados por um selector, executando os blocos internos para cada um. O equivalente do forEach em automação web.

Percorre todas as ocorrências de um selector CSS/XPath executando os blocos internos para cada elemento encontrado.

/* Se o identificador do loop for "linha" */
[wRobo-loop="linha_0"]              /* primeiro elemento */
[wRobo-loop="linha_0"] td:nth-child(2)  /* segunda coluna do primeiro elemento */
[wRobo-loop="linha_0"] .btn-acao    /* botão dentro do primeiro elemento */

Repete os blocos interiores um número fixo de vezes. O equivalente de um loop for(i=0; i<N; i++).

Repete os blocos internos um número definido de vezes.

/* URL na Nova aba (loopIndex começa em 0, então somamos 1) */
https://site.com/produtos?pagina={{loopIndex + 1}}

/* Ou inicialize uma variável separada e use Incrementar Variável */
https://site.com/produtos?pagina={{pagina}}

Itera sobre listas de dados: arrays de variáveis, intervalos numéricos ou dados JSON personalizados. O item atual é acessível através da variável configurada.

Percorre uma lista (array de variáveis, números sequenciais ou dados JSON) repetindo os blocos internos para cada item.

Interrompe imediatamente o ciclo mais próximo (Repetir tarefas, Percorrer dados ou Percorrer elementos) e continua o fluxo após o bloco de ciclo.

Interrompe imediatamente o ciclo ou repetição mais próxima (Repetir tarefas, Percorrer dados ou Percorrer elementos).

O bloco de criação de variáveis mais direto: define o valor de uma variável, adiciona dados a uma tabela do fluxo ou lê conteúdo de ficheiros.

Preenche variáveis, tabelas do fluxo ou tabelas do armazenamento local. Aceita texto manual, variáveis ​​e conteúdo de ficheiros.

Transforma e extrai dados de variáveis existentes: fatiamento de strings, extração por tipo de conteúdo e expressões regulares.

Cria, atualiza ou extrai partes de um conteúdo para uma nova variável. Suporta slice de texto/dados, extração por tipo e expressões regulares.

Incrementa ou decrementa um valor numérico de uma variável numa quantidade configurada. O bloco mais simples para criar contadores.

Incrementa ou decrementa o valor numérico de uma variável num determinado valor.

/* Antes do loop: Inserir dados */
Variável: pagina
Valor: 1

/* URL na Nova aba */
https://site.com/lista?page={{pagina}}

/* Dentro do loop: Incrementar variável */
Variável: pagina
Incremento: 1

Remove uma variável da memória do fluxo. Útil para libertar espaço em fluxos longos ou garantir que as variáveis ​​não transportam valores de iterações anteriores.

Remove uma variável ou dado da memória durante a execução do fluxo.

Realiza cálculos matemáticos com suporte a funções especializadas para cenários empresariais brasileiros, incluindo a formatação de moeda em Real (BRL).

Realiza cálculos matemáticos com operadores padrão e funções especializadas, incluindo a conversão de moeda brasileira.