Como enviar dados ao Hubviz por webhook

Com um webhook, é o seu sistema que manda os dados para o Hubviz. 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 Hubviz 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 Hubviz 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 Hubviz aceita três formatos:

Formato	Como o Hubviz 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 do Hubviz. Tente de novo em alguns minutos.

Mapear os campos

O Hubviz só conhece os campos depois do primeiro envio.

Exemplo: pedidos da loja online

A loja online da Aurora (fictícia) avisa o Hubviz 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 Hubviz Web

Os envios chegam ao cubo no Hubviz Studio. Para o Hubviz Web mostrar os dados novos, clique em Publicar na Web ou ligue a atualização automática do cubo.