Pular para conteúdo

ZENDESK USER GET - Buscar Usuário por ID

O que é este Node?

O ZENDESK USER GET é o node responsável por buscar informações de um usuário específico no Zendesk usando o ID do usuário.

Por que este Node existe?

O ZENDESK USER GET existe para:

  1. Consulta de Dados: Obter informações completas de um usuário pelo ID
  2. Validação: Verificar se usuário existe antes de operações
  3. Integração: Buscar dados para uso em outros processos
  4. Auditoria: Consultar informações para logs e relatórios

Como funciona internamente?

Quando executado:

  1. Valida credenciais do Zendesk
  2. Substitui variáveis no userId
  3. Faz GET em /api/v2/users/{id}.json
  4. Retorna objeto user completo
  5. Armazena em responseVariable se configurado

Código interno (zendesk.executor.ts:140-143):

case 'get':
  const userId = this.replaceVariables(data.userId, context.variables);
  const { data: userResponse } = await client.get(`/users/${userId}.json`);
  return userResponse.user;

Quando você DEVE usar este Node?

Use quando precisar buscar usuário por ID:

  • Consultar dados de usuário específico
  • Validar existência pelo ID
  • Obter informações para atualização

Parâmetros

Campo Tipo Obrigatório Descrição
config object Sim Credenciais Zendesk
userId string Sim ID do usuário (suporta {{variáveis}})
responseVariable string Não Variável para armazenar resposta

Exemplo: Consultar Dados do Usuário

{
  "name": "Consultar Usuário por ID",
  "nodes": [
    {
      "id": "start_1",
      "type": "start",
      "position": { "x": 100, "y": 100 },
      "data": { "label": "Início" }
    },
    {
      "id": "input_1",
      "type": "input",
      "position": { "x": 250, "y": 100 },
      "data": {
        "label": "ID do Usuário",
        "parameters": {
          "message": "Digite o ID do usuário:",
          "variable": "user_id"
        }
      }
    },
    {
      "id": "zendesk_1",
      "type": "zendesk",
      "position": { "x": 400, "y": 100 },
      "data": {
        "label": "Buscar Usuário",
        "resource": "user",
        "operation": "get",
        "config": {
          "subdomain": "sua-empresa",
          "email": "admin@empresa.com",
          "apiToken": "seu_token_api"
        },
        "userId": "{{user_id}}",
        "responseVariable": "usuario"
      }
    },
    {
      "id": "message_1",
      "type": "message",
      "position": { "x": 550, "y": 100 },
      "data": {
        "label": "Exibir Dados",
        "parameters": {
          "message": "👤 Usuário Encontrado\n\nNome: {{usuario.name}}\nEmail: {{usuario.email}}\nRole: {{usuario.role}}"
        }
      }
    },
    {
      "id": "end_1",
      "type": "end",
      "position": { "x": 700, "y": 100 },
      "data": { "label": "Fim" }
    }
  ],
  "edges": [
    { "source": "start_1", "target": "input_1" },
    { "source": "input_1", "target": "zendesk_1" },
    { "source": "zendesk_1", "target": "message_1" },
    { "source": "message_1", "target": "end_1" }
  ]
}

Resposta do Node

{
  "id": 12345,
  "name": "João Silva",
  "email": "joao@email.com",
  "role": "end-user",
  "created_at": "2025-01-15T10:30:00Z"
}

Próximo Node

ZENDESK USER SEARCH - Buscar por email → ZENDESK USER UPDATE - Atualizar usuário