O Zendesk Chat - anteriormente conhecido como Zopim Chat - é um widget de comunicação entre empresas e seus clientes que possibilita a interação entre ambos em tempo real.
A ferramenta é altamente customizável e possibilita a criação das mais diversas automações (entre elas a criação de chat bots), monitoramento das visitas do seu site em tempo real e pode também ajudar muito na medição do engajamento dos usuários com o seu produto.
Dentre os KPIs mais importantes que você poderá analisar tendo acesso à API do Zendesk Chat estão:
- Tempo de resposta;
- Tempo médio de espera;
- Índice de satisfação com a interação;
- Duração total do chat;
- Quantidade de chats abertos X solucionados;
- Quantidade de chats atendidos por agente.
Adicionando o conector
Para construir a integração do Zendesk Chat na plataforma da Kondado, basta você cadastrar o conector seguindo os passos abaixo:
1) acesse a sua conta do zendesk como administrator/owner, clique na engrenagem (configurações) no lado esquerdo e, em canais, vá em “chat”, depois “Painel do Chat”
2) Uma vez na página do chat, no painel esquerdo, vá em “Configurações” e depois “Conta”
3) Na nova tela, vá em “API e SDKs” na parte superior, depois selecione “Adicionar cliente de API”
4) Preencha as informações conforme abaixo, depois clique em Criar cliente de API
- Nome do cliente: Kondado
- Empresa: Kondado
- URLs de redirecionamento: https://kondado.com.br
Após criar o cliente de API, um pop-up similar à image abaixo irá surgir. Copie o Id de cliente e segredo do cliente.
5) Na URL abaixo substitua o seguinte:
https://NOME_EMPRESA.zendesk.com/chat/oauth_login?auth={"scopes"%3A+["read"%2C+"write"]%2C+"state"%3A+null%2C+"redirect_uri"%3A+"https%3A%2F%2Fkondado.com.br"%2C+"response_type"%3A+"token"%2C+"client_id"%3A+"CLIENT_ID"}
- NOME_EMPRESA: o seu domínio do zendesk (por exemplo, em empresa.zendesk.com o empresa é o seu domínio)
- CLIENT_ID: o client_id obtido acima
Acesse a URL após substituir os valores no seu browser
6) Após acessar a URL, você será redirecionado para uma página de autorização como abaixo. Selecione “Allow” e você será redirecionado para o site da Kondado
7) Uma vez no site da Kondado, copie a URL em um editor de texto, o seu formato será algo como o abaixo:
https://kondado.com.br/#access_token=y9huojnmkhu9odwqujifJMASD98n1j23jhasdas2223&token_type=Bearer&scope=read+write
Selecione a parte entre “access_token=” e “&” (não incluindo esses valores), como no nosso exemplo acima, o valor será: y9huojnmkhu9odwqujifJMASD98n1j23jhasdas2223
8) Na plataforma da Kondado, vá para a página de adicionar novos conectores e selecione "Zendesk Chat"
9) Na página do novo conector, dê um nome a ele, copie o token gerado no passo (7) e salve
Integrações
Gráfico de relacionamento entre tabelas
Chats
Objeto principal
| Campo | Tipo | |
|---|---|---|
comment |
text |
|
triggered_response |
boolean |
|
rating |
text |
|
visitor__phone |
text |
|
visitor__notes |
text |
|
visitor__email |
text |
|
visitor__name |
text |
|
visitor__id |
text |
|
session__end_date |
timestamp |
|
session__ip |
text |
|
session__country_code |
text |
|
session__id |
text |
|
session__city |
text |
|
session__region |
text |
|
session__platform |
text |
|
session__user_agent |
text |
|
session__country_name |
text |
|
session__start_date |
timestamp |
|
session__browser |
text |
|
duration |
float |
|
agent_names |
text |
|
referrer_search_engine |
text |
|
id |
text |
|
end_timestamp |
timestamp |
|
referrer_search_terms |
text |
|
missed |
boolean |
|
started_by |
text |
|
agent_ids |
text |
|
type |
text |
|
department_id |
text |
|
triggered |
boolean |
|
tags |
text |
|
timestamp |
timestamp |
|
response_time__max |
float |
|
response_time__avg |
float |
|
response_time__first |
float |
|
count__visitor |
float |
|
count__total |
float |
|
count__agent |
float |
|
zendesk_ticket_id |
text |
|
conversions |
text |
|
department_name |
text |
|
unread |
boolean |
webpath
| Campo | Tipo | |
|---|---|---|
chat_id |
text |
|
webpath__timestamp |
timestamp |
|
webpath__from |
text |
|
webpath__to |
text |
|
webpath__title |
text |
history
| Campo | Tipo | |
|---|---|---|
history__name |
text |
|
history__timestamp |
text |
|
history__department_name |
text |
|
history__type |
text |
|
history__channel |
text |
|
history__department_id |
text |
|
chat_id |
text |
|
history__msg_id |
text |
|
history__sender_type |
text |
|
history__msg |
text |
|
history__options |
text |
|
history__trigger_id |
text |
|
history__agent_id |
text |
|
history__reason |
text |
Agentes
| Campo | Tipo | |
|---|---|---|
last_name |
text |
|
create_date |
timestamp |
|
login_count |
float |
|
id |
text |
|
first_name |
text |
|
display_name |
text |
|
roles__owner |
boolean |
|
roles__administrator |
boolean |
|
skills |
text |
|
enabled |
boolean |
|
departments |
text |
|
role_id |
text |
|
last_login |
timestamp |
|
text |
Configurar o conector Zendesk Chat na Kondado
Guia passo a passo para integrar dados de atendimento do Zendesk Chat ao seu destino (Power BI, Looker Studio, BigQuery, PostgreSQL e outros) usando a Kondado.
Crie um cliente de API no Zendesk Chat
Acesse sua conta Zendesk como administrator, vá em Configurações > Conta > API e SDKs e clique em Adicionar cliente de API. Preencha Nome do cliente e Empresa como "Kondado" e use https://kondado.com.br como URL de redirecionamento.
Copie o client_id e o client_secret
Ao salvar, o Zendesk exibirá um pop-up com o Id de cliente e o Segredo do cliente. Guarde os dois valores — eles serão usados para autorizar a aplicação e obter o token de acesso.
Monte e acesse a URL de autorização OAuth
Substitua NOME_EMPRESA pelo subdomínio do seu Zendesk e CLIENT_ID pelo valor copiado, conforme a URL fornecida no artigo. Acesse essa URL no navegador para iniciar o fluxo OAuth do Zendesk Chat.
Autorize a aplicação e capture o access_token
Na tela de autorização do Zendesk, clique em Allow. Após o redirecionamento para kondado.com.br, copie da URL o trecho entre access_token= e & — esse é o token de acesso que será usado na Kondado.
Cadastre o conector na plataforma Kondado
Na página de conectores da Kondado, selecione Zendesk Chat, dê um nome ao conector, cole o access_token e salve.
Crie integrações e visualize seus dados
Crie integrações (Chats, History, Webpath, Agents) escolhendo o destino — Power BI, Looker Studio, BigQuery, PostgreSQL e outros disponíveis em destinos suportados. Defina a frequência de atualização que melhor atende seu negócio.
Perguntas frequentes
access_token retornado na URL de redirecionamento. Esse mesmo processo é usado para renovar o token quando necessário.