Skip to main content
O QSmartHub emite 15 eventos, de três domínios: Senhas, Chamadas e Agendamentos. Cada evento chega no envelope padrão; as tabelas abaixo listam os campos que cada um carrega em data. Todos os *_id são ULIDs públicos; datas em UTC com Z.
Por padrão, nenhum evento carrega dados pessoais do cliente. Nome, e-mail e telefone são lidos pela API, com o escopo customers:read, nunca pelo webhook.

Senhas

A Senha (ticket) é a jornada inteira do cliente.
ticket.created nunca traz station_id: a senha nasce no ponto e só ganha estação na chamada. E ticket.completed (fim da jornada) é diferente de call.completed (fim de um atendimento): não os trate como sinônimos.

Chamadas

A Chamada (call) é o episódio de atendimento de uma senha em um ponto.

Agendamentos

Eventos reservados

Alguns nomes de evento estão reservados: eles não são emitidos nesta rodada e não aparecem para assinatura. Estão aqui só para você não ser surpreendido quando passarem a existir: station.opened, station.closed, station.status_changed, operator.assigned, operator.unassigned e queue.threshold_exceeded.

Estabilidade do contrato

Dentro de version: "1", os eventos só recebem mudanças aditivas: um campo novo em data pode aparecer, mas nenhum existente é removido ou renomeado. Escreva seu receptor para ignorar campos que não conhece.