Načítavam...
Načítavam...
Real-time notifikácie o udalostiach v Lexi AI pre automatizáciu a integráciu s externými systémami.
Webhooks sú HTTP callback-y, ktoré Lexi AI posiela na váš server pri výskyte špecifických udalostí (dokument vytvorený, lehota pridaná, atď.).
Umožňujú real-time integráciu bez potreby polling-u API.
Bezpečnosť: Webhook secret slúži na overenie, že požiadavku poslal naozaj Lexi AI, nie útočník.
document.created- Dokument bol vygenerovanýdocument.updated- Dokument bol aktualizovanýdocument.shared- Dokument bol zdieľaný s klientomdeadline.created- Nová lehota bola vytvorenádeadline.approaching- Lehota je blízko (24h)deadline.completed- Lehota bola splnenáclient.created- Nový klient bol pridanýclient.kyc_completed- KYC dokumentácia kompletnáclient.aml_alert- AML/CFT upozornenieWebhook pre udalosť document.created:
{
"event": "document.created",
"timestamp": "2025-12-29T14:30:00Z",
"data": {
"document_id": "doc_abc123def456",
"template_name": "Plná moc",
"client_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"client_name": "Ján Novák",
"organization_id": "org_xyz789",
"status": "completed",
"download_url": "https://api.lexi.ai/v2/documents/doc_abc123def456/download",
"created_by": "user_def456ghi789"
},
"signature": "sha256=abc123..."
}Každý webhook obsahuje X-Lexi-Signature header pre overenie autenticity:
const crypto = require('crypto');
function verifySignature(payload, signature, secret) {
const expectedSignature = crypto
.createHmac('sha256', secret)
.update(JSON.stringify(payload))
.digest('hex');
return crypto.timingSafeEqual(
Buffer.from(signature),
Buffer.from('sha256=' + expectedSignature)
);
}
// V webhook handleri:
app.post('/webhooks/lexi', (req, res) => {
const signature = req.headers['x-lexi-signature'];
const secret = process.env.LEXI_WEBHOOK_SECRET;
if (!verifySignature(req.body, signature, secret)) {
return res.status(401).send('Invalid signature');
}
// Spracovanie webhook udalosti...
console.log('Event:', req.body.event);
res.status(200).send('OK');
});Ak váš endpoint neodpovie 200 OK, Lexi AI automaticky zopakuje doručenie:
Best practice: Váš endpoint by mal odpovedať čo najrýchlejšie (ideálne < 5s). Dlhé spracovanie vykonajte asynchrónne v pozadí.
V nastaveniach webhookov môžete poslať testovaciu udalosť:
Použite nástroje ako ngrok pre exposnutie localhost na internet
Kliknite "Poslať test" v nastaveniach webhookov
Sledujte logy všetkých odoslaných webhookov v Lexi AI dashboarde
Nastavte si webhooks a automatizujte svoje workflow.