Přeskočit na obsah

20. 8. 2026

FunkceIntegrace

Do Charm API přibyly webhooky a analytický endpoint

Dvě novinky pro každého, kdo staví na Charm API. A taky pro každého, kdo stavět nechce a radši si vše naklikne v Make, Zapieru nebo n8n.

Webhooky: Charm volá vám. Zaregistrujete URL a Charm na ni posílá věrnostní události ve chvíli, kdy nastanou. Žádné pravidelné dotazování na seznam zákazníků. Na start sedm typů událostí: získané body, upravené body, uplatněná odměna, dosažená úroveň, blížící se úroveň, vydaný kredit do obchodu a dokončené doporučení.

  • Podepsané a ověřitelné: každé doručení nese podpis HMAC-SHA256 s tajným klíčem daného endpointu, takže váš server má jistotu, že přišlo od nás
  • Opakuje se, dokud nedorazí: neúspěšná doručení se zkoušejí znovu s rozestupy zhruba den, a každý pokus nese stejné id události, takže duplicity snadno zahodíte
  • Správa přes API: endpointy vytvoříte, vypíšete a smažete klíčem s novým oprávněním webhooks:manage

Analytika: jedno volání, celkový obrázek. GET /v1/analytics/summary vrací to, co počítá dashboard v aplikaci: členy, získané a utracené body, připsané tržby, míru uplatnění, rozložení úrovní a k tomu měsíční řady tržeb a registrací, za libovolné období. Endpoint je zároveň nástrojem MCP, takže AI asistent připojený k Charm odpoví na otázku „jak se programu dařilo minulý měsíc?" i bez otevírání administrace.

Obojí popisuje API dokumentace a strojově čitelná specifikace na /api/v1/openapi.json už oba přírůstky zná.