Sari la conținutul principal

Webhooks — notificări de evenimente

Înregistrați un endpoint HTTPS pentru a primi evenimente pe măsură ce se întâmplă.

Avansat· 7 min de citit· Ultima actualizare: 2026-05-05· 31 persoane au găsit asta util
Un webhook este o notificare pe care Glanevo o trimite la adresa dvs. când se întâmplă ceva. **Înregistrare.** Setări → Dezvoltatori → Webhooks → + Nou: - URL (HTTPS obligatoriu) - Tipuri de evenimente (alegeti mai multe) - Secret (pentru verificarea semnăturii) **Tipuri de evenimente.** - `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` **Exemplu 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 } } } ``` **Verificați semnătura.** Fiecare cerere are un header `X-Glanevo-Signature`, semnat cu 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(); } ``` **Reîncercări.** Dacă nu returnați 2xx, reîncercăm cinci ori cu backoff exponențial (2 min, 5 min, 20 min, 1 oră, 6 ore). 📊 Istoric webhook: Setări → Dezvoltatori → Jurnale.

V-a fost util acest articol?