Esta característica le permite ejecutar un flujo temporal, ensamblado en la memoria, sin crear y guardar previamente un flujo en Dablio Robô. JSON se puede enviar a través de la URL de la página o mediante un evento de JavaScript CustomEvent.

Se recomienda para integraciones entre sistemas, paneles internos, ERP, enlaces de acción rápida, webhooks indirectos, páginas que necesitan activar automatizaciones locales en el navegador y escenarios donde el flujo es generado dinámicamente por una aplicación externa.

Parámetros disponibles en la URL

Cómo codificar JSON a Base64URL

los parametros dablioroboWorkflow, dablioroboCommands y dablioroboData debe enviarse como Base64URL para evitar problemas con comillas, acentos, llaves, barras, espacios y caracteres especiales dentro de la 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);

Ejemplo 1: enviar el flujo de trabajo completo a través de URL

En este formato envías todo el flujo de trabajo, similar a un flujo exportado por Dablio Robô. La transmisión no se guardará en el almacenamiento 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

Ejemplo 2: enviar comandos secuenciales a través de URL

En este formato solo envías una lista de comandos. El robot ensambla automáticamente el bloque inicial, los bloques intermedios y las conexiones secuenciales.

[
  {
    "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

Alias aceptados en comandos cortos

Enviar variables junto con el flujo.

uso dablioroboData para enviar datos iniciales para la ejecución. Estos datos ingresan al contexto del flujo y los bloques pueden consumirlos como variables.

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

Ejemplo 3: ejecutar un flujo de trabajo temporal a través de CustomEvent

Utilice este formato cuando la página ya esté abierta y desee activar la automatización a través de JavaScript, sin recargar la 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'
    }
  }
}));

Ejemplo 4: ejecutar comandos a través de 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 comentarios de ejecución

Después de recibir la solicitud, el script de contenido devuelve el resultado a través del evento dabliorobo:execute-workflow:result. Esta devolución informa si se recibió el flujo, si se inició y cuál fue el error en caso de bloqueo.

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);
  }
});

Validación de seguridad con runToken

Principales errores de bloqueo

el bloque gatillo Es el punto de partida obligatorio de cualquier flujo. Se define cuando y como el flujo comenzará. Cada flujo debe tener exactamente un Trigger.

Define cómo y cuándo comienza el flujo. Admite activación manual, por intervalo, día de la semana, al visitar un sitio web, en una fecha/hora específica, al abrir el navegador, por menú contextual o método abreviado 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'
      }
    }
  }
}));

Llama a otro flujo como una subrutina. El flujo secundario recibe automáticamente las variables y tablas del padre y, una vez completado, el padre continúa normalmente por la ruta predeterminada.

Ejecuta otro flujo de trabajo desde este punto. Comparte automáticamente variables, tablas y la pestaña de destino entre el flujo principal y el secundario.

Comprueba en tiempo real si en ese momento se está ejecutando otro flujo. Útil para evitar ejecuciones paralelas o esperar a que finalice una transmisión simultánea.

Comprueba si un flujo específico se está ejecutando actualmente. Devuelve verdadero (en ejecución) o falso (detenido).

Detiene la ejecución del flujo actual u otros flujos en curso. Puede terminar con el estado de Éxito o generar un Error para activar bloques de manejo de fallas.

Detiene la ejecución del flujo actual u otros flujos en curso. Puede terminar exitosamente o arrojar un error.

Pausa la ejecución durante el tiempo configurado antes de avanzar al siguiente bloque. Esencial para esperar cargas, animaciones de páginas y ventanas de tiempo entre acciones.

Detiene la ejecución del flujo durante un tiempo configurado en milisegundos antes de avanzar al siguiente bloque.

Exporta los datos recopilados por el flujo a archivos locales. Admite tablas de datos, variables individuales y contenido personalizado, con múltiples formatos de salida.

Exporta datos recopilados (tablas, variables o texto personalizado) a un archivo local en varios formatos.

Realiza solicitudes HTTP/HTTPS a API externas. Admite todos los verbos REST, autenticación mediante encabezados, múltiples formatos de cuerpo y tipos de respuesta.

Realiza una solicitud HTTP a API o servicios externos. Admite todos los métodos, encabezados personalizados, tipos de cuerpo y recibe la respuesta como JSON, texto o 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}}
}

Lee o escribe datos en el portapapeles del sistema (Ctrl+C/Ctrl+V). Útil para transferir datos entre la transmisión y el sistema operativo.

Copia texto al portapapeles del sistema o lee el contenido actual copiado por el usuario.

Espera a que finalicen todos los bloques conectados anteriormente antes de continuar. Útil para sincronizar transmisiones paralelas.

Agrupa visualmente otros bloques dentro de un contenedor para organizar y estructurar el flujo. No realiza ninguna acción por sí solo.

Bloc de notas visuales. No realiza ninguna acción durante el flujo. Se utiliza exclusivamente para documentar y organizar el lienzo.

Muestra alertas visuales al usuario: como notificaciones nativas de Windows (esquina de la pantalla) o como ventanas emergentes flotantes dentro de la página activa en el navegador.

Muestra una notificación al usuario en el sistema operativo Windows y/o como una ventana emergente HTML dentro de la página activa, con diferentes estilos visuales.

Reproduce una alerta audible para atraer la atención del usuario durante o después de realizar tareas. Útil cuando la transmisión se ejecuta en segundo plano.

Reproduce una alerta audible durante un tiempo determinado. Útil para señalar la finalización de tareas o eventos importantes.

Muestra una superposición semitransparente con un indicador de carga sobre la página, lo que evita que el usuario haga clic o interactúe mientras el robot funciona.

Muestra una pantalla de bloqueo con indicador de carga para evitar la interacción del usuario mientras se ejecuta el flujo.

Muestra una ventana modal interactiva dentro de la página. Puede ser simple (información con OK) o un miniformulario con campos de texto, selecciones y múltiples botones de acción.

Muestra un cuadro de diálogo en la pantalla y espera la acción del usuario. Admite múltiples botones de respuesta, campos de texto, selecciones y casillas de verificación.

Define qué pestaña del navegador será el destino de los siguientes bloques. Cambia el contexto de ejecución a la pestaña encontrada por los criterios configurados.

Se centra en una pestaña específica y la define como el destino de todos los bloques futuros del flujo.

Abre una nueva pestaña en el navegador con la URL configurada y ofrece control total sobre la ventana, la identificación y el comportamiento de carga.

Abre una nueva pestaña en el navegador con controles avanzados de ventana, identificación de página y espera de carga completa.

Cambia el foco de ejecución a otra pestaña ya abierta en el navegador, identificada por URL, título, índice o posición relativa.

Cambie el foco a otra pestaña según la URL, el título, el índice, la posición relativa o la página guardada.

Abre una nueva ventana del navegador, separada de las pestañas actuales. Admite modo privado/incógnito, ventanas emergentes sin barra de direcciones y dimensiones personalizadas.

Abre una nueva ventana del navegador con opciones avanzadas: modo privado/incógnito, tipo, estado inicial y dimensiones personalizadas.

Navega a la página anterior en el historial de la pestaña activa, equivalente al botón Atrás del navegador.

Vuelve a la página anterior en la pestaña activa, equivalente al botón Atrás del navegador.

Navega a la página siguiente en el historial de la pestaña activa (solo si existe), equivalente al botón Siguiente del navegador.

Avanza a la página siguiente en la pestaña activa, equivalente al botón Siguiente del navegador.

Cierra pestañas o ventanas específicas durante la transmisión. Admite múltiples criterios de selección y puede cerrar más de una pestaña a la vez.

Cierra pestañas o ventanas por criterio: pestaña activa, pestaña visible, ventana, por URL, título, índice o página guardada. Admite cierres múltiples.

Captura imágenes de pantalla en 4 modos: área visible de la página, página completa con desplazamiento, elemento específico o elemento completo con una altura mayor que la pantalla.

Toma una captura de pantalla del área visible, página completa, elemento específico o elemento completo con desplazamiento.

Detiene el flujo esperando un evento específico del navegador o de la página: abrir/cerrar pestañas, hacer clic, escribir, enviar formularios, desplazarse y más.

Pausa el flujo hasta que ocurre un evento específico en el navegador o en un elemento de la página.

Configura un servidor proxy para toda la navegación del navegador, útil para evitar restricciones geográficas o rotar IP en automatizaciones de scraping.

Configure un servidor Proxy (HTTP/HTTPS/SOCKS4/SOCKS5) para toda la conexión del navegador o elimine la configuración actual.

Cambia el contexto de ejecución a un <iframe> en la página. Requerido cuando el elemento con el que desea interactuar está dentro de un marco en línea.

Cambia el foco de ejecución a un iFrame específico en la página o regresa a la página principal.

Controla cómo se muestran la ventana del navegador o elementos específicos de la página, útil para capturas de pantalla y sistemas que requieren pantalla completa.

Cambia el modo de visualización: ventana (normal/maximizada/minimizada/pantalla completa), página completa o expande un elemento específico.

Recarga una o más pestañas del navegador, equivalente a F5. Útil para actualizar datos en paneles o después de modificaciones que requieren recarga.

Recarga una o más pestañas por criterios: pestaña activa, visible, por título, índice o URL.

Captura la URL y/o el título de las pestañas abiertas y las guarda en variables de flujo para su uso posterior.

Obtiene la URL y/o el título de una o más pestañas abiertas y lo guarda en variables.

Gestiona las cookies del navegador para sitios web específicos: lee valores, crea/actualiza o elimina cookies de sesión.

Lee, crea, actualiza o elimina cookies del sitio web actual.

Intercepta y gestiona descargas de archivos: puede esperar a que se inicie una descarga, descargarla directamente a través de URL o extraer medios (imágenes, vídeos, audios) de los elementos de la página.

Espere a que comience una descarga, descargue el archivo a través de una URL directa o extraiga medios (img, audio, video) de los elementos de la página.

Hace clic en elementos de la página utilizando selectores CSS o XPath. El bloque más utilizado en automatizaciones web.

Haga clic en uno o más elementos de la página utilizando el selector CSS o XPath, con soporte para esperar a que aparezca el elemento.

Extrae contenido de los elementos de la página: texto sin formato, HTML interno o valores de campos de formulario. Lo guarda en una variable para usarlo en bloques posteriores.

Extrae texto, HTML interno o valores de los elementos de la página. Admite múltiples elementos (devuelve una matriz).

El bloque más versátil para interactuar con formularios: complete campos de texto, seleccione opciones, marque casillas de verificación, haga clic en botones de opción y pueda extraer todos los datos de un formulario a la vez.

Interactúe con formularios: complete campos de texto, seleccione opciones de listas, marque casillas de verificación y botones de opción, o extraiga datos del formulario.

Desplaza la página o un elemento con barra de desplazamiento a una posición específica o para mostrar un elemento en la pantalla.

Desplaza la página o un elemento específico horizontal y/o verticalmente, con soporte de desplazamiento para una vista previa y animación fluidas.

Lee, establece o elimina atributos HTML de cualquier elemento. Cubre desde atributos estándar (href, src, class) hasta atributos de datos personalizados (data-id, data-value).

Lee, establece o elimina atributos HTML de elementos como href, src, clase, estilo, data-id y cualquier otro atributo personalizado.

Inyecta y ejecuta JavaScript directamente en la página (contexto mundial PRINCIPAL) o trabajador del servicio. Tiene acceso completo al DOM, variables de flujo y API de extensión.

Ejecuta JavaScript en la página (contexto de la página) o en segundo plano (trabajador de servicio). Utilice 'retorno' para guardar el resultado en una variable de secuencia.

// 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;

Activa eventos DOM en elementos de la página, simulando interacciones que otros bloques no cubren. Esencial para sistemas que solo responden a eventos de JavaScript nativos.

Activa eventos DOM en elementos de la página: mouse, teclado, formulario, portapapeles, toque y otros, con opciones avanzadas de modificación y coordenadas.

Simula pasar el cursor sobre un elemento de la página (mouseover/flotar), revelando menús desplegables, información sobre herramientas y contenido que solo aparecen con el cursor sobre el elemento.

Simula pasar el mouse sobre un elemento de la página (evento mouseover/hover), útil para mostrar menús, información sobre herramientas y contenido dinámico.

Simula la acción de arrastrar y soltar elementos de la página. Útil para interfaces con tableros Kanban, ordenación de listas, controles deslizantes y herramientas de edición.

Simula arrastrar un elemento desde el punto A al punto B con ajustes de posición, velocidad y pulsación de botón.

Cargar archivos en campos input[type=file], saltándose la limitación de que el navegador no permite la automatización directa del selector de archivos del sistema operativo.

Carga archivos a través de URL/Base64, carpeta local, ruta absoluta o simula un clic para que el usuario los seleccione manualmente.

Simula pulsaciones de teclas y atajos de teclado, o escribe texto completo tecla por tecla con sincronización configurable.

Presione un método abreviado de teclado (por ejemplo, CTRL+S) o escriba texto tecla por tecla, con foco opcional en el elemento de destino.

Inyecta HTML, CSS y JavaScript personalizados directamente en la página en una posición relativa al elemento de destino. Le permite ampliar visualmente cualquier sitio web sin modificar su código.

Inserta código HTML, CSS y JavaScript en la página en una posición específica en relación con el elemento de destino.

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

Comprueba si un elemento está presente en el DOM de la página, con múltiples reintentos configurables antes de completarlo. Regresar existe o respaldo.

Comprueba si existe un elemento en la página con múltiples intentos antes de pasar por el puerto exitoso o alternativo.

Leer el atributo href de un elemento de enlace y navega hasta el destino: es más robusto que hacer clic directamente, ya que no depende de los comportamientos CSS o JavaScript del enlace.

Lee el atributo href de un elemento y navega hasta el enlace en la misma pestaña, nueva pestaña o nueva ventana.

Comprueba la existencia de un archivo en una carpeta local antes de intentar procesarlo, evitando errores en flujos que dependen de archivos externos.

Comprueba si existe un archivo en una carpeta local seleccionada. Admite búsqueda por nombre exacto, nombre base o expresión regular.

Bloque de decisión que compara dos valores y dirige el flujo al camino. Verdadero o Falso.

Compara dos valores y dirige el flujo a lo largo de la ruta Verdadero o Falso. Admite valores literales, variables, textos de elementos, atributos HTML y código JavaScript.

Itera sobre todos los elementos encontrados por un selector, ejecutando los bloques internos para cada uno. El equivalente de forEach en automatización web.

Recorre todas las apariciones de un selector CSS/XPath ejecutando los bloques 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 */

Repite bloques internos un número fijo de veces. El equivalente a un bucle. for(i=0; i<N; i++).

Repite bloques internos un número determinado de veces.

/* 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 datos: matrices de variables, rangos numéricos o datos JSON personalizados. Se puede acceder al elemento actual a través de la variable configurada.

Itera a través de una lista (matriz de variables, números secuenciales o datos JSON) repitiendo los bloques internos de cada elemento.

Rompe inmediatamente el bucle más cercano (repetir tareas, atravesar datos o atravesar elementos) y continúa el flujo después del bloque del bucle.

Detiene inmediatamente el bucle o repetición más cercano (repetir tareas, recorrer datos o recorrer elementos).

El bloque de creación de variables más sencillo: establece el valor de una variable, agrega datos a una tabla de flujo o lee el contenido de los archivos.

Rellena variables, tablas de flujo o tablas de almacenamiento local. Acepta texto manual, variables y contenidos de archivos.

Transforma y extrae datos de variables existentes: corte de cadenas, extracción por tipo de contenido y expresiones regulares.

Crea, actualiza o extrae partes del contenido en una nueva variable. Admite división de texto/datos, extracción por tipo y expresiones regulares.

Incrementa o disminuye un valor numérico de una variable en una cantidad configurada. El bloque más sencillo para crear contadores.

Incrementa o disminuye el valor numérico de una variable en un 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

Elimina una variable de la memoria de flujo. Útil para liberar espacio en transmisiones largas o garantizar que las variables no contengan valores de iteraciones anteriores.

Elimina una variable o datos de la memoria durante la ejecución del flujo.

Realiza cálculos matemáticos con soporte para funciones especializadas para escenarios de negocios brasileños, incluido el formato de moneda en Real (BRL).

Realiza cálculos matemáticos con operadores estándar y funciones especializadas, incluida la conversión de moneda brasileña.