Getno Assist API
A Getno permite criar automações de navegador com apoio de um Agent LLM apenas no momento da gravação (design do fluxo). Depois, as execuções ocorrem de forma determinística, rápida e sem LLM por trás, garantindo custo previsível e estabilidade.
Nossa documentação traz:
Escopo que isola tudo — créditos, sites, automações, API Keys, chaves de LLM, etc.
Cadastro simples composto por nome e baseURL. Ao criar um site, a plataforma já cria um environment default por baixo dos panos.
Toda execução operacional ocorre dentro de um environment. Um site sempre possui pelo menos um ambiente e, se você não enviar environmentSlug na API, a execução usa automaticamente o environment default do site.
baseUrlproxyIddefaultCredentialIdenvState)environmentSlug. Se omitir, a API resolve o ambiente default do site.Você define nome, objetivo, tipo de saída, instruções detalhadas, parâmetros de entrada (com valores padrão) e, se necessário, um JSON Schema (para saída JSON Object). Credenciais, proxy e URL base são resolvidos por environment.
O Agent LLM (OpenAI) usa suas instruções para gravar um fluxo de ações determinísticas (cliques, inputs, navegação, etc.) no site real.
Depois de criada, a automação pode ser executada em escala via API, reproduzindo exatamente o que foi gravado, sem uso adicional de LLM.
Tipo de saída de uma automação define o que cada execução retorna:
Apenas executa as ações, sem retorno consumível.
A execução baixa um arquivo. O resultado da API será uma URL (com expiração) para baixar o arquivo, sempre comprimido em .zst (Zstandard), com originalName e metadados de expiração.
A execução extrai informações e retorna um JSON estruturado conforme seu JSON Schema.
Descreve a forma do JSON de saída (campos, tipos, obrigatoriedade).
Referência oficial: json-schema.org (especificação e exemplos práticos).
Parâmetros de entrada representam valores que mudam a cada execução. Durante a criação da automação, cada parâmetro deve ter um valor padrão válido (usado apenas no momento da gravação).
Especifique claramente onde o parâmetro entra, usando a sintaxe {{nomeDoParametro}}.
Exemplo:
"No campo 'Pesquisa por CPF e telefone', digite {{cpf}}, {{telefone}} e confirme."
Na execução (via API), você enviará:
{
"inputParameters": {
"cpf": "12345678901",
"telefone": "11988887777"
}
}O executor substituirá {{cpf}}, {{telefone}}, etc., exatamente nos pontos definidos.
Prompts de gravação guiam o Agent LLM a produzir um fluxo determinístico. O agent é inteligente e pode executar ações complexas diretamente quando bem instruído.
O agent pode executar comandos complexos diretamente
Navegação direta:
"Navegue até a URL https://example.com/dashboard e clique no botão 'Relatórios'"Aguardar:
"Após clicar em 'Processar', espere 10 segundos para o sistema processar"Scroll específico:
"Scroll para baixo até encontrar o texto 'Download CSV' e clique nele"Teclas:
"Digite a tecla 'K' para abrir o menu de busca, depois digite 'J' para selecionar"Se a URL da página de destino não é protegida por ação, navegue diretamente para ela.
❌ Ineficiente:
"Clique em 'Menu', depois em 'Relatórios', depois em 'Vendas', depois em 'Mensal'"✅ Eficiente:
"Navegue até https://app.com/relatorios/vendas/mensal e clique em 'Gerar Relatório'"Use parâmetros sempre que algo deve variar entre execuções
Quando valores precisam mudar a cada execução, use parâmetros de entrada com a sintaxe {{nomeParametro}}.
Exemplo de prompt com parâmetros:
"No campo 'Pesquisa por CPF', digite {{cpf}}. No campo 'Telefone', digite {{telefone}}. Clique no botão 'Buscar' e aguarde o resultado carregar. Após os dados aparecerem na tela, clique em 'Exportar PDF' e encerre a tarefa."Execução via API:
{
"inputParameters": {
"cpf": "12345678901",
"telefone": "11988887777"
}
}Evite instruções condicionais ou variáveis que podem gerar comportamentos diferentes.
❌ Evite (não determinístico):
✅ Prefira (determinístico):
Sempre indique quando e como o agent deve encerrar a tarefa.
Exemplos de finalização:
"Após o download do arquivo ser concluído, encerre a tarefa.""Quando aparecer a mensagem 'Pedido criado com sucesso', finalize a execução.""Após clicar em 'Salvar' e ver a confirmação na tela, encerre."Configure webhooks para ser notificado automaticamente quando uma execução finalizar.
x-webhook-secret para autenticação{
"id": "DPD9oUHTmpV8dIsLrORO",
"deliveryDate": "2025-09-09T01:32:05.356711+00:00",
"run": {
"id": "iuCFO7yUk2pyAsMFPKyI",
"runMode": "bot",
"requestedBy": "gta_pMu************************************kUCY",
"startedAt": "2025-09-09T01:31:14.040000+00:00",
"status": "succeeded",
"attempts": 1,
"errorMessage": null
}
}Se o site mudar e algum elemento não for encontrado, a automação entra em autorreparo automaticamente.
Nossa API segue padrões RESTful com arquitetura de URLs aninhadas previsível e legível.
/runs/{runId} → retorna uma run/automations/{automationId} → dados da automação/sites/{siteId} → dados do site/runs → lista de runs/automations → lista de automações/sites → lista de sites/v1 - versionamento explícitox-api-key: YOUR_API_KEY em todas as chamadasenvironmentSlug; se omitido, usam o environment defaultExecuta a automação com parâmetros opcionais
Verifica status da execução
Obtém arquivo ou JSON extraído