V Ai Desk

Integrações · Webhooks

Webhooks de saída assinados HMAC-SHA256

Receba eventos do V Ai Desk no seu sistema em tempo real, com proteção contra replay e retry exponencial até dead letter.

Assinatura 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 e dead letter

integrations.webhooks.sections.retryText

Exemplo: validar assinatura (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')
  );
}

Pronto para integrar atendimento robusto no seu produto?

Conte sobre seu caso. Retornamos em até um dia útil.

Falar com vendascontact@vaidesk.com