Pular para conteúdo

ZENDESK USER UPDATE - Atualizar Usuário

O que é este Node?

O ZENDESK USER UPDATE é o node responsável por modificar dados de usuários existentes no Zendesk.

Por que este Node existe?

O ZENDESK USER UPDATE existe para:

  1. Atualização de Dados: Modificar nome, email, role de usuários
  2. Correções: Corrigir informações cadastradas erradas
  3. Promoções: Alterar role (end-user → agent)
  4. Manutenção: Manter dados atualizados

Como funciona internamente?

Código interno (zendesk.executor.ts:153-157):

case 'update':
  const updateUserId = this.replaceVariables(data.userId, context.variables);
  const updates = this.replaceObjectVariables(data.updates, context.variables);
  const { data: updateResponse } = await client.put(`/users/${updateUserId}.json`, { user: updates });
  return updateResponse.user;

Parâmetros

Campo Tipo Obrigatório Descrição
config object Sim Credenciais Zendesk
userId string Sim ID do usuário (suporta {{variáveis}})
updates object Sim Campos a atualizar
updates.name string Não Novo nome
updates.email string Não Novo email
updates.role string Não Novo role (end-user, agent, admin)
responseVariable string Não Variável para armazenar resposta

Exemplo: Atualizar Email do Usuário

{
  "name": "Atualizar Email",
  "nodes": [
    {
      "id": "start_1",
      "type": "start",
      "position": { "x": 100, "y": 100 },
      "data": { "label": "Início" }
    },
    {
      "id": "input_id",
      "type": "input",
      "position": { "x": 250, "y": 100 },
      "data": {
        "label": "ID",
        "parameters": {
          "message": "Digite o ID do usuário:",
          "variable": "user_id"
        }
      }
    },
    {
      "id": "email_1",
      "type": "email",
      "position": { "x": 400, "y": 100 },
      "data": {
        "label": "Novo Email",
        "parameters": {
          "message": "Digite o novo email:",
          "variable": "novo_email"
        }
      }
    },
    {
      "id": "zendesk_1",
      "type": "zendesk",
      "position": { "x": 550, "y": 100 },
      "data": {
        "label": "Atualizar",
        "resource": "user",
        "operation": "update",
        "config": {
          "subdomain": "sua-empresa",
          "email": "admin@empresa.com",
          "apiToken": "seu_token_api"
        },
        "userId": "{{user_id}}",
        "updates": {
          "email": "{{novo_email}}"
        },
        "responseVariable": "usuario"
      }
    },
    {
      "id": "message_1",
      "type": "message",
      "position": { "x": 700, "y": 100 },
      "data": {
        "label": "Confirmar",
        "parameters": {
          "message": "✅ Email atualizado para: {{usuario.email}}"
        }
      }
    },
    {
      "id": "end_1",
      "type": "end",
      "position": { "x": 850, "y": 100 },
      "data": { "label": "Fim" }
    }
  ],
  "edges": [
    { "source": "start_1", "target": "input_id" },
    { "source": "input_id", "target": "email_1" },
    { "source": "email_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": "novo@email.com",
  "role": "end-user",
  "updated_at": "2025-01-15T14:30:00Z"
}

Próximo Node

ZENDESK USER GET - Buscar antes de atualizar → ZENDESK USER DELETE - Deletar usuário