Como configurar Zendesk para integração de tickets

⚠️ Necessário permissão de administrador no Zendesk.

Criar campos customizados

1. Acesse o Zendesk e crie os campos customizados que serão utilizados na integração. Esses campos serão preenchidos pelo Brainlaw conforme o projeto.

Criar formulário

1. Vá até a área de Formulários no Zendesk.

2. Crie o formulário. Sugestão de nome: Briefing Brainlaw. 

3. Adicione nele os campos customizados criados anteriormente.

Condicionais de Tickets 

Crie grupos e visualizações, definindo permissões:

Criar grupo

1. Acesse: Administração > Pessoas > Grupos.

   1. URL: {URL_ZENDESK_CLIENTE}/admin/people/team/groups

2. Crie um grupo, por exemplo: CSC Brainlaw.

Criar visualização

1. Acesse: Administração > Espaço de Trabalho do Agente > Visualizações.

   1. URL: {URL_ZENDESK_CLIENTE}/admin/workspaces/agent-workspace/views

2. Crie a visualização Briefing Brainlaw.

Configure as condições da visualização

1. 1. Condição: Quando Grupo é Tickets Brainlaw.

   2. Defina quem terá acesso e adicione descrição.

Criar webhook

1. Vá até Administração > Webhooks.
2. Clique em Adicionar webhook.
3. Preencha as informações:
   1. Nome
   2. Descrição
   3. URL do webhook (fornecida pelo Brainlaw).
   4. Método de solicitação: POST.
   5. Formato da solicitação: JSON.
   6. Autenticação: Chave da API.
   7. Nome do cabeçalho: xApiKey
   8. Valor (fornecido pelo Brainlaw).
4. Clique em Criar Webhook.

Criar gatilho

1. Acesse: Administração > Regras > Gatilhos.
   1. URL: {URL_ZENDESK_CLIENTE}/admin/objects-rules/rules/triggers
2. Crie um gatilho com a categoria Notificações.
3. Configure as Condições e Ações conforme a necessidade do fluxo.
4. Associe este gatilho ao Webhook criado.
5. selecione o webhook criado e configure o payload com as variáveis do ticket:

   {
     "ticketId": "{{ticket.id}}",
     "descricao": "{{ticket.description}}",
     "ultimo_comentario": "{{ticket.latest_comment_html}}",
     "statusTicket": "{{ticket.status}}",
     "externalId": "{{ticket.external_id}}",
     "contexto": "briefing"
   }
   

    

✅ Pronto! Após concluir essas etapas, o Zendesk estará preparado para se comunicar com o Brainlaw.

🆘 Suporte

Estamos disponíveis em helpdesk@brainlaw.com.br, de segunda a sexta-feira, das 9h às 18h (horário de Brasília), exceto em feriados.

Aqui mostramos o passo a passo de como solicitar suporte.