Listmonk
Listmonk
Listmonk to samodzielnie hostowany menedżer newsletterów i list mailingowych, który organizatorzy mogą używać wewnętrznie do wysyłania e-maili informacyjnych do uczestników.
Listmonk można zainstalować na własnym serwerze lub szybko i łatwo skonfigurować w chmurze.
Oto kilka chmur, w których można szybko skonfigurować system Listmonk:
| Usługi w chmurze |
|---|
![]() |
Panel Listmonk wygląda tak:
Aby połączyć Listmonk, przejdź do ustawień klubu -> "Integracje".
Ustawienia klubu znajdują się w lewym dolnym rogu.

W sekcji integracji znajdź Listmonk i kliknij "Połącz".

Aby połączyć Listmonk, należy wypełnić następujące pola:

Po wypełnieniu pól i naciśnięciu "Zapisz", system spróbuje połączyć się z Listmonk i zweryfikować, czy połączenie działa.
Po nawiązaniu połączenia możesz wybrać projekt e-maila i wykonać następujące czynności:
- Wybierz projekt e-maila, który jest wysyłany, gdy członkostwo zostanie pomyślnie opłacone.
- Wykonaj synchronizację wydarzeń.
- Synchronizuj e-maile członków.
- Wyślij testowy "E-mail zakupu".
Synchronizacja wydarzeń (zawody lub wyzwania) #
Każde wydarzenie organizatora tworzy nową listę e-mailową w Listmonk, umożliwiając powiązanie uczestników z konkretną listą e-mailową, aby organizator mógł wysyłać e-maile tylko do uczestników tego konkretnego wydarzenia.
Naciskając przycisk "Zainicjuj pełną synchronizację wydarzeń", wszystkie wydarzenia są tworzone w Listmonk.
Wszystkie wydarzenia będą zapisane w następującym formacie: "Rok - Nazwa zawodów".
Dodając nowego uczestnika do Listmonk, system sprawdza, czy konkretne wydarzenie zostało utworzone; jeśli nie, jest tworzone.
Synchronizacja uczestników #
Za każdym razem, gdy dokonywany jest zakup (opłata członkowska), wysyłane jest żądanie do Listmonk i dodawane są e-maile uczestników. Dodawany jest zarówno "e-mail rozliczeniowy", który kupujący musi wypełnić, jak i wszystkie e-maile przypisane do uczestników.
Każdy uczestnik jest dodawany do konkretnej listy zawodów i przypisywane są następujące atrybuty:

- Wydarzenia - zawiera listę wszystkich wydarzeń, w których uczestnik brał udział.
- Marketing - zawiera informacje o preferencjach "marketingowych" zaznaczonych podczas kroku zakupu.
Te informacje mogą być używane do filtrowania uczestników i dodawania ich do nowych list mailingowych.
Na przykład, aby znaleźć wszystkich uczestników, którzy zaznaczyli, że chcą otrzymywać wiadomości, można użyć następującego zapytania: (subscribers.attribs->'marketing'->>'News')::BOOLEAN = true.

Wykonanie tego zapytania wybierze wszystkich uczestników, którzy zaznaczyli, że chcą otrzymywać wiadomości.
Początkowa synchronizacja uczestników #
Aby wykonać początkową synchronizację uczestników, należy nacisnąć przycisk "Zainicjuj pełną synchronizację danych z Listmonk". Należy pamiętać, że może to zająć więcej czasu, jeśli liczba uczestników jest duża.
E-mail potwierdzający zakup #
DistantRace wysyła automatyczny e-mail z systemu, gdy uczestnik opłaca swoje uczestnictwo, ale organizatorzy mogą stworzyć własny projekt e-maila.
Ważne jest, aby w e-mailu zawrzeć następujące informacje:
- Co jest opłacane i kwoty
- Całkowita opłacona kwota
- Link do potwierdzenia zakupu
Jak stworzyć e-mail i połączyć go z DistantRace?
- Stwórz e-mail potwierdzający zakup.
W Listmonk można tworzyć projekty e-maili "Transakcyjnych". Stwórz nowy projekt dla potwierdzenia zakupu.

Oto uproszczony przykład e-maila:
<!doctype html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1">
<base target="_blank">
<style>
body {
background-color: #F0F1F3;
font-family: 'Helvetica Neue', 'Segoe UI', Helvetica, sans-serif;
font-size: 15px;
line-height: 26px;
margin: 0;
color: #444;
}
pre {
background: #f4f4f4f4;
padding: 2px;
}
table {
width: 100%;
border: 1px solid #ddd;
}
table td {
border-color: #ddd;
padding: 5px;
}
table th {
border-color: #000;
padding: 5px;
text-align: left;
}
.wrap {
background-color: #fff;
padding: 30px;
max-width: 525px;
margin: 0 auto;
border-radius: 5px;
}
.button {
background: #0055d4;
border-radius: 3px;
text-decoration: none !important;
color: #fff !important;
font-weight: bold;
padding: 10px 30px;
display: inline-block;
}
.button:hover {
background: #111;
}
.footer {
text-align: center;
font-size: 12px;
color: #888;
}
.footer a {
color: #888;
margin-right: 5px;
}
.gutter {
padding: 30px;
}
img {
max-width: 100%;
height: auto;
}
a {
color: #0055d4;
}
a:hover {
color: #111;
}
@media screen and (max-width: 600px) {
.wrap {
max-width: auto;
}
.gutter {
padding: 10px;
}
}
</style>
</head>
<body style="background-color: #F0F1F3;font-family: 'Helvetica Neue', 'Segoe UI', Helvetica, sans-serif;font-size: 15px;line-height: 26px;margin: 0;color: #444;">
<div class="gutter" style="padding: 30px;"> </div>
<div class="wrap" style="background-color: #fff;padding: 30px;max-width: 525px;margin: 0 auto;border-radius: 5px;">
<p>Hello {{ .Subscriber.Name }}</p>
<p>
<strong>Order number: </strong> {{ .Tx.Data.orderNumber }}<br />
<strong>Created date: </strong> {{ .Tx.Data.createdAt }}<br />
</p>
<br />
<table>
<tr><th>Name</th><th>Price</th></tr>
{{range .Tx.Data.products}} <tr><td>{{.title }}</td><td>{{.price}} {{ .Tx.Data.currency }}</td></tr>{{end}}
</table>
Total price: {{ .Tx.Data.orderSum }} {{ .Tx.Data.currency }}
<br />
<p>
<a href="{{ .Tx.Data.orderUrl }}">Open Order</a>
</p>
</div>
<div class="footer" style="text-align: center;font-size: 12px;color: #888;">
<p>{{ L.T "public.poweredBy" }} <a href="https://listmonk.app" target="_blank" rel="noreferrer" style="color: #888;">listmonk</a></p>
</div>
</body>
</html>
Wizualnie ten HTML wygląda tak:

- Gdy projekt jest gotowy, należy wybrać konkretny szablon w integracji Listmonk w DistantRace:

Jeśli projekt nie jest dostępny, naciśnij przycisk "Aktualizuj" (naciśnięcie tego przycisku odświeża listę projektów) i ponownie otwórz integrację.
- Po wybraniu i zapisaniu projektu, możesz przetestować, jak wygląda projekt, wysyłając testowy e-mail. Naciśnij przycisk "Test Order Email (if template is set)".
To wszystko - od tego momentu, jeśli uczestnik opłaci swoje uczestnictwo, zostanie wysłany tylko Twój zaprojektowany e-mail.
Oto przykład z informacjami, które są wysyłane do Listmonk w celu wysłania e-maila:
{
"subscriber_email": email,
"template_id": template_id,
"data": {
"orderID": "36902",
"orderNumber": 36902,
"firstName": first_name,
"lastName": last_name,
"cartID": "36902",
"orderUrl": "https://distantrace.com/en/cart/d5949dac-b7d9-4e93-a874-34946286c006/",
"currency": "EUR",
"orderSum": 30.0,
"createdAt": "2024-05-02 15:50",
"updatedAt": "2024-05-02 16:36",
"paymentMethod": "payment with card",
"paymentStatus": "paid",
"tags": ["Competition Name"],
"products": [
{
"cartProductID": 85268,
"productID": "607",
"variantID": "432",
"variantTitle": "Distance Name",
"title": "Participant Name - Competition Name, Distance Name, Additional products",
"vendor": "Competition Name",
"quantity": 1,
"price": 15.0,
},
{
"cartProductID": 85268,
"productID": "607",
"variantID": "432",
"variantTitle": "Distance Name",
"title": "Participant Name - Competition Name, Distance Name, Additional products",
"vendor": "Competition Name",
"quantity": 1,
"price": 15.0,
},
],
},
"content_type": "html",
}

