Conector de dados de clientes
Mostre campos de perfil, listas e alertas dos seus próprios sistemas no painel Cliente de cada ticket.
Traduzido para sua conveniência. Código, nomes de campos e a referência da API continuam em inglês. Versão em inglês
O conector de dados de clientes deixa os agentes verem o que os seus sistemas sabem sobre um cliente (plano, pedidos, status da conta, incidentes abertos) direto no ticket, sem app de barra lateral.
Como funciona
- Um administrador define o endpoint do conector (URL e autenticação) em Admin Center, Integrations, Customer data.
- Quando um agente abre um ticket, o ChaosDesk chama o seu endpoint com os identificadores do solicitante (e-mail, id externo, telefone).
- O seu endpoint responde com JSON: campos de perfil, listas (por exemplo os últimos pedidos) e alertas (por exemplo “pagamento atrasado”).
- O ChaosDesk mostra a resposta no painel Cliente.
O seu endpoint
- HTTPS, acessível a partir dos nossos endereços IP de saída publicados.
- Autenticação: uma chave de API num cabeçalho à sua escolha (por exemplo
X-API-KeyouAuthorization: Bearer ...) ou credenciais de cliente OAuth (URL do token, client id e secret, scope e audience opcionais). - Tempo limite: de 1 a 15 segundos (padrão 5). Depois disso o painel avisa o agente que o seu sistema não respondeu, sem bloquear o ticket.
- Cache: de 0 a 86400 segundos por cliente (padrão 300). Os agentes podem atualizar o painel manualmente; falhas ficam em cache por 15 segundos.
- Responda
404ou"found": falsequando não houver registro; o painel informa isso. - O ChaosDesk não guarda nenhum desses dados, e o painel nunca escreve no seu sistema.
O contexto do cliente também está disponível na API REST em GET /api/users/{id}/customer_context, para que regras e integrações usem os mesmos dados.