Kalo te përmbajtja kryesore

Webhooks — Njoftime ngjarjesh

Regjistroni një endpoint HTTPS për të marrë ngjarje ndërsa ndodhin.

I avancuar· 7 min lexim· Përditësimi i fundit: 2026-05-05· 31 persona e gjetën të dobishme
Një webhook është një njoftim që Glanevo dërgon në adresën tuaj kur ndodh diçka. **Regjistrimi.** Cilësimet → Zhvilluesit → Webhooks → + E re: - URL (HTTPS i detyrueshëm) - Llojet e ngjarjeve (zgjidhni disa) - Sekreti (për verifikimin e nënshkrimit) **Llojet e ngjarjeve.** - `appointment.created`, `appointment.updated`, `appointment.cancelled`, `appointment.no_show` - `customer.created`, `customer.updated` - `payment.succeeded`, `payment.failed`, `payment.refunded` - `invoice.created`, `invoice.paid` - `staff.created` **Shembull payload (`appointment.created`):** ```json { "id": "evt_01HX...", "type": "appointment.created", "createdAt": "2026-05-21T10:30:00Z", "data": { "appointment": { "id": "apt_01HY...", "customerId": "cus_...", "serviceId": "svc_...", "startAt": "2026-05-22T14:00:00Z", "endAt": "2026-05-22T15:30:00Z", "price": 450 } } } ``` **Verifikoni nënshkrimin.** Çdo kërkesë mbart një header `X-Glanevo-Signature`, i nënshkruar me HMAC-SHA256. ```js const crypto = require('crypto'); const expected = crypto .createHmac('sha256', WEBHOOK_SECRET) .update(rawBody) .digest('hex'); if (req.headers['x-glanevo-signature'] !== expected) { return res.status(401).end(); } ``` **Riprovimet.** Nëse nuk ktheni 2xx, riprovojmë pesë herë me backoff eksponencial (2 min, 5 min, 20 min, 1 orë, 6 orë). 📊 Historiku i webhook-ëve: Cilësimet → Zhvilluesit → Regjistrat.

A ju ndihmoi ky artikull?