Stav: Integraci Ellity pro Upgates připravujeme. Ověřený doplněk zatím není v Marketplace. Tato stránka je pracovní draft — finální postup instalace doplníme po spuštění.
Co chystáme
Ellity plánuje věrnostní program pro e-shopy na Upgates — body, VIP, referral, retenční komunikaci a reporting nad daty e-shopu.
Preferovaný model je Partnerské API přes ověřený doplněk v Marketplace doplňků, aby e-shopaři měli napojení bez placeného Uživatelského API.
Jak Upgates napojuje doplňky
Podle oficiální nápovědy Upgates existují dva způsoby API:
1. Partnerské API (ověřený doplněk)
- určeno pro partnery / agentury, které nabízejí doplněk v Marketplace
- u doplňků se štítkem Ověřeno mají klienti API propojení zdarma
- e-shopař doplněk aktivuje v administraci / Marketplace
2. Uživatelské API (individuální napojení)
- slouží k vlastnímu nástroji nebo 3. straně bez ověřeného doplňku
- jde o příplatkovou službu (zdarma jen ve zkušebním období e-shopu)
- přístup se zakládá v Doplňky → API (`+ Nové`), předávají se URL, LOGIN a KLÍČ API
Dokumentace API: docs.upgates.com/api/intro · nápověda k doplňku API: doplnky.upgates.cz/detail/api.
Webhooky
Upgates umí posílat události (např. změna objednávky) na URL webhooku. Webhooky se spravují přes API, vážou se na API uživatele a jeho oprávnění. Timeout odpovědi je krátký — doporučuje se data jen přijmout a zpracovat asynchronně. Viz Webhooky.
Co to znamená pro Ellity (plán)
Po spuštění očekáváme tento tok:
1. V administraci Upgates otevřete Doplňky / Marketplace.
2. Najdete ověřený doplněk Ellity a aktivujete ho.
3. Dokončíte propojení účtu Ellity.
4. Ellity bude synchronizovat zákazníky a objednávky (přes Partnerské API + webhooky) a nastavíte věrnostní program.
Pokud by někdy vzniklo dočasné individuální napojení přes Uživatelské API, platilo by:
1. Aktivovat doplněk API v administraci.
2. Vytvořit samostatný API přístup jen pro Ellity (omezená práva).
3. Předat Ellity URL ve tvaru `https://…admin….upgates.com/api/v2`, LOGIN a KLÍČ.
Doporučení Upgates: pro každé napojení zvláštní API uživatel; preferovat webhooky před častým pollingem; při `GET` filtrovat podle času poslední změny.
Co zatím není finální
- publikace ověřeného doplňku Ellity v Marketplace
- přesný instalační průvodce v administraci
- seznam endpointů a práv, které Ellity vyžaduje
- cena a zkušební období
- datum veřejného spuštění
Další kroky
- Domluvte si nezávaznou konzultaci.
- Sledujte přehled integrací.
- Související draft: Integrace s Eshop-rychle.
- Související draft: Integrace s FastCentrik.
- Více kontextu: blog — věrnostní systém pro Upgates.