Nó Zendesk

O nó de workflow Zendesk chama a Zendesk Support API para gerenciar tickets, usuários e contatos finais. Use-o para abrir tickets de suporte quando clientes reportam problemas no WhatsApp ou sincronizar status de tickets de volta nas suas automações.

Node ID no editor: zendesk_request
Base URL: https://{{zendesk_subdomain}}.zendesk.com/api/v2/
Auth: Authorization: Basic {{zendesk_auth}}

O que faz

• Envia requisições HTTP autenticadas para endpoints da Zendesk Support API
• Suporta GET, POST, PUT, PATCH e DELETE
• Retorna status HTTP, data de resposta e headers de resposta
• Inclui templates de operação para listar/criar/atualizar tickets, listar usuários e listar contatos finais

Pré-requisitos

1. Uma conta Zendesk Support (Team, Professional ou Enterprise)
2. Seu subdomain Zendesk (a parte antes de .zendesk.com, ex.: yourcompany)
3. Credenciais de API — uma das opções:
   • API token (recomendado): e-mail de admin + API token gerado no Zendesk Admin Center
   • OAuth access token (avançado)
4. Chaves de integração em Configurações → Chaves de API:
   • zendesk_subdomain — somente o subdomain (ex.: yourcompany)
   • zendesk_auth — credenciais codificadas em Base64 (veja abaixo)

Criando o valor zendesk_auth

A Basic auth do Zendesk usa o formato email/token:API_TOKEN, codificado em Base64:

1. No Zendesk, vá em Admin Center → Apps and integrations → APIs → Zendesk API
2. Ative Token access e crie um API token
3. Monte a string de credencial: your-email@company.com/token:YOUR_API_TOKEN
4. Codifique essa string em Base64 (ferramenta online, terminal ou nó JavaScript)
5. Armazene o resultado Base64 como chave de integração zendesk_auth

Exemplo no terminal:

echo -n 'agent@company.com/token:abc123token' | base64

O template de header do nó é Authorization: Basic {{zendesk_auth}} — a variável deve conter somente a string Base64, não a palavra "Basic".

Como configurar

Passo 1 — Definir credenciais

1. Abra Configurações → Chaves de API
2. Em Integration keys, adicione:
   • Name: zendesk_subdomain → Value: yourcompany (somente subdomain)
   • Name: zendesk_auth → Value: email/token:API_TOKEN codificado em Base64

Passo 2 — Adicionar o nó

1. Abra Automações e edite seu workflow
2. Na paleta, abra a categoria Communication
3. Arraste Zendesk para o canvas
4. Conecte após o gatilho ou nós de preparação de dados

Passo 3 — Escolher um template de operação

Passo 4 — Configurar campos da requisição

Exemplo — criar ticket a partir de mensagem WhatsApp (POST):

• URL: https://{{zendesk_subdomain}}.zendesk.com/api/v2/tickets.json
• Method: POST
• Body:

{
  "ticket": {
    "subject": "WhatsApp support — {{contact.name}}",
    "comment": {
      "body": "Customer message: {{trigger.body.message}}\nPhone: {{contact.phone}}"
    },
    "priority": "normal",
    "requester": {
      "name": "{{contact.name}}",
      "email": "{{contact.email}}"
    },
    "tags": ["whatsapp", "automated"]
  }
}

Exemplo — atualizar status do ticket (PUT):

• URL: https://{{zendesk_subdomain}}.zendesk.com/api/v2/tickets/{{variables.zendesk_ticket_id}}.json
• Method: PUT
• Body:

{
  "ticket": {
    "status": "solved",
    "comment": {
      "body": "Resolved via WhatsApp automation.",
      "public": false
    }
  }
}

Exemplo — listar tickets abertos (GET):

• URL: https://{{zendesk_subdomain}}.zendesk.com/api/v2/tickets.json?status=open&sort_by=created_at&sort_order=desc
• Method: GET

Todos os campos suportam variáveis de workflow.

Passo 5 — Usar dados da resposta

O Zendesk retorna dados do ticket aninhados em ticket. Referencie em nós posteriores:

Ticket ID: {{zendesk_1.data.ticket.id}}
Status: {{zendesk_1.data.ticket.status}}
URL: {{zendesk_1.data.ticket.url}}

Armazene {{zendesk_1.data.ticket.id}} em um nó Variable para passos de atualização.

Saídas do nó

Dicas e boas práticas

• Sempre inclua e-mail do requester ao criar tickets — o Zendesk exige uma identidade de requester válida
• Use tags como whatsapp e automated para filtrar tickets criados por workflow nas views do Zendesk
• Armazene IDs de tickets Zendesk em campos customizados do contato WhatsWave para sincronização bidirecional
• Configure webhooks Zendesk ou triggers com webhooks para notificar o WhatsWave quando o status do ticket mudar
• Para alto volume de criação de tickets, adicione um nó Condition para verificar se um ticket já existe antes de criar duplicata
• Use valores de priority: low, normal, high, urgent
• Valores válidos de status para atualizações: new, open, pending, hold, solved, closed
• Paginate chamadas de listagem com ?page=2 ou paginação por cursor a partir da URL next_page da resposta

Exemplos de casos de uso

Problema WhatsApp → ticket Zendesk → confirmação

1. Gatilho — mensagem WhatsApp recebida com palavras-chave de suporte
2. Zendesk POST — criar ticket com body da mensagem e dados do contato
3. Variable — salvar {{zendesk_1.data.ticket.id}} como zendesk_ticket_id
4. Send message — "Your ticket #{{zendesk_1.data.ticket.id}} was created. We'll reply soon."

Ticket resolvido → agradecimento WhatsApp

1. Gatilho Webhook — status do ticket Zendesk alterado para solved
2. Zendesk GET — buscar detalhes do ticket e requester
3. Send message — agradecimento e link de pesquisa de satisfação

Escalar mensagens urgentes no WhatsApp

1. AI Agent — classifica urgência da mensagem
2. Condition — se variables.urgency === 'high'
3. Zendesk POST — criar ticket com priority: "urgent"
4. Send message — notificar equipe interna no WhatsApp

FAQ

Por que o nó retorna 401 Unauthorized?
O valor zendesk_auth está incorreto, não está codificado em Base64, ou o API token foi revogado. Regenere o token no Zendesk Admin e atualize a chave de integração.

Por que o nó retorna 404 Not Found?
Verifique zendesk_subdomain — deve ser somente o subdomain (ex.: yourcompany), não a URL completa. Verifique também se o ticket ID existe.

Qual formato usar para zendesk_auth?
String codificada em Base64 de email/token:API_TOKEN. O nó adiciona o prefixo Basic automaticamente.

Posso adicionar notas internas vs respostas públicas?
Sim — defina "public": false no objeto comment para notas internas, true (padrão) para respostas visíveis ao cliente.

Posso anexar arquivos aos tickets?
Faça upload de anexos via POST /api/v2/uploads.json primeiro, depois referencie o upload token no comentário do ticket. Configure via URL customizada ou use o nó HTTP.

Qual a diferença entre este nó e o nó HTTP?
Este nó pré-configura base URLs Zendesk, header de auth, variável de subdomain e templates de operação comuns de tickets. Use HTTP para endpoints Zendesk não suportados (Help Center, Chat, Sell).

Referência da API

Relacionados

• Visão geral de Comunicação
• Nó JIRA
• Variáveis no workflow
• Webhooks recebidos
• Nó HTTP