📋 Clusters de Engajamento

📖 Descrição

Retorna o mapa de calor de distribuição de clusters de engajamento, agrupado pelo filtro demográfico informado. Cada célula representa o percentual de colaboradores em cada cluster (engaged, contributor, opportunity, disengaged).

🔗 Documentação Relacionada

Autenticação

Rate Limiting

Formato de Resposta

⚙️ Regras de Negócio

Escopo por empresa autenticada; use o header Resource-Id para escopar uma subempresa

O parâmetro filter é obrigatório e define os grupos (linhas) do heatmap

Colunas: engaged, contributor, opportunity, disengaged (distribuição percentual por grupo)

Grupos abaixo do mínimo de respondentes retornam N/A (anonimização)

Paginação sobre os grupos (padrão 50 por página, 1–200)

🎯 Casos de Uso

Identificar a distribuição de engajamento por área

Direcionar ações para grupos com maior proporção de desengajados

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Exemplos de Requisição

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Respostas

🟢200Sucesso

application/json

Bodyapplication/json

Exemplo

{
    "data": [
        {
            "group": "string",
            "keys": {
                "engaged": 0,
                "contributor": 0,
                "opportunity": 0,
                "disengaged": 0
            }
        }
    ],
    "links": {
        "first": "string",
        "last": "string",
        "prev": "string",
        "next": "string"
    },
    "meta": {
        "current_page": 0,
        "per_page": 0,
        "total": 0,
        "last_page": 0,
        "index": "string",
        "keys": [
            {
                "key": "string",
                "label": "string",
                "overall": 0
            }
        ]
    }
}

🟠400Erro Padrão

🟠401Não Autenticado

🟠403Não Autorizado

🟠404Não Encontrado

🟠422Entidade Improcessável

📖 Descrição#

🔗 Documentação Relacionada#

⚙️ Regras de Negócio#