[Zendesk] Guia passo a passo da integração
Neste artigo, vamos te guiar por cada etapa do processo de integração entre o Zendesk e a Claudia.
1. Configurando o Helpdesk
- Acesse a tela de Integração no Hub.
- No interrupitor, escolha se será uma integração de e-mail ou chat.
- No campo "Subdomínio", adicione o subdomínio da conta Zendesk.
- Faça login no Zendesk e copie o subdomínio da URL, por exemplo, https://subdomínio.zendesk.com.
- No campo "Usuário", insira o email de acesso que você utiliza para fazer login no Zendesk.
- No campo "Token", cole o token de API do Zendesk.
- No Zendesk, vá em Central de administração > Aplicações e integrações > API > API do Zendesk.
- Em "ID do Grupo da Claudia", você pode adicionar o I se já existir, caso não exista, basta deixar em branco que
criaremos um grupo no Zendesk.
- E no campo "Grupo N2", colocamos o ID do grupo que a Claudia deve enviar os tickets ao transbordar para um humano.
- No Zendesk, vá em Central de administração > Pessoas > Grupos.
- Clique no nome do grupo que deseja usar, na URL da página, copie a parte numérica após "groups/".
3. Configurando a integração de conversas (se estiver configurando e-mail pode pular para o tópico 4)
- Na Central de administração do Zendesk, acesse a seção de integrações de conversas e crie uma nova integração.
- No campo "Nome", adicione um nome para a integração para auxiliar na identificação.
- No campo "URL do webhook", insira o webhook gerada na tela de configuração do Hub.
- Selecione a opção "Incluir usuário completo" e "Mensagem da Conversa".
- Clique em "Guardar" para salvar, não precisa copiar as informações que aparecem neste momento.
- Navegue até Chaves da API e crie uma nova chave.
- Copie o "ID da aplicação", "ID da chave" e a "chave secreta"
- Cole essas informações nos campos correspondentes na telinha de configuração do Helpdesk.
4. Finalizando a Configuração
- Após clicar em "Salvar Integração", confira se os gatilhos estão corretos e com todas as informações preenchidas.
- Teste a integração, envie mensagens e veja se os tickets estão sendo respondidos corretamente.
Observação:
Na integração de e-mail, é necessário ajustar o JSON do gatilho "Cloud Humans | Webhook Trigger E-mail"
{
"ticketId": "{{ticket.id}}",
"assigneeId": "{{ticket.assignee.id}}",
"title": "{{ticket.title}}",
"text": "{{ticket.latest_comment}}",
"commentId": "{{ticket.latest_comment.id}}",
"isPublic": "{{ticket.latest_comment.is_public}}",
"type": "{{ticket.via}}",
"sender": {
"id": "{{ticket.requester.id}}",
"name": "{{ticket.requester.name}}",
"email": "{{ticket.requester.email}}",
"role": "End-user"
},
"attachments": [ {% for attachment in ticket.latest_comment.attachments %} { "filename": "{{attachment.filename}}",
"url": "{{attachment.url}}"} {% unless forloop.last %},{% endunless %} {% endfor %} ],
"comments": "{{ticket.comments}}"
}
