Webhooks

Configure webhooks para enviar eventos do Defender360 para sistemas externos em tempo real.

Visao Geral

Webhooks permitem que o Defender360 notifique sistemas externos quando eventos ocorrem, como:

• Novo ticket criado
• Ticket atualizado ou resolvido
• SLA violado
• Alerta de integracao
• Usuario cadastrado

Como Funciona

1. Evento ocorre no Defender360
        │
        ▼
2. Sistema enfileira o webhook
        │
        ▼
3. POST enviado para URL configurada
        │
        ▼
4. Resposta processada (sucesso/retry)

Criar Webhook

Passo a Passo

1. Acesse Configuracoes > Integracoes > Webhooks
2. Clique em Novo Webhook
3. Configure os campos:

4. Clique em Salvar
5. Copie o Secret para validar as requisicoes

Eventos Disponiveis

Tickets

SLA

Usuarios

Integracoes

Formato do Payload

Estrutura Padrao

{
  "id": "evt_abc123",
  "type": "ticket.created",
  "created_at": "2024-01-15T10:30:00Z",
  "tenant_id": "tnt_xyz789",
  "data": {
    "id": "tkt_123",
    "number": "TKT-0042",
    "title": "Computador nao liga",
    "status": "open",
    "priority": "high",
    "requester": {
      "id": "usr_456",
      "name": "Joao Silva",
      "email": "joao@empresa.com"
    },
    "assignee": null,
    "created_at": "2024-01-15T10:30:00Z"
  }
}

Campos do Evento

Seguranca

Validacao de Assinatura

Cada webhook inclui uma assinatura HMAC no header:

X-Webhook-Signature: sha256=abc123...

Valide a assinatura no seu servidor:

# Python
import hmac
import hashlib
 
def verify_signature(payload, signature, secret):
    expected = hmac.new(
        secret.encode(),
        payload.encode(),
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(f"sha256={expected}", signature)

// Node.js
const crypto = require('crypto');
 
function verifySignature(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return signature === `sha256=${expected}`;
}

HTTPS Obrigatorio

Webhooks sao enviados apenas para URLs HTTPS. Certifique-se de que seu endpoint:

• Usa certificado SSL valido
• Suporta TLS 1.2 ou superior
• Responde na porta 443

Retentativa (Retry)

Politica de Retry

Se seu endpoint falhar, o sistema tenta novamente:

Codigos de Sucesso

O webhook considera sucesso se receber:

• 200 OK
• 201 Created
• 202 Accepted
• 204 No Content

Falha Permanente

Apos 6 tentativas sem sucesso, o evento vai para a Dead Letter Queue:

1. Acesse Webhooks > Dead Letter
2. Visualize eventos nao entregues
3. Corrija o problema no endpoint
4. Clique em Reenviar para tentar novamente

Headers Customizados

Adicione headers extras as requisicoes:

{
  "X-Custom-Header": "valor",
  "Authorization": "Bearer token_externo"
}

Variaveis Dinamicas

Use variaveis nos headers:

Exemplo:

{
  "X-Tenant-ID": "{{tenant_id}}",
  "X-Timestamp": "{{timestamp}}"
}

Filtros

Filtrar por Condicao

Configure para disparar apenas quando:

Configurar Filtro

1. Edite o webhook
2. Na secao Filtros, clique em Adicionar Filtro
3. Selecione o campo
4. Defina a condicao
5. Clique em Salvar

Monitoramento

Dashboard de Webhooks

Visualize o status de entrega:

Logs de Eventos

Para cada webhook:

1. Clique no webhook
2. Acesse aba Logs
3. Visualize:
   • Payload enviado
   • Response recebida
   • Status HTTP
   • Tempo de resposta
   • Tentativas realizadas

Alertas

Configure alertas para:

• Taxa de sucesso abaixo de X%
• Tempo de resposta acima de Xs
• Eventos na dead letter
• Webhook desativado por falhas

Testar Webhook

Enviar Evento de Teste

1. Acesse o webhook
2. Clique em Testar
3. Selecione o tipo de evento
4. Visualize o payload que sera enviado
5. Clique em Enviar Teste
6. Verifique a resposta

Webhook de Debug

Use servicos como:

• webhook.site 
• requestbin.com 
• ngrok  para testes locais

Troubleshooting

Boas Praticas

Proximos Passos