Agillic-integraation avulla jokainen ilmoittautuja luodaan tai päivitetään vastaanottajaksi Agillicissa. Agillic ei käytä tässä listoja: vastaanottajat lisätään Agillic-tietoihisi, ja rakennat kohderyhmäsi Agillicissa.
Mitä tarvitset
- Agillic-tilin Agillicin eurooppalaisella alustalla ja käyttäjän, joka voi luoda API-avaimia (yleensä ylläpitäjä).
Vaihe 1: Luo API-avain Agillicissa
- Avaa Agillicissa Settings ja etsi API-avaimet (API credentials).
- Luo uusi avain ja anna sille tunnistettava nimi, esimerkiksi ”Scratcher”.
- Kopioi Developer key (jota kutsutaan myös API-avaimeksi) ja Secret. Salaisuus näytetään vain kerran.
Avaimen tarvitsemat käyttöoikeudet
Scratcher käyttää avainta henkilötietokenttiesi lukemiseen, vastaanottajien etsimiseen sähköpostiosoitteen perusteella sekä vastaanottajien luomiseen ja päivittämiseen. Jos Agillic antaa rajoittaa avainta, se tarvitsee luku- ja kirjoitusoikeuden vastaanottajiin ja lukuoikeuden henkilötietoihin. Muita oikeuksia ei tarvita.
Vaihe 2: Yhdistä Agillic Scratcheriin
- Siirry Scratcherissa kohtaan Asetukset > Integraatiot ja klikkaa Agillic.
- Liitä Developer key ja Secret.
- Klikkaa Asenna integraatio. Scratcher kirjautuu Agillicin tarkistaakseen ne.
Vaihe 3: Ota se käyttöön kampanjassa
- Siirry editorissa kohtaan Yhdistä > Integraatiot > Agillic ja klikkaa Aktivoi.
- Jos olet yhdistänyt useamman tilin, valitse oikea kohdassa Valitse tili.
- Yhdistä kohdassa Kenttävastaavuudet jokainen Scratcher-kenttä Agillicin henkilötietokenttään.
- Valitse kohdassa Yksilöivä sähköpostikenttä Agillicin kenttä, jota käytät sähköpostille: ”Valitse Agillicin kenttä, jota käytät sähköpostille (varmista, että se on yksilöivä myös Agillicissa)”. Listassa näkyvät vain yksilöivät tekstikentät. Jos jätät sen tyhjäksi, Scratcher käyttää kenttää EMAIL.
- Valitse kohdassa Suodata suostumusten mukaan (valinnainen) markkinointisuostumuksen valintaruutusi, jotta vain kyllä vastanneet lähetetään.
- Klikkaa Tallenna ja sitten Testaa.
Hyvä tietää: Agillicissa ei ole valittavaa listaa, joten Scratcher alkaa lähettää heti, kun klikkaat Aktivoi. Aktivoi se ennen kuin kampanja julkaistaan, tai määritä se saman tien loppuun.
Kenttävastaavuudet
- Sähköpostiosoite lähetetään aina yksilöivään sähköpostikenttään. Sitä ei tarvitse määrittää.
- Kenttälista näyttää Agillicin henkilötietosi tyyppeineen. Päivämäärät lähetetään Agillicin muodossa, esimerkiksi 31.12.2025.
- Jos sinulla on henkilötietokenttä opt-iniä varten, yhdistä siihen suostumuksen Hyväksytty-kenttä.
Mitä lähetetään ja milloin
Scratcher etsii vastaanottajan sähköpostiosoitteen perusteella. Jos vastaanottajaa ei ole, se luodaan; muuten se päivitetään. Uudet ilmoittautujat lähetetään minuutin tai kahden kuluessa, ja olemassa olevat liidit lähetetään, kun aktivoit integraation. Kohdassa Asetukset > Integraatiot > Toimituksen tila näet, oliko kukin liidi uusi vai jo olemassa Agillicissa.
Vianmääritys
- ”Agillic API request failed with status code ...”: Agillic ei hyväksynyt pyyntöä. 401 tai 403 tarkoittaa, että avain on poistettu tai siltä puuttuu käyttöoikeus; yhdistä uusi avain.
- Agillicin ilmoitus kentästä: arvo ei sovi kentän tyyppiin, tai pakollinen kenttä puuttuu. Tarkista kenttävastaavuudet.