> ## Documentation Index
> Fetch the complete documentation index at: https://developers.qsmarthub.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Catálogo de eventos de webhook

> Os 15 eventos que o QSmartHub emite para senhas, chamadas e agendamentos, com os campos que cada envelope carrega em data.

O QSmartHub emite **15 eventos**, de três domínios: Senhas, Chamadas e Agendamentos. Cada evento chega no [envelope padrão](https://developers.qsmarthub.com/webhooks.md); 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`.

> [!NOTE]
>
> 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.

| Evento | Significado | Campos em `data` |
| - | - | - |
| `ticket.created` | Senha criada no ponto | `ticket_id`, `ticket_number`, `unit_id`, `service_point_id`, `service_id`, `origin` |
| `ticket.transferred` | Senha encaminhada para outro ponto | `ticket_id`, `from_service_point_id`, `to_service_point_id`, `stage` |
| `ticket.completed` | Jornada da senha encerrada | `ticket_id`, `total_wait_seconds`, `total_service_seconds` |
| `ticket.cancelled` | Senha cancelada | `ticket_id`, `cancelled_by` |

> [!WARNING]
>
> `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.

| Evento | Significado | Campos em `data` |
| - | - | - |
| `call.queued` | Senha entrou na fila de um ponto | `call_id`, `ticket_id`, `service_point_id`, `position` |
| `call.called` | Senha chamada pelo operador | `call_id`, `ticket_id`, `station_id`, `operator_id` |
| `call.recalled` | Chamada repetida | `call_id`, `attempt` |
| `call.started` | Atendimento iniciado na estação | `call_id`, `started_at` |
| `call.completed` | Atendimento do ponto finalizado | `call_id`, `service_seconds`, `outcome` |
| `call.no_show` | Cliente não compareceu à chamada | `call_id`, `attempts` |

## Agendamentos

| Evento | Significado | Campos em `data` |
| - | - | - |
| `appointment.created` | Agendamento criado | `appointment_id`, `unit_id`, `service_id`, `scheduled_for` |
| `appointment.updated` | Agendamento alterado | `appointment_id`, `changed` |
| `appointment.cancelled` | Agendamento cancelado | `appointment_id`, `cancelled_by` |
| `appointment.checked_in` | Check-in do agendamento (virou senha) | `appointment_id`, `ticket_id` |
| `appointment.no_show` | Cliente não compareceu ao agendamento | `appointment_id` |

## 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.