Como enviar dados ao HubCount BI Studio por webhook

Com um webhook, é o seu sistema que manda os dados para o HubCount BI Studio. Você cria o cubo, copia a URL dele e configura o sistema para enviar um JSON por POST sempre que os dados mudarem.

Quando usar

• O sistema consegue disparar chamadas HTTP (uma loja online, um formulário, uma automação no Zapier ou no Make), mas não tem uma API que o HubCount BI Studio possa consultar.
• Você quer que os dados cheguem quando algo acontece, e não num horário fixo.

Se o sistema tem API, prefira conectar a API REST. Com API, o HubCount BI Studio busca os dados no horário que você escolher.

Criar o cubo

O cubo abre na aba Webhook. A URL continua lá, em URL para envio de dados, com o botão Copiar para a área de transferência.

A URL tem o formato https://webhook.hubcount.com.br/api/bi-studio/<código>/<número do cubo>. O código é da conexão e o número identifica o cubo.

A aba Webhook

Quadro	O que mostra
URL para envio de dados	A URL do cubo e o botão Copiar para a área de transferência.
Último webhook recebido	Recebido em, Tamanho e Content-Type do envio mais recente.
Arquivos recebidos	Cada envio fica guardado como um arquivo. Atualizar lista busca envios novos, Ver arquivos abre a lista completa e Apagar todos apaga o histórico.
JSON do último envio	O JSON do envio. Carregar último JSON carrega o mais recente e preenche os campos do cubo.

Na lista completa (Arquivos recebidos), cada arquivo tem três ações: Usar JSON (mapeia os campos a partir daquele envio), Abrir e Excluir.

Enviar os dados

Configure o seu sistema para fazer uma chamada POST para a URL, com o corpo em JSON. O HubCount BI Studio aceita três formatos:

Formato	Como o HubCount BI Studio lê
Uma lista: [{...}, {...}]	Cada item vira uma linha
Um objeto com uma lista dentro: {"pedidos": [{...}]}	Usa a primeira lista que encontrar. Cada item vira uma linha
Um objeto só: {...}	Vira uma linha

Exemplo com curl:

curl -X POST "URL_DO_SEU_CUBO" \
  -H "Content-Type: application/json" \
  -d '[{"pedido": 1001, "data": "2026-10-20", "unidade": "Varejo", "valor": 350.90, "status": "pago"}]'

Se der certo, a resposta é {"success": true}. Os erros voltam com "success": false e uma mensagem:

Código	Mensagem	Causa
400	Body da requisição não pode ser vazio.	A chamada foi sem corpo.
400	O body enviado não é um JSON válido.	O corpo tem erro de sintaxe, como vírgula sobrando ou aspas simples.
400	Token de rota inválido.	A URL foi copiada pela metade ou alterada.
400	cubeId deve ser um número inteiro válido.	O número do cubo no fim da URL foi alterado.
500	Erro ao processar webhook.	Falha do lado da HubCount. Tente de novo em alguns minutos.

Mapear os campos

O HubCount BI Studio só conhece os campos depois do primeiro envio.

Id da Empresa: separar os dados por empresa

No HubCount, o projeto pode ter empresas vinculadas. Se o seu sistema manda num mesmo webhook registros de mais de uma empresa, cada registro precisa dizer a que empresa pertence. Para isso, inclua no JSON uma coluna com o identificador da empresa e marque esse campo com o tipo Id da Empresa no mapeamento.

Enquanto o cubo de webhook não tem nenhum campo desse tipo, o editor de campos mostra este aviso, que você pode fechar: Adicione um campo do tipo Id da Empresa para separar os dados por empresa.

Exemplo: o ERP do escritório avisa, por webhook, os pedidos de duas empresas do projeto, a Padaria Exemplo Ltda e a Transportadora Exemplo Ltda:

[
  { "empresa_id": 101, "pedido": 2001, "data": "2026-10-20", "valor": 84.50 },
  { "empresa_id": 102, "pedido": 2002, "data": "2026-10-20", "valor": 1260.00 }
]

Vincule as empresas ao projeto em Empresas vinculadas nas configurações do projeto. Veja Empresas do escritório no projeto.

Exemplo: pedidos da loja online

No projeto “Resultado Comercial 2026”, a loja online da Aurora Comércio Ltda (fictícia) avisa o HubCount BI Studio a cada pedido pago. A automação manda, por POST, a lista de pedidos do dia:

[
  { "pedido": 1001, "data": "2026-10-20", "unidade": "Varejo", "valor": 350.90, "status": "pago" },
  { "pedido": 1002, "data": "2026-10-20", "unidade": "Varejo", "valor": 129.00, "status": "pago" },
  { "pedido": 1003, "data": "2026-10-20", "unidade": "Serviços", "valor": 980.00, "status": "pendente" }
]

Depois de Carregar último JSON, o cubo Pedidos tem os campos pedido, data, unidade, valor e status. Em Campos do cubo, marque data como data e valor como número. Uma medida de soma de valor mostra a receita da loja por dia.

Erros comuns

Situação	O que fazer
Falha ao listar arquivos na aba Webhook	O Studio não conseguiu buscar os envios. Clique em Tentar novamente e confira a conexão com a internet.
Falha ao carregar JSON	O envio escolhido não pôde ser lido. Tente outro arquivo da lista.
O sistema recebe erro 400	Veja a tabela de mensagens acima.
Os dados antigos somem	O cubo usa só o último envio. Mande a base completa a cada vez.

Levar os dados ao HubCount BI Web

Os envios chegam ao cubo no HubCount BI Studio. Para o HubCount BI Web mostrar os dados novos, clique em Publicar na Web ou ligue a atualização automática do cubo. Entenda a diferença entre Neste computador e Nuvem HubCount em Neste computador ou Nuvem HubCount.