Bevezetés
Az Altegio nyílt ökoszisztémája lehetővé teszi, hogy a foglalási, CRM és ERP alapmodulokat partneralkalmazásokkal és egyedi integrációkkal bővítsd. Ez az útmutató bemutatja a Marketplace kategóriáit, a több telephelyes telepítési modellt, a webhookok letiltási folyamatát, valamint az analitikai események sémáját – kiegészítve a fizetésekre, üzenetküldésre/WhatsAppra, IP-telefóniára, CRM-re és Power BI jelentésekre vonatkozó gyakorlati mintákkal. A hivatkozások a hivatalos Altegio dokumentációra mutatnak a megvalósításhoz.
Marketplace kategóriák és jellemző dokumentációk
| Kategória | Jellemző integrációk és funkciók | Fő dokumentáció |
| Fizetések | Online előlegfizetés, bérletértékesítés, kártyás díjkezelés szolgáltatókon keresztül (pl. Stripe, VivaWallet, MonoBank, LiqPay, PIX) | Lásd a fizetési lehetőségeket a platform beállításaiban és a partner beüzemelési útmutatókban: Platform beállítások (fizetések áttekintése), Partneroldalak és fizetések központ |
| Chatbotok, WhatsApp, SMS | WhatsApp/SMS emlékeztetők, újraaktiválás, tömeges levelezés, vélemények gyűjtése | Chatbot katalógus, Fromni WhatsApp/SMS, SMS.to, SMS-szolgáltatók listája |
| IP-telefónia | Hívó azonosítása, hívásfelvételek, visszahívási folyamatok, hálózati szintű híváselemzés | IP-telefónia integrációk, Jelentések – Hívások |
| CRM | Érdeklődők/foglalások szinkronizálása külső CRM-rendszerekkel (pl. Kommo integrátorokon keresztül) | Dokumentációs központ (integrációk), Közösségi médiás foglalás + CRM kontextus |
| Analitika és BI | GA4/Meta Pixel foglalási események, ügyfélazonosító-átvitel, Power BI irányítópultok | GA4 csatlakoztatása, Eseménysémák, Widget-analitika és megjegyzések, Ügyfél-azonosító (UA), Power BI – Smart-Metrika, Power BI index |
| Hűségprogram és bérletek | Digitális kártyák, ajándékkártyák, bónuszok, bérlethez kötött online foglalás | Hűségkártyák (hálózati), Hűségkártya-tranzakciók, LoyalCards integráció, Boomerangme, Csak bérlettel elérhető foglalás |
Telepítési modell hálózatok és franchise-ok számára
Több telephelyes alkalmazás-telepítés
Az Altegio egy folyamatban támogatja a Marketplace-alkalmazás telepítését több telephelyre. Csatlakozáskor a felhasználó kiválasztja a telephelyeket; a szolgáltatásod egy telephely-azonosító tömböt (salon_ids[]) kap. Az integrációt minden egyes azonosítóhoz aktiválnod kell, hogy telephelyenkénti API-hozzáférés és webhook-regisztráció jöjjön létre. A fejlesztők ezt az alkalmazás beállításaiban engedélyezik („Az alkalmazás hozzáadásának engedélyezése több telephelyhez”). Lásd a több telephelyes telepítési útmutatót.
Hálózati adatok egységesítése (alkalmazásfejlesztők számára)
- Ügyfélgráf: egyetlen hálózati ügyféladatbázis és egy egységes „hálózati ügyfélkártya” jeleníti meg egy adott személy költéseit, látogatásait, felkeresett telephelyeit és hűségprogram-eszközeit a teljes hálózatban. Lásd a hálózati ügyféladatbázist és a hálózati ügyfélkártyát.
- Az analitika egyedi ügyfelekre, kihasználtságra, foglalásokra és bevételre vonatkozó mutatókat jelenít meg hálózati szinten; a duplikációszűrés megakadályozza az ismételt megkereséseket. Lásd, milyen feladatokat old meg a hálózati analitika.
A webhookok életciklusa és a „letiltás” folyamat
Amikor egy felhasználó letiltja a Marketplace-alkalmazásodat:
- Az összes integrációs beállítás törlődik az adott telephely szintjén.
- Az API-hozzáférés visszavonásra kerül az adott telephelyen, és az Altegio leállítja az események küldését a webhookjaidra.
- Az Altegio egy „letiltás” webhookot küld az alkalmazásod beállításaiban megadott callback URL-re (a formátumot az adott oldal API-dokumentációja írja le). Lásd: Integráció letiltása.
Analitikai eseménysémák és attribúció
GA4 csatlakoztatása és ellenőrzése
A GA4-et úgy kötheted össze, hogy létrehozol egy webes adatfolyamot (G-XXXXXXXXX), majd beilleszted a mérési azonosítót az Integrációk → Analitika → Google Analytics menüpontba. Az ellenőrzéshez használd a Realtime jelentéseket. Lásd a GA4 beállítását.
A foglalási widget eseménytípusai
Az online foglalási widget szabványosított eseményeket küld a GA/Meta felé, többek között (a lista nem teljes): widget_loaded, service_selected, master_selected, date_selected, time_selected, booked, appointment_changed, appointment_deleted, company_page_open, master_page_open, review_created. Lásd a teljes eseménylistát és a widget-analitikai megjegyzéseket.
Megvalósítási megjegyzések:
- Egy foglalási link csak egyetlen adatfolyamhoz rendelhető (több adatfolyamhoz hozz létre külön űrlapokat). Lásd a GA4 beállítását.
- Ha az ügyfelek több forrást is használnak, kisebb eltérések előfordulhatnak az analitikai és a platform adatai között. Lásd a widget-analitikai megjegyzéseket.
- (Régi/UA) Egyedi ügyfélazonosítót (Client ID) is átadhatsz a GA- és CRM-azonosítók összekapcsolásához. Lásd az ügyfélazonosító-átvitelt.
Jellemző integrációs minták
1) Fizetések és előlegfizetési folyamatok
- Kapcsold be az online előlegfizetést szolgáltatásokra és csoportos eseményekre; állítsd be a szolgáltatói díjakat és azt, hogy hova kerül a bevétel (pénztár-hozzárendelés). Lásd a Partneroldalak és fizetések központot, valamint a kártyás díj beállítási útmutatót.
- Szükség esetén köss az online foglaláshoz aktív bérletet (fitnesz, oktatás). Lásd a csak bérlettel elérhető foglalást.
2) Üzenetküldés: WhatsApp/SMS automatizálás
- Csatlakoztass egy WhatsApp/SMS szolgáltatót az emlékeztetők, a meg nem jelent ügyfelek újraaktiválása, a születésnapi promóciók és a vélemények kezeléséhez; egyes partnerek „elveszett” ügyfelekhez is beállíthatnak triggereket. Lásd a chatbot katalógust, a Fromni WhatsApp/SMS-t és az SMS.to-t.
- Az alap értesítési rendszer (SMS/e-mail/push/WhatsApp) az Altegio-ban konfigurálható. Lásd az Értesítések funkciót.
3) IP-telefónia üzemeltetési analitikával
- Integrálj virtuális központot/SIP-et a hívó nevének, ügyfélkártyájának, gyors foglalásnak, hívásátirányításnak és visszahívásoknak a megjelenítéséhez; a hívásfelvételeket 1 évig tárold, és elemezd a hívásokat a Jelentések → Hívások menüben. Lásd az IP-telefónia integrációkat és a Jelentések – Hívások oldalt.
4) CRM és érdeklődési források
- Irányítsd a foglalási/érdeklődői adatokat a CRM-edbe (pl. Kommo integrátorokon keresztül), és használj közösségi médiás és térképes belépési pontokat a konverzióhoz. Lásd az Online foglalás közösségi médiával oldalt és a Foglalás Google-on keresztül funkciót.
5) Power BI irányítópultok hálózatok számára
- Küldj vállalati KPI-kat (kohorszok, visszatérési arány, időpont-kihasználtság, szolgáltatás/dolgozói eladások, terv vs. tény) a Power BI-ba a Smart-Metrikán keresztül. Lásd a Power BI – Smart-Metrika oldalt és a Power BI indexet.
6) Hűségprogram és digitális kártyák
- Bocsáss ki és szinkronizálj digitális kártyákat Apple Wallet/Google Pay-be, küldj helyalapú/push értesítéseket, és egyeztesd a tranzakciókat a telephelyek között. Lásd a LoyalCards-t, a Boomerangme-t és a Hűségkártyákat (hálózati).
Hálózati analitika és jelentések, amelyekre az alkalmazásaid támaszkodhatnak
- Szolgáltatások jövedelmezősége és bevételi részesedése (csak megjelent vendégek); szűrhető időszak, szolgáltatáskategória, dolgozó és telephely szerint; Excelbe exportálható. Lásd a hálózati szolgáltatásjelentést.
- Dolgozói bevétel, eladott szolgáltatások/termékek, munkaórák, óradíj, bevételi arány, telephelyenkénti és időszakonkénti bontásban; exportálható és auditálható letöltésekkel. Lásd a hálózati dolgozói jelentést.
Biztonság, adatvédelem és hozzáférés-kezelés
- Adatkezelési szerepek: a vállalkozások az ügyféladataik adatkezelői, az Altegio pedig adatfeldolgozóként jár el. A GDPR-t betartják. Lásd az Adatvédelmi szabályzatot (EU).
- Infrastruktúra és adattárolás helye: az EU-s tárhely (Hetzner, Németország) dokumentált. Lásd az Az Altegio-ról oldalt.
- Részletes hozzáférés-kezelés és adatszivárgás elleni védelem, beleértve az ügyfél-elérhetőségek elrejtését, a szekciónkénti jogosultságokat és a tevékenységnaplókat. Lásd az Adataid védelme oldalt és az Naptár hozzáférési jogosultságait.
Fejlesztői ellenőrzőlista
- Tervezz több telephelyre: kezeld a telephely-azonosítók tömbjét, és aktiváld az alkalmazásod telephelyenként. Lásd a több telephelyes telepítést.
- Építs megbízható letiltás-kezelőt: töröld a telephelyenkénti állapotot a saját oldaladon, amikor megkapod a letiltás webhookot; számíts arra, hogy az Altegio leállítja az eseményküldést és visszavonja az API-hozzáférést. Lásd a letiltási folyamatot.
- Küldj/dolgozz fel analitikai adatokat a hivatalos widget-eseménynevek használatával; csatlakoztasd megfelelően a GA4-et, és dokumentáld az attribúcióval kapcsolatos esetleges korlátozásokat. Lásd az eseménysémát és a GA4 beállítását.
- Üzenetküldési/fizetési folyamatokhoz nézd át az Altegio Support partnerspecifikus beüzemelési oldalait a hibás konfiguráció elkerülése érdekében (pl. WhatsApp-sablonok, kártyás díj hozzárendelése, bérletszabályok). Lásd a fenti szakaszokat.
További források
- Dokumentációs központ (több modul, több iparág): Támogatási index
- Online foglalás dokumentációs oldaltérkép: Online foglalási dokumentáció
- Analitikai jelentések katalógusa: Analitika és jelentések