S integrací Agillic se každý, kdo se zaregistruje, vytvoří nebo aktualizuje jako příjemce v Agillicu. Agillic tu nepoužívá seznamy: příjemci se přidávají do vašich dat v Agillicu a cílové skupiny si sestavíte v Agillicu.
Co budete potřebovat
- Účet Agillic na evropské platformě Agillicu a uživatele, který může vytvářet API klíče (obvykle administrátor).
Krok 1: Vytvořte API klíč v Agillicu
- V Agillicu otevřete Settings a najděte API klíče (API credentials).
- Vytvořte nový klíč a dejte mu název, který poznáte, například „Scratcher“.
- Zkopírujte Developer key (nazývaný také API key) a Secret. Secret se zobrazí jen jednou.
Oprávnění, která klíč potřebuje
Scratcher klíč používá ke čtení polí vašich osobních dat, k hledání příjemců podle e-mailu a k vytváření a aktualizaci příjemců. Pokud vám Agillic umožní klíč omezit, potřebuje přístup pro čtení i zápis k příjemcům a přístup pro čtení k osobním datům. Žádný jiný přístup není potřeba.
Krok 2: Připojte Agillic ke Scratcheru
- Ve Scratcheru přejděte do Nastavení > Integrace a klikněte na Agillic.
- Vložte Developer key a Tajný klíč.
- Klikněte na Nainstalovat integraci. Scratcher se přihlásí do Agillicu, aby údaje ověřil.
Krok 3: Zapněte ho v kampani
- V editoru přejděte do Připojit > Integrace > Agillic a klikněte na Aktivovat.
- Pokud máte připojený více než jeden účet, vyberte ho v Vybrat účet.
- V části Mapování polí přiřaďte každé Pole Scratcheru k poli osobních dat v Agillicu.
- V části Unikátní e-mailové pole vyberte pole v Agillicu, které používáte pro e-mail: „Vyberte pole v Agillicu, které používáte pro e-mail (ujistěte se, že je unikátní i v Agillicu)“. Zobrazují se jen unikátní textová pole. Pokud ho necháte prázdné, Scratcher použije pole EMAIL.
- V části Filtrovat podle souhlasů (volitelné) vyberte své zaškrtávací políčko se souhlasem s marketingem, aby se posílali jen lidé, kteří řekli ano.
- Klikněte na Uložit a pak na Otestovat.
Dobré vědět: Agillic nemá seznam, který byste volili, takže Scratcher začne posílat hned, jak kliknete na Aktivovat. Aktivujte ho dřív, než kampaň spustíte, nebo ho rovnou celý nastavte.
Mapování polí
- E-mailová adresa se vždy posílá do unikátního e-mailového pole. Mapovat ji nemusíte.
- Seznam polí ukazuje vaše osobní data v Agillicu i s jejich typy. Data se posílají ve formátu Agillicu, například 31.12.2025.
- Pokud máte pole osobních dat pro opt-in, namapujte na něj pole Přijato u souhlasu.
Co se posílá a kdy
Scratcher vyhledá příjemce podle e-mailu. Pokud neexistuje, vytvoří se; jinak se aktualizuje. Nové registrace se odešlou do minuty nebo dvou a stávající leady se odešlou, když integraci aktivujete. V Nastavení > Integrace > Stav doručení uvidíte, zda byl každý lead v Agillicu nový, nebo už existoval.
Řešení problémů
- „Agillic API request failed with status code ...“: Agillic požadavek nepřijal. 401 nebo 403 znamená, že klíč byl smazán nebo nemá přístup; připojte nový klíč.
- Zpráva z Agillicu o poli: hodnota neodpovídá typu pole, nebo chybí povinné pole. Zkontrolujte mapování.