Integraciones · Webhooks

Webhooks de salida firmados HMAC-SHA256

Reciba eventos de V Ai Desk en su sistema en tiempo real, con protección contra replay y retry exponencial hasta dead letter.

Firma HMAC

integrations.webhooks.sections.sigText

Eventos canónicos

conversation.created/assigned/transferred/hold_started/hold_ended/closed, message.received/sent/system, attachment.added, operator.online/offline/paused, sla.warning/breached, auto_reply.suggested/accepted_by_end_user.

Retry y dead letter

integrations.webhooks.sections.retryText

Ejemplo: validar firma (Node.js)

javascript

import crypto from 'node:crypto';

function verify(headers, rawBody, secret) {
  const sig = headers['x-vaidesk-signature'];     // "t=1718976000,v1=5257..."
  const parts = Object.fromEntries(
    sig.split(',').map((p) => p.split('='))
  );
  const t = parts.t;
  const v1 = parts.v1;

  if (Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;

  const expected = crypto
    .createHmac('sha256', secret)
    .update(`${t}.${rawBody}`)
    .digest('hex');

  return crypto.timingSafeEqual(
    Buffer.from(v1, 'hex'),
    Buffer.from(expected, 'hex')
  );
}

¿Listo para integrar atención al cliente robusta en su producto?

Cuéntenos sobre su caso. Respondemos en un día hábil.

Hablar con ventas contact@vaidesk.com