Az Agillic integrációval mindenki, aki regisztrál, címzettként jön létre vagy frissül az Agillicben. Az Agillic itt nem használ listákat: a címzettek az Agillic-adatai közé kerülnek, a célcsoportokat pedig az Agillicben állítja össze.
Amire szüksége lesz
- Egy Agillic-fiók az Agillic európai platformján, valamint egy felhasználó, aki API-kulcsokat hozhat létre (általában egy adminisztrátor).
1. lépés: API-kulcs létrehozása az Agillicben
- Az Agillicben nyissa meg a Settings menüt, és keresse meg az API-kulcsokat (API credentials).
- Hozzon létre egy új kulcsot, és adjon neki könnyen felismerhető nevet, például „Scratcher”.
- Másolja ki a Developer key (más néven API-kulcs) és a Secret értékét. A titkos kulcs csak egyszer jelenik meg.
A kulcshoz szükséges jogosultságok
A Scratcher a kulcs segítségével olvassa be a személyes adatmezőket, keres rá a címzettekre e-mail-cím alapján, valamint hoz létre és frissít címzetteket. Ha az Agillic lehetővé teszi a kulcs korlátozását, a kulcsnak olvasási és írási hozzáférésre van szüksége a címzettekhez, valamint olvasási hozzáférésre a személyes adatokhoz. Más hozzáférés nem szükséges.
2. lépés: Az Agillic csatlakoztatása a Scratcherhez
- A Scratcherben lépjen a Beállítások > Integrációk menübe, és kattintson az Agillic lehetőségre.
- Illessze be a Developer key és a Secret értékét.
- Kattintson az Integráció telepítése gombra. A Scratcher bejelentkezik az Agillicbe, hogy ellenőrizze az adatokat.
3. lépés: Bekapcsolás egy kampányban
- A szerkesztőben lépjen a Kapcsolódás > Integrációk > Agillic menüpontra, és kattintson az Aktiválás gombra.
- Ha több fiókot is csatlakoztatott, válassza ki a megfelelőt a Fiók kiválasztása alatt.
- A Mezőhozzárendelések alatt párosítson minden Scratcher-mezőt egy Agillic személyes adatmezővel.
- Az Egyedi e-mail-mező alatt válassza ki azt az Agillic-mezőt, amelyet az e-mail-címhez használ: „Válassza ki az Agillicben azt a mezőt, amelyet az e-mail-címhez használ (győződjön meg róla, hogy az Agillicben is egyedi)”. Csak az egyedi szöveges mezők jelennek meg. Ha üresen hagyja, a Scratcher az EMAIL mezőt használja.
- A Szűrés hozzájárulások alapján (opcionális) alatt válassza ki a marketinghozzájárulási jelölőnégyzetet, így csak azok adatai kerülnek továbbításra, akik igent mondtak.
- Kattintson a Mentés, majd a Teszt gombra.
Jó tudni: az Agillicben nincs kiválasztható lista, ezért a Scratcher az Aktiválás gombra kattintva azonnal megkezdi az adatküldést. Aktiválja a kampány indulása előtt, vagy állítsa be rögtön.
Mezőhozzárendelés
- Az e-mail-cím mindig az egyedi e-mail-mezőbe kerül. Ezt nem kell hozzárendelnie.
- A mezőlista az Agillic személyes adatmezőit mutatja a típusukkal együtt. A dátumok az Agillic formátumában kerülnek továbbításra, például 31.12.2025.
- Ha van feliratkozási hozzájárulásra szolgáló személyes adatmezője, rendelje hozzá egy hozzájárulás Elfogadva mezőjét.
Mi kerül továbbításra, és mikor
A Scratcher e-mail-cím alapján keresi meg a címzettet. Ha még nem létezik, létrehozza, egyébként frissíti. Az új regisztrációk egy-két percen belül továbbításra kerülnek, a meglévő leadek pedig az aktiváláskor. A Beállítások > Integrációk > Kézbesítési állapot alatt láthatja, hogy az egyes leadek újak voltak-e, vagy már szerepeltek az Agillicben.
Hibaelhárítás
- „Agillic API request failed with status code ...”: az Agillic nem fogadta el a kérést. A 401-es vagy 403-as kód azt jelenti, hogy a kulcsot törölték, vagy nincs megfelelő hozzáférése; csatlakoztasson új kulcsot.
- Egy mezőre vonatkozó Agillic-üzenet: egy érték nem felel meg a mező típusának, vagy hiányzik egy kötelező mező. Ellenőrizze a hozzárendeléseket.