Dzięki integracji z Agillic każda osoba, która się zapisze, zostaje utworzona lub zaktualizowana jako odbiorca w Agillic. Agillic nie korzysta tu z list: odbiorcy trafiają do twoich danych w Agillic, a grupy docelowe budujesz w Agillic.
Czego potrzebujesz
- Konta Agillic na europejskiej platformie Agillic i użytkownika, który może tworzyć klucze API (zwykle administratora).
Krok 1: Utwórz klucz API w Agillic
- W Agillic otwórz Settings i znajdź klucze API (API credentials).
- Utwórz nowy klucz i nadaj mu nazwę, którą rozpoznasz, np. „Scratcher”.
- Skopiuj Developer key (nazywany też kluczem API) i Secret. Sekret jest pokazywany tylko raz.
Uprawnienia, których potrzebuje klucz
Scratcher używa klucza, aby odczytywać twoje pola danych osobowych (person data), wyszukiwać odbiorców po adresie e-mail oraz tworzyć i aktualizować odbiorców. Jeśli Agillic pozwala ograniczyć klucz, potrzebuje on dostępu do odczytu i zapisu odbiorców oraz dostępu do odczytu danych osobowych. Żaden inny dostęp nie jest potrzebny.
Krok 2: Połącz Agillic ze Scratcherem
- W Scratcherze przejdź do Ustawienia > Integracje i kliknij Agillic.
- Wklej Developer key i Sekret.
- Kliknij Zainstaluj integrację. Scratcher loguje się do Agillic, aby je sprawdzić.
Krok 3: Włącz integrację w kampanii
- W edytorze przejdź do Połącz > Integracje > Agillic i kliknij Aktywuj.
- Jeśli masz połączonych kilka kont, wybierz właściwe w polu Wybierz konto.
- W sekcji Mapowanie pól dopasuj każde Pole Scratcher do pola danych osobowych w Agillic.
- W polu Unikalne pole e-mail wybierz pole Agillic, którego używasz do adresu e-mail: „Wybierz pole w Agillic, którego używasz do adresu e-mail (upewnij się, że jest ono również unikalne w Agillic)”. Na liście są tylko unikalne pola tekstowe. Jeśli zostawisz je puste, Scratcher użyje pola EMAIL.
- W polu Filtruj według zgód (opcjonalnie) wybierz swoje pole wyboru zgody marketingowej, żeby wysyłane były tylko osoby, które się zgodziły.
- Kliknij Zapisz, a potem Testuj.
Dobrze wiedzieć: w Agillic nie wybierasz listy, więc Scratcher zaczyna wysyłać, gdy tylko klikniesz Aktywuj. Aktywuj integrację, zanim kampania wystartuje, albo od razu ją skonfiguruj.
Mapowanie pól
- Adres e-mail jest zawsze wysyłany do unikalnego pola e-mail. Nie musisz go mapować.
- Lista pól pokazuje twoje dane osobowe z Agillic wraz z ich typami. Daty są wysyłane w formacie Agillic, np. 31.12.2025.
- Jeśli masz pole danych osobowych na zgodę (opt-in), zmapuj na nie pole Zaakceptowano danej zgody.
Co jest wysyłane i kiedy
Scratcher wyszukuje odbiorcę po adresie e-mail. Jeśli nie istnieje, zostaje utworzony; w przeciwnym razie jest aktualizowany. Nowe zapisy są wysyłane w ciągu minuty lub dwóch, a istniejące leady po aktywowaniu integracji. W Ustawienia > Integracje > Status dostarczenia sprawdzisz, czy każdy lead był nowy, czy już istniał w Agillic.
Rozwiązywanie problemów
- „Agillic API request failed with status code ...”: Agillic nie przyjął żądania. 401 lub 403 oznacza, że klucz został usunięty albo nie ma dostępu; połącz nowy klucz.
- Komunikat Agillic dotyczący pola: wartość nie pasuje do typu pola albo brakuje wymaganego pola. Sprawdź mapowania.