Este recurso permite executar um fluxo temporário, montado em memória, sem criar e salvar previamente um fluxo no Dablio Robô. O JSON pode ser enviado pela própria 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 precisam acionar automações locais no navegador e cenários onde o fluxo é gerado dinamicamente por uma aplicação externa.

Parâmetros disponíveis na 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 da 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 pela URL

Neste formato você envia o workflow inteiro, semelhante a um fluxo exportado pelo Dablio Robô. O fluxo não será salvo 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 pela URL

Neste formato você envia apenas uma lista de comandos. O robô monta automaticamente o bloco inicial, os blocos intermediários e as conexõ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 aceitos em comandos curtos

Enviar variáveis junto com o fluxo

Use dablioroboData para enviar dados iniciais para a execução. Esses 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 via CustomEvent

Use este formato quando a página já está aberta e você quer acionar a automação por JavaScript, sem recarregar a 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 via 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. Esse retorno informa se o fluxo foi recebido, se foi iniciado e qual foi 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 Gatilho.

Define como e quando o fluxo começa. Suporta disparo manual, por intervalo, dia da semana, ao visitar um site, em data/hora específica, ao abrir o navegador, 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 concluir, o pai continua normalmente pelo caminho padrão.

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

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

Verifica se um fluxo específico está em execução neste momento. Retorna true (em execução) ou false (parado).

Interrompe a execução do fluxo atual ou de outros fluxos em andamento. Pode encerrar com status de Sucesso ou lançar um Erro para ativar blocos de tratamento de falha.

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

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

Pausa a execução do fluxo por um tempo configurado em milissegundos antes de avançar para o próximo bloco.

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

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

Realiza requisições HTTP/HTTPS para APIs externas. Suporta todos os verbos REST, autenticação via cabeçalhos, múltiplos formatos de corpo e tipos de resposta.

Faz uma requisição 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 grava dados na área de transferência do sistema (Ctrl+C/Ctrl+V). Útil para transferir dados entre o fluxo e o sistema operacional.

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

Espera todos os blocos anteriores conectados terminarem antes de continuar. Útil para sincronizar fluxos paralelos.

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

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

Exibe alertas visuais para o usuário: como notificações nativas do Windows (canto da tela) ou como popups flutuantes dentro da página ativa no navegador.

Exibe uma notificação para o usuário no sistema operacional Windows e/ou como popup HTML dentro da página ativa, com diferentes estilos visuais.

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

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

Exibe uma sobreposição semitransparente com indicador de carregamento sobre a página, impedindo que o usuário clique ou interaja enquanto o robô trabalha.

Exibe uma tela de bloqueio com indicador de carregamento para impedir interação do usuário enquanto o fluxo está em execução.

Exibe 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 ação.

Exibe uma caixa de diálogo na tela e aguarda a ação do usuário. Suporta múltiplos botões de resposta, campos de texto, selects e checkboxes.

Define qual aba do navegador será o alvo dos próximos blocos. Muda o contexto de execução para a aba encontrada pelo critério configurado.

Foca em uma aba específica e define ela como alvo para todos os próximos blocos do fluxo.

Abre uma nova aba no navegador com a URL configurada e oferece controle total sobre janela, identificação e comportamento de carregamento.

Abre uma nova aba no navegador com controles avançados de janela, identificação de página e aguardo de carregamento completo.

Alterna o foco de execução para outra aba já aberta no navegador, identificada por URL, título, índice ou posição relativa.

Alterna o foco para outra aba baseado em URL, título, índice, posição relativa ou página salva.

Abre uma nova janela do navegador, separada das abas atuais. Suporta modo privado/anônimo, popups sem barra de endereço e dimensões customizadas.

Abre uma nova janela do navegador 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 da aba ativa, equivalente ao botão Voltar do navegador.

Volta para a página anterior na aba ativa, equivalente ao botão Voltar do navegador.

Navega para a página seguinte no histórico da aba ativa (apenas se existir), equivalente ao botão Avançar do navegador.

Avança para a próxima página na aba ativa, equivalente ao botão Avançar do navegador.

Fecha abas ou janelas específicas durante o fluxo. Suporta múltiplos critérios de seleção e pode fechar mais de uma aba de uma vez.

Fecha abas ou janelas por critério: aba ativa, aba visível, janela, por URL, título, índice ou página salva. Suporta fechar múltiplos.

Captura imagens da tela em 4 modos: área visível da página, página completa com scroll, elemento específico ou elemento completo com altura maior que a tela.

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

Pausa o fluxo aguardando um evento específico do navegador ou da página: aba aberta/fechada, clique, digitação, envio de formulário, scroll e muito mais.

Pausa o fluxo até que um evento específico ocorra no navegador ou em um elemento da página.

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

Configura um servidor Proxy (HTTP/HTTPS/SOCKS4/SOCKS5) para toda a conexão do navegador 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 que você quer interagir está dentro de um frame embutido.

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 exibição da janela do navegador ou de elementos específicos da página, útil para capturas de tela e sistemas que exigem tela cheia.

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

Recarrega uma ou mais abas do navegador, equivalente ao F5. Útil para atualizar dados em dashboards ou após modificações que requerem recarga.

Recarrega uma ou mais abas por critério: aba ativa, visível, por título, índice ou URL.

Captura a URL e/ou o título de abas abertas e os salva em variáveis do fluxo para uso posterior.

Obtém a URL e/ou o título de uma ou mais abas abertas e salva em variáveis.

Gerencia 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.

Intercepta e gerencia downloads de arquivos: pode aguardar um download iniciar, baixar diretamente por URL ou extrair mídias (imagens, vídeos, áudios) de elementos da página.

Aguarda um download iniciar, baixa arquivo por URL direta ou extrai mídias (img, audio, video) de elementos da página.

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

Clica em um ou mais elementos da página usando seletor CSS ou XPath, com suporte a aguardar o elemento aparecer.

Extrai conteúdo de elementos da página: texto puro, HTML interno ou valores de campos de formulário. Salva em variável para uso 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 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.

Rola a página ou um elemento com scrollbar para uma posição específica ou para exibir um elemento na tela.

Rola a página ou um elemento específico na horizontal e/ou vertical, com suporte a rolar para visualização e animação suave.

Lê, define ou remove atributos HTML de qualquer elemento. Cobre desde atributos padrão (href, src, class) até atributos de dados customizados (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, variáveis do fluxo e APIs da extensão.

Executa JavaScript na página (contexto da página) ou em background (service worker). Use 'return' para salvar o resultado em uma 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 em elementos da página, simulando interações que outros blocos não cobrem. Essencial para sistemas que respondem apenas a eventos JavaScript nativos.

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

Simula passar o mouse sobre um elemento da página (mouseover/hover), revelando menus dropdown, tooltips e conteúdos que só aparecem com o cursor sobre o elemento.

Simula passar o mouse 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 soltar (drag and drop) elementos da página. Útil para interfaces com quadros Kanban, ordenação de listas, sliders e ferramentas de edição.

Simula arrastar um elemento de um ponto A até um ponto B com configurações de posição, velocidade e botão pressionado.

Realiza upload de arquivos em campos input[type=file], contornando a limitação de que o navegador não permite automação direta do seletor de arquivos do sistema operacional.

Faz upload de arquivos via URL/Base64, pasta local, caminho absoluto ou simula clique para o usuário selecionar manualmente.

Simula o pressionamento de teclas e atalhos do teclado, ou digita um texto completo tecla por 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 em uma posição relativa ao elemento alvo. Permite estender visualmente qualquer site sem modificar seu código.

Insere código HTML, CSS e JavaScript na página em uma 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 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 na mesma aba, nova aba ou nova janela.

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

Verifica se um arquivo existe em uma pasta local selecionada. Suporta busca 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 seletor, executando os blocos internos para cada um. O equivalente do forEach em automação web.

Percorre todas as ocorrências de um seletor 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 internos 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 customizados. O item atual é acessível via a variável configurada.

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

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

Interrompe imediatamente o loop 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 arquivos.

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

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 em uma quantidade configurada. O bloco mais simples para criar contadores.

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

/* 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 liberar espaço em fluxos longos ou garantir que variáveis não carreguem 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 formatação de moeda em Real (BRL).

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