- Puk Puk - Kto tam? - Ma艂pa 馃摤

No hej!

Po temacie maila mo偶ecie zastanawia膰 si臋 o co chodzi... Ju偶 t艂umaczymy.

Chcieliby艣my Wam si臋 troch臋 pochwali膰 jaka technologia stoi za newsletterem. Bo ostatnio si臋 troch臋 u nas zmieni艂o - na tytu艂ow膮 ma艂p臋, czyli Mailchimpa!

Podstawy

Za ca艂ym newsletterem stoj膮 aktualnie 3 serwisy - Contentful, Mailchimp oraz nasza strona. Jak dok艂adnie si臋 艂膮cz膮? Ju偶 t艂umacz臋:

  • Contentful odpowiada za przechowywanie newsletter贸w. To tutaj piszemy ich tre艣膰 oraz trzymamy dane takie jak data wysy艂ki, tytu艂, etc. Contentful jako CMS 艣wietnie si臋 tu sprawdza - jest bardzo prosty w obs艂udze, a za razem bardzo rozszerzalny dzi臋ki Webhookom, kt贸re pomagaj膮 nam 艂膮czy膰 wszystko w ca艂o艣膰
  • Mailchimp z kolei odpowiada za trzymanie listy kontakt贸w oraz wysy艂anie maili. Dodatkowo, gdy kto艣 nowy zarejestruje si臋 do newslettera, mailchimp automatycznie wysy艂a e-mail powitalny z odcinkiem specjalnym (je偶eli jeszcze nie jeste艣cie zapisani, to serdecznie zapraszamy!)
  • letter.podcast.gq To tutaj dzieje si臋 "magia". Pierwsz膮 funkcjonalno艣ci膮 stronki newslettera jest formularz do rejestracji - po kilkni臋ciu przycisku Zapisz si臋, wysy艂ane jest zapytanie do serverless funkcji (stworzonej z pomoc膮 Next API Routes), kt贸ra wysy艂a zapytanie do API Mailchimpa i dodaje maila do listy. Drug膮 jej cz臋艣ci膮 jest archiwum newsletter贸w - tutaj korzystamy z API Contentful'a i statycznie generujemy strony archiwum (za pomoc膮 getStaticPaths oraz getStaticProps).

Najciekawszy jest natomiast sam mechanizm wysy艂ania maila

W tym procesie uczestnicz膮 wszystkie 3 serwisy, a ca艂y pipeline wygl膮da nast臋puj膮co:

  1. Publikujemy list na Contentfulu
  2. Contentful za pomoc膮 Webhooka wysy艂a informacj臋 do naszej funkcji /api/send z danymi 艣wie偶ego newslettera (tytu艂 i zawarto艣膰 w formacie markdown)
  3. Nasza funkcja t艂umaczy markdown'a na HTML'a, nast臋pnie pobiera template maila i za pomoc膮 Mustache wrzuca do niego HTML'a tre艣ci, tworzy now膮 kampani臋 na Mailchimp'ie oraz ustawia jej tre艣膰 na template z tre艣ci膮 maila.
  4. Logujemy si臋 na Mailchimpa, weryfikujemy zawarto艣膰 maila i wysy艂amy go w 艣wiat do naszej listy odbiorc贸w! 馃摛

Linki do rzeczy, z kt贸rych korzystamy

Pytanie do Was

Razem ze zmian膮 platformy, postanowili艣my zmieni膰 r贸wnie偶 template maila. Dajcie zna膰 co o nim s膮dzicie, a je偶eli zauwa偶yli艣cie jaki艣 b艂膮d - szybko nas o nim poinformujcie, odpowiadaj膮c na tego maila - klient贸w mailowych jest pe艂no, a niestety standard贸w brak, wi臋c jedyn膮 form膮 weryfikacji poprawno艣ci templatki, jest spytanie si臋 was 馃槃

Nast臋pnych list贸w oczekujcie w najbli偶szym czasie, a je偶eli jeszcze nie przes艂uchali艣cie najnowszego odcinka o Module Bundlerach - zach臋camy was by艣cie to zrobili! Tymczasem, zapraszamy was ju偶 na nast臋pny odcinek, bo b臋dzie na prawd臋 ciekawie (spoiler: b臋dziemy mieli go艣cia 馃槈).

Pozdro i mi艂ego weekendu! ~ Adam z Require Podcast