O padrão central é sempre o mesmo: reaja ao webhook, leia o detalhe pela API quando precisar de mais campos. Como a v1 é de leitura, você reflete a operação no seu sistema, sem escrever de volta no QSmartHub.
Casos de uso
CRM e ERP
Espelhe senhas, chamadas e agendamentos no seu sistema de registro, para unir o atendimento presencial ao histórico do cliente.
Automação
Dispare rotinas quando um evento chega: notificar uma equipe, atualizar um painel, abrir um chamado.
Agentes de IA
Alimente um agente com os eventos em tempo real e deixe-o consultar a API de leitura para responder sobre a operação.
BI e relatórios
Acumule os eventos de chamada e agendamento para medir tempos de espera e atendimento fora do QSmartHub.
Padrão: espelhar o atendimento no seu sistema
Um fluxo típico para manter um registro externo em dia:1
Assine os eventos que importam
Cadastre um webhook (veja Webhooks) e assine, por exemplo,
ticket.created, call.called, call.completed e ticket.completed.2
Valide e confirme rápido
Ao receber a entrega, valide a assinatura, responda
2xx e enfileire o processamento. Use o X-QSmartHub-Delivery para ignorar duplicatas.3
Leia o detalhe quando precisar
O evento traz os
id envolvidos. Quando precisar de mais campos, chame a API: por exemplo, GET /tickets/{id} para o estado completo da senha, ou GET /calls/{id} para a chamada.4
Atualize o seu registro
Grave ou atualize o registro correspondente no seu CRM, ERP ou data warehouse, usando o
id do QSmartHub como chave estável.Antes de começar
Começando
Gere a chave e faça a primeira requisição.
Conceitos
Entenda senha, chamada e ponto antes de modelar a integração.