Vďaka integrácii s Agillic sa každý, kto sa zaregistruje, vytvorí alebo aktualizuje ako príjemca v Agillic. Agillic tu nepracuje so zoznamami: príjemcovia sa pridávajú do vašich dát v Agillic a cieľové skupiny si zostavujete priamo v Agillic.
Čo budete potrebovať
- Účet Agillic na európskej platforme Agillic a používateľa, ktorý môže vytvárať API kľúče (zvyčajne administrátor).
Krok 1: Vytvorte API kľúč v Agillic
- V Agillic otvorte Settings a nájdite API kľúče (API credentials).
- Vytvorte nový kľúč a pomenujte ho tak, aby ste ho ľahko spoznali, napríklad „Scratcher“.
- Skopírujte Developer key (nazývaný aj API kľúč) a Secret. Tajný kľúč sa zobrazí iba raz.
Oprávnenia, ktoré kľúč potrebuje
Scratcher používa kľúč na čítanie polí s údajmi o osobách, vyhľadávanie príjemcov podľa e-mailu a vytváranie a aktualizáciu príjemcov. Ak Agillic umožňuje kľúč obmedziť, potrebuje prístup na čítanie a zápis k príjemcom a prístup na čítanie k údajom o osobách. Žiadny iný prístup nie je potrebný.
Krok 2: Prepojte Agillic so Scratcherom
- V Scratcheri prejdite do Nastavenia > Integrácie a kliknite na Agillic.
- Vložte Developer key a Secret.
- Kliknite na Nainštalovať integráciu. Scratcher sa prihlási do Agillic a údaje overí.
Krok 3: Zapnite integráciu v kampani
- V editore prejdite do Prepojiť > Integrácie > Agillic a kliknite na Aktivovať.
- Ak ste prepojili viac účtov, vyberte ten správny v časti Vybrať účet.
- V časti Mapovanie polí priraďte každé pole Scratchera k poľu s údajmi o osobách v Agillic.
- V časti Jedinečné e-mailové pole vyberte pole v Agillic, ktoré používate pre e-mail: „Vyberte pole v Agillic, ktoré používate pre e-mail (uistite sa, že je jedinečné aj v Agillic)“. Zobrazujú sa iba jedinečné textové polia. Ak ho necháte prázdne, Scratcher použije pole EMAIL.
- V časti Filtrovať podľa súhlasov (voliteľné) vyberte zaškrtávacie políčko so súhlasom s marketingom, aby sa odosielali iba ľudia, ktorí súhlasili.
- Kliknite na Uložiť a potom na Otestovať.
Dobré vedieť: V Agillic sa nevyberá žiadny zoznam, takže Scratcher začne odosielať hneď, ako kliknete na Aktivovať. Aktivujte integráciu ešte pred spustením kampane alebo ju nastavte hneď.
Mapovanie polí
- E-mailová adresa sa vždy odosiela do jedinečného e-mailového poľa. Nemusíte ju mapovať.
- Zoznam polí zobrazuje vaše údaje o osobách v Agillic aj s ich typmi. Dátumy sa odosielajú vo formáte Agillic, napríklad 31.12.2025.
- Ak máte pole s údajmi o osobách pre opt-in, namapujte naň pole Prijaté príslušného súhlasu.
Čo sa odosiela a kedy
Scratcher vyhľadá príjemcu podľa e-mailu. Ak neexistuje, vytvorí ho, inak ho aktualizuje. Nové registrácie sa odosielajú do minúty či dvoch a existujúce leady sa odošlú pri aktivácii. V časti Nastavenia > Integrácie > Stav doručenia uvidíte, či bol každý lead v Agillic nový, alebo už existoval.
Riešenie problémov
- „Agillic API request failed with status code ...“: Agillic požiadavku neprijal. Kód 401 alebo 403 znamená, že kľúč bol odstránený alebo nemá potrebný prístup; prepojte nový kľúč.
- Správa z Agillic týkajúca sa poľa: hodnota nezodpovedá typu poľa alebo chýba povinné pole. Skontrolujte mapovanie.