SendPulse Integration

SendPulse Integration łączy wyraźne wybory email w PrestaShop z dozwolonymi kontaktami w SendPulse. Moduł przygotowuje zdarzenia przypomnień, a SendPulse wykonuje sekwencję wiadomości. Link w przypomnieniu pozwala klientowi przejrzeć koszyk, wybrać połączenie lub zastąpienie i zatwierdzić odtworzenie.

Szybki start

1. Wgraj i zainstaluj ZIP przez menedżer modułów.
2. Otwórz Configuration i wybierz właściwy sklep.
3. Zapisz dostęp, książki, potwierdzenie i sekret zadania. Wysyłkę pozostaw wyłączoną podczas testu odczytu.
4. Zaplanuj uwierzytelniony POST na natywny adres sklepu. Serwer musi przekazywać nagłówek Authorization.
5. Jeśli używasz przypomnień, przygotuj scenariusz SendPulse i wykluczenia. Kontakty i prawdziwy email sprawdza się osobno od testu połączenia.
6. Zweryfikuj tekst zgód i politykę prywatności. Włącz tylko sprawdzone zadania, przetestuj rezygnację w sklepie i w SendPulse. Test powinien objąć link z przypomnienia dla klienta z kontem i gościa w jego pierwotnej przeglądarce oraz połączenie i zastąpienie koszyka przed zatwierdzeniem.

Funkcje

• Aktualne kontakty. Email oraz dostępne imię i nazwisko bieżącego klienta, zgodnie z istniejącą zgodą.
• Osobne cele. Newsletter i przypomnienia mają własne zgody oraz książki adresowe.
• Potwierdzenie. SendPulse musi zgłosić Active przy włączonym potwierdzeniu, a New lub Active przy wyłączonym.
• Przypomnienia. Dane koszyka i uprawnienie do przypomnienia zasilają twój scenariusz w SendPulse.
• Rezygnacje. Wycofanie zgody w sklepie tworzy zadanie; kontrole wykrywają rezygnacje w SendPulse.
• Nadzór. Zadania, błędy, kwoty koszyków według waluty i ostatnia aktywność przetwarzania.

Opcje konfiguracji

• Integracja, synchronizacja profili i przypomnienia: osobne przełączniki, wszystkie początkowo wyłączone. Aktualizacja wymaga istniejącej zgody lokalnej. Przełącznik nie udziela zgody za klienta.
• Dostęp: API_key jest używany jako token SendPulse. Zapisane sekrety pozostają ukryte. Zachowanie, zastąpienie i usunięcie wymagają osobnej decyzji.
• Książki: general_list_ID dla newslettera, recovery_list_ID dla przypomnień. Nieużywany cel może pozostać pusty. Oba cele wymagają różnych dodatnich identyfikatorów liczbowych. Książki powinny być przeznaczone dla tego sklepu.
• Potwierdzenie: włączone, jeśli nie zostanie jawnie wyłączone. Wymaga aktywnego sender_email i message_lang; template_id jest opcjonalny. Dozwolone języki to en, ru, ua, tr, es, pt. Polski tekst zgody nie rozszerza języków emaila potwierdzającego.
• Czas: domyślnie 60 minut bezczynności, 14 dni ważności linku, 30 dni przechowywania koszyków i 90 dni historii operacyjnej. Retencja koszyka musi obejmować ważność linku. Czyszczenie nie usuwa dowodów zgody.
• Limity pracy: 100 wierszy, 20 sekund, blokada na 120 sekund, 300 sekund nakładania zakresów kontroli i 12 prób. Ograniczają pojedynczy przebieg, nie gwarantują natychmiastowego przetwarzania.
• Teksty zgód: osobno dla celu i języka en, de, fr, pl, it oraz es, z wersją objaśnienia. Brakujący wpis korzysta z tłumaczenia modułu. Zmieniony formularz wymaga aktualnej decyzji.
• Sekret zadania: osobny dla każdego sklepu, przekazywany w nagłówku Authorization. Panel nie pokazuje zapisanej wartości.

Ogólny identyfikator publiczny, URL konta i mapowanie nie dodają śledzenia SendPulse ani dowolnych pól profilu. URL konta pozostaje pusty. Zakres ustala natywny wybór sklepów. Zmiana dostępu lub książek unieważnia stare zadania i linki, zamiast je przenosić.

Przykłady dostosowania

Najpierw newsletter

Ustaw tylko książkę ogólną, aktywnego nadawcę i obsługiwany język potwierdzenia. Przypomnienia pozostają wyłączone. Po zapisie i diagnostyce odczytu klient testowy udziela zgody na stronie modułu. Uruchom zadania i odróżnij oczekiwanie od potwierdzonego zapisu. Następnie zmiana nazwiska sprawdzi aktualizację profilu z istniejącą zgodą.

Osobny scenariusz przypomnień

Panel podaje mpr_recovery_abandoned, CheckoutURL, EpisodeKey, RecoveryEligible = 1 oraz wygenerowane pola zgody i bieżącego okresu. SendPulse musi wymagać statusu zapisu dopuszczonego przez ustawienie potwierdzenia i liczbowej wartości 1 dla danego celu. Zgoda, uprawnienie i okres muszą być ponownie sprawdzane przed każdą wiadomością. Brak wartości lub zero wyklucza wysyłkę. Oprócz wejścia przetestuj utworzenie zamówienia, wyczyszczenie koszyka i rezygnację. Pięć potwierdzeń sprzedawcy zapisuje wynik jego kontroli, a nie wykonuje testów.

Zadanie cykliczne

Przykład używa zastępczej domeny i sekretu. Zadanie wywołuje natywny adres właściwego sklepu niezależnie od odwiedzin. Musi działać także po wyłączeniu wysyłek, aby przetwarzać rezygnacje:

curl --request POST --header "Authorization: Bearer YOUR_SCHEDULER_SECRET" "https://your-shop.example/module/mprsendpulse/scheduler"

Polityka bezpieczeństwa treści

Żądania do SendPulse wychodzą z serwera sklepu. Integracja nie wymaga dodania domeny SendPulse do przeglądarkowego connect-src. Poniżej jest przykład istniejącej dyrektywy dla własnej domeny, nie kompletna polityka do podmiany. Pozostałe źródła potrzebne sklepowi należy zachować:

connect-src 'self';

Instalacja

Ogólna deklarowana zgodność: PS 1.6 – 9.x. Dokładne minimum modułu: PrestaShop 1.6.1.0. Wymagane są PHP 7.1 lub nowszy, cURL, HTTPS i konto SendPulse.

Zasada działania

Sklep zapisuje tożsamość i koszyk lokalnie, bez wywołań usługi podczas zamówienia. Zadanie uzgadnia zmiany, wykonuje kolejkę i czyści wygasłe dane operacyjne. Pierwszy przebieg obejmuje bieżące okno kontroli. Docelowy odstęp sprawdzania wynosi minutę dla oczekującego zapisu i piętnaście minut dla kontaktu uznanego za zapisany, zależnie od częstości uruchomień i limitów pracy. Moduł nie ma kontrolera powiadomień przychodzących SendPulse.

Dane kontaktowe aktualizowane zgodnie ze zgodą

Moduł przekazuje email oraz dostępne imię i nazwisko do książki właściwej dla wybranego celu. Gdy bieżący klient zmieni dane konta, dozwolona aktualizacja profilu trafia do przetwarzania w tle. Zmiana nazwiska nie zapisuje go ponownie na listę. Logowanie do sklepu także nie tworzy zgody na wysyłkę wiadomości.

Nowy zapis podlega ustawieniom potwierdzenia. Gdy potwierdzenie jest włączone, przyjęcie żądania nie wystarcza: SendPulse musi zgłosić potwierdzony kontakt. Istniejące blokady usługi pozostają wiążące. Moduł obsługuje znane kontakty z odpowiednią zgodą, bez importowania całej bazy klientów ani uznawania pola newslettera PrestaShop za nową zgodę.

Dane do przypomnień porzuconego koszyka w SendPulse

Po wybranym czasie bezczynności uprawniony koszyk przekazuje do SendPulse produkty, kwotę, walutę i link powrotu. Musi nadal zawierać produkty, nie mieć natywnego zamówienia oraz mieć aktualną zgodę na przypomnienia i status SendPulse dopuszczony przez ustawienie potwierdzenia. Późne uzyskanie uprawnienia do przypomnień rozpoczyna nowy okres oczekiwania, zamiast natychmiast uruchamiać przypomnienie o starym koszyku.

Sekwencję wiadomości tworzysz w SendPulse. Przed każdym emailem musi sprawdzać aktualną zgodę, uprawnienie i bieżący okres bezczynności. Moduł przekazuje też informację o zakończeniu uprawnienia. Link w przypomnieniu jest podpisany, przypisany do danego klienta i ma określony termin ważności. Samo otwarcie niczego nie zmienia, także podczas sprawdzania przez skaner linków w emailach. Klient przegląda koszyk, wybiera połączenie z bieżącym koszykiem lub jego zastąpienie, a następnie zatwierdza. Koszyk jest odtwarzany z aktualnymi cenami i kontrolą stanów magazynowych, wraz z personalizacjami i przesłanymi plikami. Test połączenia potwierdza odczyt danych, nie działający scenariusz ani dostarczenie wiadomości.

Rezygnacje uwzględniane po obu stronach

Wycofanie zgody na stronie preferencji blokuje dany cel lokalnie i kolejkuje rezygnację w SendPulse. Rezygnacja z przypomnień unieważnia także linki powrotu do koszyka. Newsletter pozostaje niezależny: wycofanie jednej zgody nie usuwa automatycznie drugiej. Wykonanie operacji po stronie SendPulse zależy od zadania cyklicznego i odpowiedzi usługi.

Przetwarzanie odczytuje również status znanych kontaktów w SendPulse. Wykryte rezygnacje i blokady zapisuje jako zakaz wysyłki w module. Są to okresowe kontrole, a nie natychmiastowe powiadomienia o każdej osobie na koncie. Nowa zgoda w sklepie nie usuwa istniejącej blokady SendPulse. Moduł nie wycofuje wiadomości już przyjętej przez usługę.

Zadania i błędy widoczne dla zespołu

Panel konfiguracji pokazuje operacje kontaktów i koszyków, błędy oraz ostatnią aktywność przetwarzania. Bieżące uprawnienie pochodzi z ostatnio zapisanego stanu. Kwoty koszyków są grupowane według waluty, obok zachowanych liczników odtworzeń i zamknięć przez zamówienie. Te wartości opisują koszyki, a nie przychód przypisany do kampanii email. Waluty nie są przeliczane.

Uruchamiasz oczekującą pracę, ponawiasz dozwolone operacje po błędzie lub anulujesz zadania, dla których jest to dopuszczalne. Niejasna odpowiedź SendPulse wstrzymuje automatyczne powtórzenie, jeśli usługa mogła przyjąć żądanie. Zespół najpierw sprawdza jej historię. Integracja, aktualizacja profili i przypomnienia są początkowo wyłączone, więc to ty decydujesz o uruchomieniu.

Ograniczenia

• SendPulse wysyła wiadomości: teksty, czas wewnątrz scenariusza, dostęp do usługi i dostarczenie należą do konfiguracji konta. Każda wiadomość wymaga aktualnej zgody, uprawnienia i okresu. Przyjętego zdalnie emaila nie da się wycofać tym modułem.
• Bez automatycznego ponownego zapisu: lokalna zgoda nie kasuje blokady usługi. Odczyt statusu nie poświadcza wyraźnego ponownego zapisu w usłudze.
• Bez masowej migracji: pola newslettera, dawni klienci i historyczne koszyki nie są importowane jako zgody. Sama anonimowa wizyta nie dostarcza zweryfikowanego odbiorcy ani uprawnienia.
• Bez pełnej obsługi RODO: nie ma oficjalnych integracji eksportu ani usuwania. Dowody zgód i wspólne dane zostają po czyszczeniu oraz odinstalowaniu. Email, nazwiska i publiczne dane koszyka trafiają do SendPulse; prywatna treść personalizacji i odwołania do plików nie wchodzą do publicznych danych koszyka dla usługi.
• Ograniczony zakres: brak śledzenia w przeglądarce, synchronizacji SMS, publikacji zakupów i zwrotów, przeliczania walut oraz przypisywania przychodu do emaili.

Przy zadaniach oczekujących sprawdź sklep, przełączniki, aktywność, przekazanie Authorization, książki i potwierdzenie. Przed ponowieniem niejasnego żądania sprawdź historię SendPulse, aby nie powtórzyć przyjętej operacji. Zablokowane rezygnacje po zmianie celu mogą wymagać obsługi na starym koncie.