Contato
Português

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

  1. Um administrador define o endpoint do conector (URL e autenticação) em Admin Center, Integrations, Customer data.
  2. Quando um agente abre um ticket, o ChaosDesk chama o seu endpoint com os identificadores do solicitante (e-mail, id externo, telefone).
  3. O seu endpoint responde com JSON: campos de perfil, listas (por exemplo os últimos pedidos) e alertas (por exemplo “pagamento atrasado”).
  4. 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-Key ou Authorization: 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 404 ou "found": false quando 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.