Enterarte al momento
UTILIA OS avisa a tu servidor de lo que pasa en cada empresa, con un aviso firmado.
Lección 3 de 8 · 2 minutos
Animación de «Enterarte al momento». Los pasos están escritos debajo.
Lo que pasa
Lo esencial
Solo lo que puedes leer.
Te llegan los avisos que declara tu ficha y que cubren los permisos que te dio cada empresa. Un aviso cuyo dato no podrías leer por la API no sale.
Una dirección para todas las empresas.
Todos llegan a la dirección de avisos de tu ficha. La cabecera X-Utilia-Installation-Id dice de qué empresa viene y con qué clave comprobarlo.
Firma y frescura.
La firma es un HMAC-SHA256 de la marca de tiempo y el cuerpo, con la clave de esa instalación. Rechaza los avisos de más de 5 minutos.
Contesta rápido.
Responde en menos de 30 segundos y haz el trabajo después. Si no llega tu 200, UTILIA OS lo reintenta con esperas que se duplican.
Algunos avisos
LEAD_CREATEDEntra un lead en el CRM.CLIENT_UPDATEDCambia la ficha de un cliente.BUDGET_SIGNEDEl cliente firma un presupuesto.INVOICE_PAIDSe paga una factura.TICKET_REPLIEDEl equipo contesta un ticket de tu aplicación.CHAT_APP_MENTIONEDAlguien menciona a tu aplicación en un canal.APP_INSTALLEDUna empresa termina de instalarla.
Comprobar la firma, en Node.js
// El cuerpo crudo: con express.raw(), no con express.json()
const firmado = `${req.header('X-Utilia-Timestamp')}.${req.body.toString('utf8')}`;
const esperada =
'sha256=' +
crypto.createHmac('sha256', claveDeFirmaDeLaInstalacion).update(firmado).digest('hex');
// Compárala con X-Utilia-Signature con crypto.timingSafeEqual.