Webhooks da API

Webhooks

Os webhooks notificam sua aplicação em tempo real quando eventos ocorrem no myumbrella.ai, como uma nova reclamação sendo registrada ou um contrato sendo ativado.

Configurando Webhooks

1. Vá para Configurações → Webhooks → Adicionar Endpoint
2. Insira a URL do seu endpoint (deve ser HTTPS)
3. Selecione os eventos que deseja receber
4. Salve e copie o segredo de assinatura

Tipos de Eventos

Evento	Gatilho
contract.created	Novo contrato de garantia ativado
contract.cancelled	Contrato cancelado ou reembolsado
claim.submitted	Nova reclamação registrada
claim.approved	Reclamação aprovada para resolução
claim.denied	Reclamação negada
claim.resolved	Resolução da reclamação concluída
plan.updated	Configuração do plano de garantia alterada

Formato do Payload

{
  "id": "evt_abc123",
  "type": "claim.submitted",
  "created_at": "2025-01-15T10:30:00Z",
  "data": {
    "claim_id": "clm_xyz789",
    "contract_id": "ctr_def456",
    "customer_email": "jane@example.com",
    "issue_type": "accidental_damage",
    "amount": 299.99
  }
}

Verificação de Assinaturas

Cada webhook inclui um cabeçalho X-Umbrella-Signature. Verifique-o para garantir a autenticidade:

const crypto = require('crypto');

function verifyWebhook(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

Política de Retentativa

Entregas com falha (resposta não-2xx) são retentadas até 5 vezes com backoff exponencial: 1 min, 5 min, 30 min, 2 horas, 24 horas.