AjudaIndicadores (KPIs)Coletor por API: o Orzon busca o número

Coletor por API: o Orzon busca o número

Um endereço, um caminho até o valor, e a credencial guardada em cofre.

Quando o número mora num sistema que tem API — um ERP, um CRM, uma ferramenta de suporte —, a plataforma pode buscá-lo sozinha, sem ninguém exportar planilha.

  1. Em Configurações → Integrações → "Nova integração", escolha o cartão "API (o Orzon busca)".
  2. Informe o endereço (precisa ser https), o método e, se necessário, cabeçalhos e corpo da requisição.
  3. Clique em testar. A plataforma faz a chamada e mostra a resposta.
  4. Aponte, na resposta, onde está o número — por exemplo "dados.vendas[0].total". Se houver uma data de período, aponte também.
  5. Escolha o indicador de destino e o intervalo de sincronização.

A credencial

Chave de API e token não são digitados no meio da URL. Você guarda a credencial num cofre e a referencia por {{secret}} — na URL, no corpo ou no valor de um cabeçalho. Ela é substituída só no momento da chamada, nunca volta para a tela e não aparece para quem tem acesso à aba.

Só endereços https públicos são aceitos. Endereço interno da rede da empresa (192.168.x.x, localhost) é recusado de propósito: o coletor roda nos servidores do Orzon, não dentro da sua rede.

A resposta tem limite de tamanho e de tempo, e redirecionamentos são conferidos a cada salto. Falha de qualquer tipo é registrada no histórico e avisada a quem configurou.