Skip to main content
O QSmartHub é a plataforma de gestão de filas e atendimento: senhas, pontos de atendimento, estações, operadores e agendamentos. A API de Integrações dá ao seu sistema acesso de leitura a esses dados e envia webhooks quando algo acontece, para você refletir a operação em CRMs, ERPs, automações e agentes de IA.
Esta é a versão 1, de leitura somente. Você consulta dados e recebe eventos; ainda não há endpoints para criar ou alterar registros. Veja abaixo o que isso significa na prática.

O que a API faz hoje

Lê os dados da operação

Consulte unidades, pontos de atendimento, estações, senhas, chamadas e agendamentos por requisições GET autenticadas por token.

Avisa quando algo muda

Receba webhooks dos eventos de senha, chamada e agendamento, assinados por HMAC, assim que acontecem.

O que ela ainda não faz

A v1 não escreve: não há POST, PUT, PATCH nem DELETE. Você não cria senhas nem aciona atendimento pela API nesta versão. As operações de escrita estão reservadas para uma rodada futura.
Para reagir a mudanças na operação, use webhooks em vez de ficar consultando a API em intervalos (polling): o QSmartHub avisa seu sistema quando uma senha nasce, é chamada ou finalizada, e quando um agendamento muda de estado.

Comece por aqui

Conceitos

O modelo de domínio: Empresa, Unidade, Ponto de Atendimento, Estação, Senha e Chamada, e como a senha percorre a operação.

Começando

Gere sua chave qsh_live_, faça a primeira requisição de leitura e entenda os limites por plano.

Visão geral da API

Escopo da v1, paginação, formato de erro e limites de requisição por minuto.

Webhooks

Os eventos que o QSmartHub emite, como validar a assinatura e como funciona a retentativa.