Partner API klíče jsou přístupové klíče, kterými se váš druhý systém — CRM, prodejní kanál, registrační nástroj — autorizuje proti Happenee. Vydáváte je v Nastavení workspace na záložce Integrace a ke každému zvlášť nastavujete oprávnění, takže integrace dostane přesně ten rozsah dat, který potřebuje. Typický důvod: účastníky a prodané vstupenky máte jinde a chcete je odbavit v Happenee, aniž byste je pokaždé importovali ručně.
Než klíč vydáte, rozhodněte tři věci:
Co má integrace umět. Jen číst účastníky pro synchronizaci do CRM, nebo je i zakládat? Rozsah se promítne do oprávnění a ta se dají kdykoli zúžit.
Sandbox, nebo produkce. Sandboxový klíč slouží k vývoji a testům, produkční pro ostrý provoz. Typ se po vytvoření nemění, takže s tím počítejte dopředu — jinak budete zakládat klíč znovu.
Kdo klíč dostane. Klíč je přístup k datům účastníků. Patří vývojáři nebo dodavateli, který integraci staví, ne do sdíleného chatu.
Samotné vydání je krátké: na záložce Integrace kliknete na Nový API klíč, pojmenujete ho (název je jen pro vás — hodí se popsat, co se napojuje, třeba CRM integrace), vyberete typ, zaškrtnete oprávnění a potvrdíte tlačítkem Vygenerovat klíč.
Technický popis rozhraní — endpointy, formát požadavků, chybové stavy — najde váš vývojář v dokumentaci Partner API, na kterou vede odkaz přímo z info lišty záložky.
Nastavení workspace → Integrace. Je to workspace-level nastavení, takže klíč platí napříč všemi vašimi událostmi, ne jen pro jednu. Tomu odpovídá i rozsah oprávnění: když integraci pustíte ke čtení účastníků, vidí účastníky všech událostí ve workspace.
U každého klíče volíte Typ:
Sandbox — pro vývoj a testování napojení.
Produkce — pro ostrý provoz.
Oddělení má praktický smysl: dodavatel může na integraci pracovat se sandboxovým klíčem, a produkční klíč dostane až ve chvíli, kdy je napojení hotové. Typ v editaci klíče chybí — po vytvoření se nemění, takže přechod z testu do provozu znamená vydat nový klíč.
Oprávnění se zaškrtávají jednotlivě a ve výchozím stavu jsou při zakládání zapnutá všechna. Zúžení je na vás:
Události čtení — seznam a detaily událostí ve workspace.
Účastníci čtení — čtení účastnických záznamů.
Účastníci zápis — zakládání a úpravy účastníků.
Program čtení — čtení programu, tedy sessions.
Program zápis — zápis do programu.
Certifikáty čtení — čtení certifikátů.
Uživatelé čtení — čtení uživatelských záznamů.
Zápis se nabízí jen u účastníků a programu; události, certifikáty a uživatelé jsou jen pro čtení. Rozdělení na čtení a zápis využijte — integrace, která má jen doplňovat data do vašeho CRM, nepotřebuje nic zapisovat zpět.
(Anglická administrace používá u programu jiný termín: Program čtení / zápis je v ní Sessions read / write. Je to totéž oprávnění.)
Tabulka na záložce ukazuje u každého klíče Název, Typ, Klíč, Oprávnění, Stav a datum vytvoření. Samotná hodnota klíče je maskovaná — vidíte jen poslední čtyři znaky, podle kterých klíč poznáte. Celou hodnotu si proto uložte hned po vygenerování, do správce hesel nebo rovnou do konfigurace systému, který se napojuje.
Stav je Aktivní, nebo Zrušený. Zrušený klíč z přehledu nezmizí, takže zůstává dohledatelné, co kdy existovalo.
U každého řádku jsou dvě akce. Upravit API klíč otevře panel, kde změníte název a oprávnění — hodí se, když integrace časem potřebuje víc nebo míň, než se čekalo. Druhá akce klíč zruší; klíč se nemaže, přepne se do stavu Zrušený.
Oprávnění zužujte průběžně. Když se změní rozsah integrace, je snazší upravit existující klíč než řešit, proč má dodavatel přístup k datům, která už nepotřebuje.
API má smysl, když data mezi systémy tečou opakovaně a bez lidského zásahu — průběžná synchronizace registrací, odbavení účastníků, kteří si koupili vstupenku jinde, aktualizace programu z externího nástroje.
Pro jednorázový přenos je import jednodušší a rychlejší: seznam kontaktů nahrajete z Excelu v Správě kontaktů a skupin a nepotřebujete vývojáře. Když si nejste jistí, začněte importem a k API sáhněte, teprve když se ukáže, že ho děláte pořád dokola.
V přehledu se pak ukazují jen poslední čtyři znaky. Zkopírujte si celou hodnotu okamžitě a předejte ji bezpečnou cestou — správcem hesel, ne e-mailem ani chatem. Když se hodnota ztratí, cesta ven je vydat nový klíč a starý zrušit.
Sandbox a produkce se po vytvoření nepřepínají. Když víte, že integrace půjde do ostrého provozu, počítejte s tím, že produkční klíč je samostatný záznam — a nechte ten sandboxový aktivní, dokud napojení nedoběhne.
Při zakládání jsou zaškrtnutá všechna, takže je snadné je tam nechat. Klíč ale platí pro celý workspace, tedy pro všechny události a všechny účastníky. Zaškrtněte jen to, co integrace opravdu dělá — a když si nejste jistí zápisem, začněte jen se čtením a doplňte ho, až se ukáže, že je potřeba.
Klíč nemá vlastníka ani jméno člověka, takže po odchodu dodavatele není z čeho poznat, kdo ho má. Vydávejte proto samostatný klíč pro každé napojení a pojmenujte ho podle systému, ne podle člověka. Když spolupráce skončí, klíč zrušte.
