Webhooks de la API

Webhooks

Los webhooks notifican a tu aplicación en tiempo real cuando ocurren eventos en myumbrella.ai, como la presentación de un nuevo reclamo o la activación de un contrato.

Configuración de Webhooks

1. Ve a Configuración → Webhooks → Agregar Endpoint
2. Ingresa la URL de tu endpoint (debe ser HTTPS)
3. Selecciona los eventos que deseas recibir
4. Guarda y copia el secreto de firma

Tipos de Eventos

Evento	Disparador
contract.created	Nuevo contrato de garantía activado
contract.cancelled	Contrato cancelado o reembolsado
claim.submitted	Nuevo reclamo presentado
claim.approved	Reclamo aprobado para resolución
claim.denied	Reclamo denegado
claim.resolved	Resolución del reclamo completada
plan.updated	Configuración del plan de garantía modificada

Formato del 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
  }
}

Verificación de Firmas

Cada webhook incluye un encabezado X-Umbrella-Signature. Verifícalo para asegurar la autenticidad:

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 Reintentos

Las entregas fallidas (respuesta no 2xx) se reintentan hasta 5 veces con retroceso exponencial: 1 min, 5 min, 30 min, 2 horas, 24 horas.