Webhooks e integrações externas

Webhooks

O Ticketlivre envia notificações automáticas por webhook para sistemas externos sempre que algo importante acontece na sua conta. Você pode usar webhooks para integrar com seu CRM, planilhas, sistemas de automação (como n8n ou Make) ou qualquer serviço que receba requisições HTTP.

Eventos disponíveis

• order.created — disparado quando um pedido é criado (pagamento ainda pendente)
• order.paid — disparado quando o pagamento é confirmado
• ticket.checked_in — disparado quando um participante faz check-in
• participant.updated — disparado quando os dados de um participante são atualizados

Segurança

Cada requisição é assinada com HMAC SHA-256. O cabeçalho x-ticketlivre-signature contém a assinatura que você deve validar no seu endpoint para garantir que a notificação veio do Ticketlivre.

Cabeçalhos enviados

• x-ticketlivre-event — tipo do evento (ex: order.paid)
• x-ticketlivre-signature — assinatura HMAC SHA-256
• x-ticketlivre-organizer — ID do organizador

Como configurar

Acesse Configurações → Webhooks, informe a URL do endpoint e selecione quais eventos deseja receber.

Seu endpoint precisa responder com HTTP 200 em até 5 segundos. Respostas de erro ou timeout fazem o sistema tentar reenviar automaticamente.