Os webhooks chegaram: ligue o Usetix a qualquer coisa
A partir de hoje, o Usetix pode notificar os seus sistemas externos no momento em que algo importante acontece na sua conta.
Configure um webhook, escolha os eventos que lhe interessam e enviamos um payload JSON assinado para o seu URL, em tempo real, de cada vez.
Porque os webhooks importam
Até agora, se quisesse sincronizar dados do Usetix com outro sistema, o CRM, a contabilidade, um canal no Slack ou um painel próprio, tinha de verificar manualmente ou construir algo de raiz.
Os webhooks invertem isso. Em vez de perguntar «aconteceu alguma coisa?», o Usetix avisa-o no instante em que acontece.
O que dispara um webhook
Pode subscrever qualquer combinação destes eventos:
- Encomenda concluída: um cliente acabou de pagar bilhetes
- Encomenda reembolsada: emitiu um reembolso
- Encomenda cancelada: uma encomenda foi cancelada antes do pagamento
- Evento publicado: colocou um evento online
- Evento despublicado: retirou um evento do ar
Cada webhook pode subscrever um, alguns ou todos estes. O controlo é seu.
O que recebe
Cada entrega de webhook é um payload JSON com tudo o que precisa:
{
"action": "order.paid",
"created_at": "2026-03-26T14:30:00Z",
"eventable": {
"id": "abc123def456",
"order_code": "7K3Q9D2A",
"display_number": "7K3Q-9D2A",
"type": "Order",
"customer_email": "fan@example.com",
"customer_name": "Jane Doe",
"total_amount": "45.00",
"currency": "EUR",
"status": "paid",
"items": [
{
"id": "ord_item_xyz789",
"check_in_code": "9M5V2H8C",
"display_check_in_code": "9M5V-2H8C",
"ticket_title": "Early Bird",
"event_title": "Summer Festival",
"price": "22.50"
}
]
},
"account": {
"name": "Cool Events GmbH",
"subdomain": "cool-events"
}
}
Não são expostos IDs internos: usamos identificadores públicos, códigos legíveis e slugs para as integrações ficarem limpas e estáveis.
Segurança integrada
Cada entrega de webhook é assinada com HMAC-SHA256. Quando cria um webhook, o Usetix gera um segredo de assinatura único. Incluímos um cabeçalho X-Webhook-Signature em cada pedido para poder verificar que veio mesmo de nós.
Também incluímos um cabeçalho X-Webhook-Timestamp para poder rejeitar pedidos antigos ou repetidos.
Desativação automática
Se o endpoint falhar, não ficamos a martelar sem parar. Após 10 falhas consecutivas ao longo de pelo menos uma hora, desativamos automaticamente o webhook e paramos de enviar. Pode reativá-lo no painel quando o endpoint voltar.
Como configurar
- Vá a Definições > Webhooks no painel de administração
- Clique em Webhook no canto superior direito
- Introduza um nome e o URL do endpoint
- Selecione os eventos que quer receber
- Guarde; o segredo de assinatura aparece na página de detalhe do webhook
É isto. Da próxima vez que um dos eventos selecionados for disparado, o endpoint recebe um pedido POST em segundos.
O que pode construir com isto
O Usetix já lhe dá acompanhamento de vendas em tempo real, gestão de encomendas e um painel de administração completo; os webhooks permitem estender isso ao resto da sua stack de ferramentas. Algumas ideias:
- Notificações no Slack quando um bilhete é vendido, passe o JSON pelo Zapier ou Make
- Faturação automática: envie dados da encomenda para o sistema de contabilidade em cada venda
- Sincronização de CRM: crie ou atualize contactos quando os clientes compram bilhetes
- Reporting externo: alimente dados de vendas nas suas ferramentas de BI ou folhas de cálculo, a par do que o Usetix já regista
- Fluxos personalizados: dispare sequências de e-mail, lógica de lista de espera ou alertas de stock nos seus próprios sistemas
Experimente agora
Os webhooks estão disponíveis para todas as contas Usetix. Entre no painel de administração, vá a Definições e configure o primeiro webhook.
Dúvidas? Escreva para support@usetix.io.