Uz integraciju s Agillicom svatko tko se prijavi izrađuje se ili ažurira kao primatelj u Agillicu. Agillic ovdje ne koristi liste: primatelji se dodaju u vaše podatke u Agillicu, a ciljne skupine izrađujete u Agillicu.
Što vam je potrebno
- Račun na europskoj platformi Agillica i korisnik koji može izrađivati API ključeve (obično administrator).
Korak 1: Izradite API ključ u Agillicu
- U Agillicu otvorite Settings i pronađite API ključeve (API credentials).
- Izradite novi ključ i dajte mu naziv koji ćete prepoznati, primjerice „Scratcher”.
- Kopirajte Developer key (naziva se i API ključ) i Secret. Tajna se prikazuje samo jednom.
Dopuštenja potrebna ključu
Scratcher koristi ključ za čitanje polja s podacima o osobama, pronalaženje primatelja prema e-adresi te izradu i ažuriranje primatelja. Ako vam Agillic omogućuje ograničavanje ključa, potreban mu je pristup za čitanje i pisanje za primatelje te pristup za čitanje podataka o osobama. Nikakav drugi pristup nije potreban.
Korak 2: Povežite Agillic sa Scratcherom
- U Scratcheru idite na Postavke > Integracije i kliknite Agillic.
- Zalijepite Developer key i Secret.
- Kliknite Instaliraj integraciju. Scratcher se prijavljuje u Agillic kako bi ih provjerio.
Korak 3: Uključite je u kampanji
- U uređivaču idite na Poveži > Integracije > Agillic i kliknite Aktiviraj.
- Ako ste povezali više računa, odaberite ga pod Odaberi račun.
- Pod Mapiranje polja povežite svako Scratcher polje s poljem podataka o osobi u Agillicu.
- Pod Jedinstveno polje e-adrese odaberite polje u Agillicu koje koristite za e-adresu: „Odaberite polje u Agillicu koje koristite za e-adresu (pobrinite se da je jedinstveno i u Agillicu)”. Prikazuju se samo jedinstvena tekstualna polja. Ako ga ostavite praznim, Scratcher koristi polje EMAIL.
- Pod Filtriraj prema privolama (neobavezno) odaberite potvrdni okvir za marketinšku privolu kako bi se slali samo oni koji su pristali.
- Kliknite Spremi, a zatim Testiraj.
Dobro je znati: u Agillicu nema liste za odabir, pa Scratcher počinje slati podatke čim kliknete Aktiviraj. Aktivirajte integraciju prije pokretanja kampanje ili je postavite odmah.
Mapiranje polja
- E-adresa se uvijek šalje u jedinstveno polje e-adrese. Ne morate je mapirati.
- Popis polja prikazuje vaše podatke o osobama u Agillicu s njihovim vrstama. Datumi se šalju u formatu Agillica, primjerice 31.12.2025.
- Ako imate polje podataka o osobi za privolu, povežite s njim polje Prihvaćeno odgovarajuće privole.
Što se šalje i kada
Scratcher traži primatelja prema e-adresi. Ako ne postoji, izrađuje se; u suprotnom se ažurira. Nove registracije šalju se u roku od minute-dvije, a postojeći leadovi šalju se kada aktivirate integraciju. Pod Postavke > Integracije > Status isporuke možete vidjeti je li svaki lead bio nov ili je već postojao u Agillicu.
Rješavanje problema
- „Agillic API request failed with status code ...”: Agillic nije prihvatio zahtjev. 401 ili 403 znači da je ključ izbrisan ili nema potreban pristup; povežite novi ključ.
- Poruka Agillica o polju: vrijednost ne odgovara vrsti polja ili nedostaje obavezno polje. Provjerite mapiranja.