Webhookovi

Webhookovi omogućavaju vam da reagirate na događaje u PhobsPMS-u u realnom vremenu, bez potrebe za redovnim ispitivanjem API-ja.

Podržani događaji

Event	Kada se okida
module.activated	Kad je modul aktiviran (nakon uspješne uplate)
module.deactivated	Kad je modul deaktiviran (otkazano ili neplaćeno)
module.sync_failed	Kad je automatska sinkronizacija s Phobs-om neuspješna 3+ puta zaredom
invoice.issued	Kad je izdana nova faktura
invoice.paid	Kad je faktura označena kao plaćena
subscription.upcoming_renewal	7 dana prije obnove pretplate
subscription.canceled	Kad korisnik otkaže pretplatu

Format payloada

{
  "event": "module.activated",
  "occurred_at": "2026-08-27T10:32:11Z",
  "data": {
    "module_id": "modul-yield-management",
    "account_id": "acc_HR12345",
    "activated_by": "user_A1B2C3"
  }
}

Sigurnost

Svi webhookovi imaju zaglavlje X-PhobsPMS-Signature s HMAC SHA-256 potpisom payloada pomoću vašeg webhook secret-a. Verificirajte potpis prije obrade zahtjeva. Detaljne primjere verifikacije u Node.js, PHP i Python-u pronaći ćete u našem GitHub repozitoriju za primjere.

Ponovni pokušaji

Ako vaš endpoint vrati non-2xx odgovor ili timeout (>10s), PhobsPMS pokušava ponovo do 5 puta s exponential backoff-om (30s, 5min, 30min, 2h, 12h). Nakon toga webhook je označen kao neuspješan i može se ručno ponoviti iz klijentskog područja.