Webhookok
A chatbot eseményeit valós időben továbbíthatod bármely rendszerbe HTTP webhook segítségével.
A webhookok lehetővé teszik, hogy a Lexo eseményei (új beszélgetés, üzenet, lezárás, lead rögzítés) automatikusan eljussanak a saját rendszereidbe. Minden esemény HTTP POST kérésként érkezik a konfigurált URL-re.
Mi az a webhook?
A webhook egy HTTP callback: amikor a Lexo-ban valami történik, a rendszer azonnal POST kérést küld az általad megadott URL-re JSON formátumban. Nem kell folyamatosan lekérdezni az API-t – az adatok automatikusan megérkeznek.
Esemény típusok
| Esemény | Mikor aktiválódik |
|---|---|
conversation.created | Új párbeszéd indult |
conversation.message | Új üzenet érkezett |
conversation.ended | Párbeszéd lezárult |
lead.captured | Új lead rögzítve |
HMAC aláírás ellenőrzése
Ha megadsz egy webhook titkos kulcsot a konfiguráláskor, a rendszer minden kérés fejlécében elküldi az HMAC-SHA256 aláírást:
X-Lexo-Signature: sha256=abc123...Az aláírás ellenőrzése a végponton:
const signature = crypto
.createHmac('sha256', secret)
.update(rawBody)
.digest('hex');
if (signature !== receivedSig) {
return res.status(401).send('Invalid signature');
}Payload formátum
{
"event": "lead.captured",
"timestamp": "2026-02-28T14:30:00Z",
"chatbot_id": "abc123",
"data": {
"visitor_name": "Kovács Péter",
"visitor_email": "kovacs.peter@email.com",
"conversation_id": "xyz789",
"source_url": "https://ugyfel-oldala.hu"
}
}Webhook konfigurálása
A dashboardon, a Webhookok oldalon adhatsz hozzá új webhookot. Szükséges megadni:
- A cél URL-t
- A figyelni kívánt esemény típusokat (több is választható)
- Opcionális titkos kulcsot az HMAC aláíráshoz
- Egyéni fejléceket (pl. Authorization)
- Újrapróbálkozás engedélyezése hiba esetén (max. 3 alkalom)
A webhook kézbesítési naplóban láthatod az összes küldési kísérletet, a válasz státuszkódokat és a hibákat.