Webhooks para Eventos do Sistema

[systemieven]

📌 Descrição do Problema

Atualmente, o sistema Ticketz não possui um mecanismo nativo de webhooks para notificar sistemas externos sobre eventos importantes que ocorrem na plataforma.
Isso limita a capacidade das empresas clientes de integrar o Ticketz com suas automações, CRMs, ERPs, sistemas de monitoramento e outros serviços externos.

🎯 Proposta de Solução

Adicionar suporte à criação e gerenciamento de webhooks, permitindo que eventos internos do Ticketz disparem requisições HTTP para endpoints configuráveis pelos clientes.

Esses webhooks possibilitariam a execução de triggers externos, ampliando significativamente o ecossistema de integrações e agregando valor ao produto.

🔔 Exemplos de Eventos Suportados

❌ Erro de conexão WhatsApp
✅ Ticket fechado (ticket.closed)
🚫 Empresa bloqueada ou suspensa
🔓 Empresa desbloqueada
⚠️ Falha crítica de sistema
👤 Usuário criado / desativado

(A lista pode ser extensível e configurável)

⚙️ Comportamento Esperado

• Cadastro de webhooks por empresa
• Seleção de eventos que disparam o webhook
• Envio via POST com payload JSON estruturado
• Inclusão de headers customizáveis (ex: Authorization)
• Tentativas de reenvio em caso de falha (retry policy)
• Registro de logs de entrega (status, payload, erro)

📦 Exemplo de Payload

{
  "event": "ticket.closed",
  "timestamp": "2026-01-04T14:32:10Z",
  "companyId": 123,
  "ticket": {
    "id": 9876,
    "status": "closed",
    "closedBy": "agent",
    "closedAt": "2026-01-04T14:31:58Z"
  }
}

💡 Benefícios

• Expansão do ecossistema de integrações
• Maior flexibilidade para automações personalizadas
• Redução da dependência de features nativas
• Aumento do valor percebido pelas empresas clientes
• Facilita integrações com n8n, Zapier, Make, CRMs e ERPs

📈 Impacto Esperado

• Alta relevância para clientes com operações avançadas, automações e integrações externas.
• Feature com potencial de se tornar core para planos profissionais e enterprise.