Notificações via webhook

POST /v1/envelopes
{
  "title": "Contrato 2025",
  "signingMode": "sequential",
  "document": { /* ... */ },
  "signers": [ /* ... */ ],
  "urlNotification": "https://seu-backend.com/webhooks/envelope-status"
}

POST https://seu-backend.com/webhooks/envelope-status
Content-Type: application/json

{
  "status": "FINISHED",
  "envelopeUuid": "550e8400-e29b-41d4-a716-446655440000"
}

// Express.js exemplo
app.post('/webhooks/envelope-status', (req, res) => {
  const { status, envelopeUuid } = req.body;
  
  // Responda imediatamente com 200 OK (antes de processar)
  res.status(200).json({ received: true });
  
  // Processe de forma assíncrona (não bloqueie a resposta)
  handleEnvelopeStatusChange(status, envelopeUuid)
    .catch(err => console.error('Erro ao processar webhook:', err));
});

async function handleEnvelopeStatusChange(status, envelopeUuid) {
  // Valide o estado
  if (!['FINISHED', 'CANCELLED', 'EXPIRED'].includes(status)) {
    console.warn('Status desconhecido:', status);
    return;
  }
  
  // Evite duplicatas: verifique se já foi processado
  const alreadyProcessed = await db.webhookLog.findOne({ envelopeUuid, status });
  if (alreadyProcessed) {
    console.log('Webhook já processado, ignorando');
    return;
  }
  
  // Registre no log antes de processar (para rastrear)
  await db.webhookLog.create({ envelopeUuid, status, receivedAt: new Date() });
  
  // Processe conforme o status
  switch (status) {
    case 'FINISHED':
      await sendConfirmationEmail(envelopeUuid);
      await updateContractStatus(envelopeUuid, 'SIGNED');
      break;
      
    case 'EXPIRED':
      await sendReminderEmail(envelopeUuid);
      await updateContractStatus(envelopeUuid, 'EXPIRED');
      break;
      
    case 'CANCELLED':
      await notifyAdmin(envelopeUuid);
      break;
  }
}

// A cada 5 minutos, verifique envelopes pendentes
setInterval(async () => {
  const pendingEnvelopes = await db.envelope.find({ state: { $in: ['CREATED', 'AWAITING', 'SIGNING'] } });
  
  for (const envelope of pendingEnvelopes) {
    const current = await api.getEnvelope(envelope.uuid);
    
    // Se o estado mudou mas o webhook não foi recebido, processe agora
    if (current.state !== envelope.state) {
      await handleEnvelopeStatusChange(
        current.state.toUpperCase(),
        envelope.uuid
      );
      await db.envelope.updateOne({ uuid: envelope.uuid }, { state: current.state });
    }
  }
}, 5 * 60 * 1000);

# Expose seu servidor local
ngrok http 3000

# Use a URL gerada em urlNotification
curl -X POST "https://signer.vcc-service.com/v1/envelopes" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Test",
    "document": { /* ... */ },
    "signers": [ /* ... */ ],
    "urlNotification": "https://abc123.ngrok.io/webhooks/envelope-status"
  }'

# Simule um webhook
curl -X POST "http://localhost:3000/webhooks/envelope-status" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "FINISHED",
    "envelopeUuid": "550e8400-e29b-41d4-a716-446655440000"
  }'