GetResponse — jak używać: automatyzacje

GetResponse API pozwala zbudować własną integrację z usługą GetResponse.¹ W tym poradniku znajdziesz sposób nawiązania połączenia, opis dostępnych zasobów i wskazówki dotyczące automatyzacji.
Przy planowaniu liczby wywołań uwzględnij limity: 30 000 żądań API na 10 minut oraz 80 żądań na sekundę².

Czym jest API GetResponse i jak działa połączenie?

GetResponse API to interfejs, przez który aplikacja wymienia dane z GetResponse. Aplikacja kieruje żądanie do punktu końcowego i odczytuje odpowiedź. Na tej podstawie ustala wynik operacji.
Kod HTTP 200 oznacza pomyślny odczyt danych, na przykład danych kampanii pobranych żądaniem GET³.

Biblioteka kliencka GetResponse API v3 dla PHP pozwala ustawić klucz API i, opcjonalnie, adres punktu końcowego.⁴ Do uwierzytelniania używa nagłówka X-Auth-Token: api-key; wysyła też nagłówek Content-Type: application/json.⁴
Gdy klucz API jest nieprawidłowy, żądanie zwraca kod HTTP 401 Unauthorized³.

Dokumentacja API GetResponse opisuje, jak integrować z usługą inne narzędzia.⁵ Warto korzystać z niej podczas konfiguracji połączenia i sprawdzania wyników żądań.
Odpowiedź API pozwala odróżnić udaną operację od błędu, który wymaga poprawki w integracji³.

Jak sprawdzić, czy połączenie z API działa?

Połączenie z GetResponse API sprawdzisz, wysyłając żądanie testowe i odczytując odpowiedź. Użyj tej samej konfiguracji, z której będzie korzystać właściwa integracja. Inaczej próba nie potwierdzi działania tego połączenia.
Przy testowym pobraniu listy kampanii przez GET /campaigns oczekiwany kod odpowiedzi to HTTP 200⁶.

• Konfiguracja połączenia powinna zawierać klucz używany przez integrację. Sprawdź też, czy żądanie wychodzi z konfigurowanej aplikacji.
• Żądanie testowe skieruj do punktu końcowego właściwego dla danej operacji. Zapisz wysłane parametry, by w razie potrzeby powtórzyć próbę.
• Odpowiedź API pokazuje wynik testu połączenia. Porównaj jej status i treść z oczekiwanym rezultatem.

Połączenie działa, jeśli odpowiedź potwierdza wykonanie testowanej operacji. Znaczenie kodu zależy przy tym od rodzaju żądania.
Jeśli dodajesz kontakt przez POST /contacts, kod HTTP 202 potwierdza przyjęcie żądania do kolejki, nie zakończenie przetwarzania⁷.

Jak rozpoznać i rozwiązać błędy API GetResponse?

Błąd GetResponse API rozpoznasz po odpowiedzi na żądanie. Diagnozę zacznij od statusu i treści odpowiedzi, a następnie ustal przyczynę. Popraw konfigurację lub dane żądania i ponów tę samą próbę⁸.

• Błąd uwierzytelniania wymaga sprawdzenia klucza i sposobu jego przekazania. Porównaj nagłówki żądania z ustawieniami biblioteki.
• Błąd żądania wymaga sprawdzenia punktu końcowego, parametrów i formatu danych. Zestaw je z opisem wybranej operacji.
• Powtórny test wykonaj tym samym żądaniem po wprowadzeniu poprawki. Porównaj odpowiedzi sprzed zmiany i po niej, by ustalić, czy błąd ustąpił³.

Diagnoza błędu opiera się na konkretnym żądaniu, treści odpowiedzi i ponownym teście⁸. Porównanie 2 odpowiedzi pokaże, czy poprawka zadziałała.

Czym są zasoby i kontakty udostępniane przez API GetResponse?

GetResponse API obejmuje 3 zestawy funkcji. Zasobami nazywa się obiekty, do których aplikacja kieruje żądania.⁹ Kontakt to rekord osoby na liście mailingowej, a kampania jest odrębnym zasobem. Nazwa zasobu wskazuje więc, jakich danych dotyczy operacja.
Do utworzenia kontaktu potrzebne są dwa pola: email i campaignId w obiekcie campaign; pole name jest opcjonalne⁷.

Integracja powinna przypisać operację do właściwego zasobu przed wysłaniem żądania. Oddzielisz w ten sposób pracę na kontaktach od pracy na kampaniach. Listy obu zasobów pobierzesz następującymi żądaniami⁶:

Jakimi zasobami GetResponse można zarządzać przez API?

Biblioteka PHP GetResponse API v3 pokazuje obsługę zasobów campaigns i contacts. Domyślnie używa metody GET, a w pokazanym kodzie wysyła do obu zasobów żądania POST.⁴ Metoda określa rodzaj operacji; nazwa zasobu wskazuje obiekt, którego dotyczy żądanie.
Przykłady biblioteki obejmują dla campaigns i contacts dwie metody HTTP: GET oraz POST⁴.

• Obsługa kontaktów wymaga skierowania żądania do zasobu z rekordami osób. Dane dobierz do operacji wykonywanej na kontaktach.
• Obsługa kampanii wymaga skierowania żądania do zasobu kampanii. Metodę i dane dopasuj do zamierzonej operacji.

Zasób i metoda żądania wspólnie określają, czego dotyczy operacja integracji. Dla ścieżki /contacts są to dwie opisane niżej metody.
GET pobiera listę, a POST wysyła żądanie dodania kontaktu⁶:

Jak zalogować się do GetResponse przed konfiguracją integracji?

GetResponse wymaga zalogowania się na właściwe konto przed konfiguracją integracji. Przygotuj dane logowania do konta, z którym chcesz połączyć aplikację. Po zalogowaniu upewnij się, że pracujesz właśnie na nim.
Przy weryfikacji dwuetapowej kod otrzymany e-mailem, SMS-em lub z aplikacji uwierzytelniającej ma 6 cyfr¹⁰.

• Strona logowania GetResponse umożliwia rozpoczęcie dostępu do konta. Otwórz ją w przeglądarce.
• Dane logowania identyfikują użytkownika konta. Wprowadź je w formularzu i zatwierdź logowanie.
• Panel GetResponse pozwala sprawdzić, na którym koncie pracujesz. Zrób to przed zmianą ustawień integracji.

Konfigurację integracji rozpocznij dopiero po potwierdzeniu dostępu do właściwego konta GetResponse.

Jak połączyć GetResponse z Make, aby automatyzować działania?

GetResponse połączysz z Make za pomocą scenariusza, który wysyła żądanie do API po wybranym zdarzeniu. GetResponse MAX jest oferowany wraz z API i obejmuje ponad 170 integracji.¹¹
W scenariuszu Make osobno określasz zdarzenie wyzwalające i operację wykonywaną w GetResponse¹².

• Scenariusz w Make rozpoczyna automatyzację. Utwórz go i wybierz zdarzenie, które ma go uruchamiać.
• Żądanie do GetResponse API wykonuje operację po uruchomieniu scenariusza. Dodaj krok wysyłający żądanie i skonfiguruj uwierzytelnianie.
• Mapowanie danych przypisuje wartości ze zdarzenia wyzwalającego do pól żądania. Ustaw pola potrzebne do wybranej operacji.
• Test scenariusza pokazuje odpowiedź API. Przed włączeniem automatyzacji uruchom próbę i porównaj wynik z zamierzoną operacją.

Gotowy scenariusz po udanym teście przekazuje dane z wyzwalacza do GetResponse przez API. Częstotliwość działania zależy od planu Make.
W darmowym planie Make zaplanowany scenariusz można uruchamiać nie częściej niż co 15 minut¹³.

Ceny i warunki sprawdzone u źródeł: październik 2026.