handsbot-maestro-sdk

SDK Python para criar e enfileirar tarefas de automação no Maestro (4HandsBot).

Instalação

pip install handsbot-maestro-sdk

Uso rápido

from maestro import MaestroSDK

sdk = MaestroSDK(
    api_url="https://empresa.com.br/api/v1",
    workspace="",
    login="",
    keypass="",
)

task = sdk.create_task(
    label="minha_automacao",
    parameters=[
        {"label": "destinatario", "value": "admin@empresa.com"},
    ],
)

print(task.uuid, task.status)

Configuração

As credenciais podem ser passadas de duas formas (argumentos têm precedência):

Via variáveis de ambiente

export MAESTRO_API_URL=http://localhost:3001/api/v1
export MAESTRO_WORKSPACE=dev
export MAESTRO_LOGIN=empresa
export MAESTRO_KEYPASS=pass

sdk = MaestroSDK()  # lê as variáveis automaticamente

Via argumentos do construtor

sdk = MaestroSDK(
    api_url="https://empresa.com.br/api/v1",
    workspace="dev",
    login="empresa",
    keypass="pass",
)

create_task

task = sdk.create_task(
    label="nome_da_automacao",       # obrigatório — label cadastrado no Maestro
    parameters=[                      # opcional
        {"label": "param1", "value": "valor1"},
    ],
    priority=1,                       # opcional, padrão 1
    min_execution_date=datetime(...), # opcional — executa somente após esse momento
)

Exceções

Licença

Copyright © 2026 4HandsBot. Todos os direitos reservados.

O uso deste SDK é permitido exclusivamente por clientes autorizados, em conjunto com os serviços da plataforma. É proibida a redistribuição, publicação, sublicenciamento ou utilização fora dessa finalidade.