Classificação de Aplicativos

Gerencie regras de classificação de aplicativos capturados pelo Task Mining. Categorize atividade digital por contexto operacional da sua empresa.

A autenticação usa o campo key padrão Fhinck.

Endpoints

Endpoint	Método	Descrição
`/listAppClassificationRules`	POST	Lista todas as regras ativas da empresa.
`/insertAppClassificationRule`	POST	Insere uma nova regra de classificação.
`/deactivateAppClassificationRule`	POST	Desativa uma regra existente pelo nome do aplicativo.

POST /listAppClassificationRules

Retorna todas as regras de classificação cadastradas para a empresa.

Request

Campo	Tipo	Obrigatório	Descrição
`key`	string	Sim	Chave criptografada da empresa.

cURL — listar regras

curl -X POST https://integrations.fhinck.com/listAppClassificationRules \
  -H "Content-Type: application/json" \
  -d '{ "key": "SUA_CHAVE_DE_INTEGRACAO" }'

Response 200

{
  "err": false,
  "company": "EMPRESA",
  "result": [
    {
      "app_name_pt": "Microsoft Teams",
      "regex_rule": "teams\\.exe",
      "app_class": "Comunicação",
      "rnk": 10
    }
  ]
}

POST /insertAppClassificationRule

Insere uma nova regra de classificação. O campo regex_rule é validado como expressão regular válida no servidor.

Request

Campo	Tipo	Obrigatório	Descrição
`key`	string	Sim	Chave criptografada da empresa.
`app_name_pt`	string	Sim	Nome do aplicativo em português. Deve ser único por empresa.
`regex_rule`	string	Sim	Expressão regular para corresponder ao processo. Ex.: `teams\\.exe`.
`app_class`	string	Não	Categoria livre do aplicativo (ex.: `Comunicação`, `Produtividade`, `Desenvolvimento`).
`app_regex`	string	Não	Regex alternativa para casos especiais. Opcional — geralmente desnecessário.
`rnk`	integer	Não	Prioridade da regra. Números menores têm maior prioridade.

cURL — inserir regra

curl -X POST https://integrations.fhinck.com/insertAppClassificationRule \
  -H "Content-Type: application/json" \
  -d '{
    "key": "SUA_CHAVE_DE_INTEGRACAO",
    "app_name_pt": "Microsoft Teams",
    "regex_rule": "teams\\.exe",
    "app_class": "Comunicação",
    "rnk": 10
  }'

Response 200

{
  "err": false,
  "result": {
    "app_name_pt": "Microsoft Teams",
    "regex_rule": "teams\\.exe",
    "company": "EMPRESA"
  }
}

POST /deactivateAppClassificationRule

Desativa uma regra de classificação pelo nome do aplicativo.

Campo	Tipo	Obrigatório
`key`	string	Sim
`app_name_pt`	string	Sim

cURL — desativar regra

curl -X POST https://integrations.fhinck.com/deactivateAppClassificationRule \
  -H "Content-Type: application/json" \
  -d '{
    "key": "SUA_CHAVE_DE_INTEGRACAO",
    "app_name_pt": "Microsoft Teams"
  }'

Response 200

{
  "err": false,
  "result": {
    "deactivated": "Microsoft Teams",
    "company": "EMPRESA"
  }
}

Erros comuns

Status	Causa
400	Key ausente, inválida ou campo `app_name_pt` / `regex_rule` ausente.
400	`regex_rule` é uma expressão regular inválida.
401	Key não descriptografável.
500	Erro interno ao persistir a regra.