Pular para conteúdo

ZENDESK USER GETALL - Listar Todos os Usuários

O que é este Node?

O ZENDESK USER GETALL é o node responsável por buscar lista de usuários no Zendesk.

Por que este Node existe?

O ZENDESK USER GETALL existe para:

  1. Listagem em Massa: Obter múltiplos usuários de uma vez
  2. Relatórios: Gerar estatísticas e análises
  3. Sincronização: Exportar base de usuários
  4. Administração: Visualizar todos os usuários cadastrados

Como funciona internamente?

Código interno (zendesk.executor.ts:145-151):

case 'getAll':
  const limit = data.limit || 100;
  const { data: usersResponse } = await client.get(`/users.json?per_page=${limit}`);
  return {
    users: usersResponse.users,
    count: usersResponse.users.length,
  };

Parâmetros

Campo Tipo Obrigatório Descrição
config object Sim Credenciais Zendesk
limit number Não Quantidade máxima (padrão: 100, máx: 100)
responseVariable string Não Variável para armazenar resposta

Exemplo: Dashboard de Usuários

{
  "name": "Dashboard de Usuários",
  "nodes": [
    {
      "id": "start_1",
      "type": "start",
      "position": { "x": 100, "y": 100 },
      "data": { "label": "Início" }
    },
    {
      "id": "zendesk_1",
      "type": "zendesk",
      "position": { "x": 250, "y": 100 },
      "data": {
        "label": "Listar Usuários",
        "resource": "user",
        "operation": "getAll",
        "config": {
          "subdomain": "sua-empresa",
          "email": "admin@empresa.com",
          "apiToken": "seu_token_api"
        },
        "limit": 100,
        "responseVariable": "todos_usuarios"
      }
    },
    {
      "id": "calculator_1",
      "type": "calculator",
      "position": { "x": 400, "y": 100 },
      "data": {
        "label": "Contar Agentes",
        "parameters": {
          "operation": "custom",
          "expression": "todos_usuarios.users.filter(u => u.role === 'agent').length",
          "resultVariable": "total_agentes"
        }
      }
    },
    {
      "id": "message_1",
      "type": "message",
      "position": { "x": 550, "y": 100 },
      "data": {
        "label": "Estatísticas",
        "parameters": {
          "message": "📊 Total Usuários: {{todos_usuarios.count}}\n👥 Agentes: {{total_agentes}}"
        }
      }
    },
    {
      "id": "end_1",
      "type": "end",
      "position": { "x": 700, "y": 100 },
      "data": { "label": "Fim" }
    }
  ],
  "edges": [
    { "source": "start_1", "target": "zendesk_1" },
    { "source": "zendesk_1", "target": "calculator_1" },
    { "source": "calculator_1", "target": "message_1" },
    { "source": "message_1", "target": "end_1" }
  ]
}

Resposta do Node

{
  "users": [
    { "id": 1, "name": "João", "email": "joao@email.com", "role": "end-user" },
    { "id": 2, "name": "Maria", "email": "maria@email.com", "role": "agent" }
  ],
  "count": 2
}

Próximo Node

ZENDESK USER GET - Buscar usuário específico → ZENDESK USER SEARCH - Buscar por filtros