Mailchimp — jak używać: integracje

Mailchimp Marketing API umożliwia 4 operacje na kontaktach w bazie odbiorców Mailchimp: dodawanie, aktualizowanie, archiwizowanie i usuwanie.¹
Ten poradnik omawia też kampanie i newslettery, automatyzacje, szablony oraz integracje z WordPressem i sklepem. Dotyczy wersji 3.0 Mailchimp Marketing API².

Czym jest API Mailchimp i do czego służy?

Mailchimp Marketing API to interfejs programistyczny, przez który własna aplikacja korzysta z zasobów Mailchimp. Można za jego pomocą tworzyć kampanie, zmieniać ich ustawienia, planować wysyłkę i wysyłać wiadomości testowe¹.
W planie Free limit wynosi 12 wiadomości testowych na kampanię oraz 24 łącznie w ciągu 24 godzin³.

Przez API można pobrać lub ustawić treść kampanii w 3 formach: HTML, zwykłym tekście i szablonie¹. Aplikacja może więc przygotować kampanię, a później sterować jej wysyłką.
Trzeba przy tym pilnować rozmiaru wiadomości. Gmail może ją przyciąć, gdy kod obejmujący między innymi HTML przekroczy 102 KB⁴.

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

Mailchimp Marketing API daje dostęp do zasobów sklepu i raportów kampanii. Pozwala również ręcznie dodać subskrybenta do kolejki klasycznej automatyzacji, czyli sekwencji wiadomości uruchamianej według reguł. Taka operacja pomija domyślne ustawienia wyzwalacza¹.
W raporcie wskaźnik otwarć oznacza odsetek skutecznie dostarczonych wiadomości, które odbiorcy otworzyli⁵.

Tabela grupuje zasoby API według rodzaju danych i podaje liczbę wymienionych kategorii lub wskaźników.

Dane w tabeli: 1,6

Jak dodawać i aktualizować odbiorców przez API Mailchimp?

Mailchimp Marketing API pozwala zarządzać członkami listy mailingowej, czyli zbioru odbiorców kampanii. Operacje zbiorcze służą do zapisywania i wypisywania członków listy¹.
Taka operacja uwzględnia 5 statusów kontaktu: subscribed, unsubscribed, cleaned, pending i transactional⁷.

• Lista mailingowa określa odbiorców objętych operacją. Wybierz właściwą listę, zanim przygotujesz dane kontaktów.
• Zmiana danych kontaktu zależy od tego, czy odbiorca już istnieje, czy dopiero się zapisuje. Przygotuj dane odpowiednio do operacji wykonywanej przez integrację.
• Operacja zbiorcza obejmuje zapis lub wypis grupy członków listy. Oddziel kontakty przeznaczone do zapisania od tych, które mają zostać wypisane.

Jak rozpoznać typowe błędy API Mailchimp i ich przyczyny?

Mailchimp Marketing API sygnalizuje problem w odpowiedzi na żądanie. Podczas diagnozy ustal, której operacji dotyczy odpowiedź i jakie dane wysłała integracja.
Przy tworzeniu szablonu obowiązują 2 warunki: API obsługuje wyłącznie szablony Classic, a nazwa szablonu jest wymagana⁸. Utworzenie szablonu bez nazwy kończy się błędem walidacji HTTP 400⁹.

• Błąd tworzenia szablonu może wymagać sprawdzenia jego typu. Porównaj przesłany typ z wymaganym typem Classic.
• Błąd danych szablonu może dotyczyć jego nazwy. Sprawdź, czy żądanie ją zawiera.
• Błąd innej operacji API wymaga odczytania odpowiedzi na konkretne żądanie. Powiąż komunikat z zasobem i danymi wysłanymi przez integrację.

Mailchimp Marketing API obsługuje kampanie, automatyzacje, sklepy i raporty; przy błędzie szablonu zacznij od kontroli jego typu i nazwy.

Podstawy korzystania z Mailchimp Marketing API

Mailchimp Marketing API pozwala aplikacji wykonywać operacje na koncie Mailchimp. Aplikacja wysyła żądanie do wybranego zasobu, a z odpowiedzi odczytuje wynik.
Kod HTTP 200 oznacza powodzenie operacji. Kod 401 wskazuje natomiast nieprawidłowy lub wyłączony klucz API⁹.

Operacje wsadowe pozwalają zgrupować zadania w jednym żądaniu. Mailchimp Marketing API wykonuje wiele takich operacji przez 1 wywołanie API¹.
Ten sposób organizacji żądań przydaje się przy pracy na grupie danych, nie przy pojedynczej zmianie.

Mailchimp API jako narzędzie do pracy z kontem

Mailchimp API łączy aplikację z zasobami konta przez wymianę żądań i odpowiedzi. Żądanie wskazuje zasób i operację, a odpowiedź podaje wynik.
Przy wielu rekordach aplikacja może przygotować operację wsadową zamiast wysyłać osobne żądanie dla każdego z nich. Operacje w takim żądaniu mogą używać 5 metod HTTP: GET, POST, PATCH, PUT i DELETE¹⁰.

Najczęstsze pytania o Mailchimp Marketing API

Mailchimp Marketing API pozwala dobrać sposób pracy do zakresu zmiany, którą ma wykonać aplikacja¹¹. Tabela porównuje żądanie dotyczące pojedynczego zasobu z operacją na grupie danych.

Odpowiedź API pozwala ustalić wynik żądania. Aplikacja powinna przypisać ten wynik do operacji, która go wywołała.
Marketing API dopuszcza maksymalnie 10 równoczesnych połączeń. Po osiągnięciu limitu zwraca kod HTTP 429².

Klucz API Mailchimp: od utworzenia do pierwszego połączenia

Klucz API Mailchimp uwierzytelnia integrację. Pierwsze połączenie pozwala sprawdzić, czy aplikacja otrzymuje odpowiedź z API.
W przykładzie tworzenia szablonu w Node.js konfiguracja klienta API wymaga 2 elementów: klucza API i prefiksu serwera⁸. Udane żądanie do punktu kontrolnego /ping zwraca kod HTTP 200¹².

Klucz API powinien pozostać po stronie aplikacji, która obsługuje żądania. Jeśli trafi do kodu JavaScript wykonywanego w przeglądarce, inne osoby mogą uzyskać dostęp do konta lub wprowadzać w nim zmiany¹³.
Po unieważnieniu klucza Marketing API odpowiada kodem HTTP 401⁹.

Jak uwierzytelnić żądanie i połączyć się z API Mailchimp?

Mailchimp API uwierzytelnia żądanie kluczem przypisanym do konta. Połączenie przygotowuje aplikacja, która następnie wysyła żądanie. Klucz należy przechowywać w zmiennej środowiskowej, czyli ustawieniu dostępnym dla aplikacji poza jej kodem źródłowym⁶.
Schemat HTTP Basic Auth przekazuje 2 wartości: dowolną nazwę użytkownika oraz klucz API jako hasło².

• Klucz API utwórz w ustawieniach konta Mailchimp służących do zarządzania kluczami.
• Konfiguracja aplikacji powinna pozwalać jej odczytywać klucz ze zmiennej środowiskowej.
• Żądanie API wyślij z aplikacji obsługującej integrację, a potem odczytaj odpowiedź.

Jak sprawdzić, czy klucz API i połączenie działają?

Połączenie z Mailchimp API można sprawdzić, wysyłając żądanie odczytu i oceniając odpowiedź.

• Środowisko testowe wybierz przed wysłaniem żądania. W ten sposób oddzielisz próbę integracji od pracy na rzeczywistych subskrybentach.
• Żądanie odczytu wyślij z aplikacji przy użyciu skonfigurowanego klucza.
• Odpowiedź API przypisz do wysłanego żądania. Jeśli pojawi się błąd, skontroluj konfigurację klucza i połączenia.

Klucz API Mailchimp działa, gdy aplikacja uwierzytelnia żądanie i otrzymuje oczekiwaną odpowiedź.

Najczęściej zadawane pytania

Ile testowych wiadomości można wysłać przez Mailchimp API w planie Free?

Limit wynosi 12 wiadomości testowych na kampanię i 24 łącznie w ciągu 24 godzin.

Dlaczego wiadomość przygotowana przez Mailchimp API może zostać przycięta w Gmailu?

Gmail może przyciąć wiadomość, gdy jej kod, obejmujący między innymi HTML, przekroczy 102 KB.

Co się dzieje, gdy API ręcznie dodaje subskrybenta do klasycznej automatyzacji?

Subskrybent trafia do kolejki automatyzacji, ale operacja pomija domyślne ustawienia wyzwalacza.

Co oznacza wskaźnik otwarć w raporcie kampanii Mailchimp?

To odsetek skutecznie dostarczonych wiadomości, które odbiorcy otworzyli.

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