Webhooki to sposób, w jaki aplikacje mogą komunikować się ze sobą automatycznie i w czasie rzeczywistym. Są to zasadniczo zautomatyzowane wiadomości wysyłane z jednej aplikacji do drugiej, gdy wystąpi określone zdarzenie.
W przeciwieństwie do odpytywania, metody komunikacji aplikacji, która sprawdza aktualizacje w ustalonych odstępach czasu, webhooki przesyłają aktualizacje do użytkownika, umożliwiając natychmiastowe powiadomienia.
Przykład użycia
Wyobraź sobie, że prowadzisz stronę e-commerce i chcesz zaktualizować swój system gromadzenia zapasów za każdym razem, gdy zostanie złożone nowe zamówienie. Bez webhooków konieczne byłoby częste sprawdzanie bazy danych zamówień, aby sprawdzić, czy pojawiły się nowe zlecenia.
Dzięki webhookom platforma e-commerce może automatycznie powiadamiać system gromadzenia zapasów o nowym zamówieniu, gdy tylko się ono pojawi, umożliwiając aktualizację zapasów w czasie rzeczywistym.
Jak działają webhooki
W MailerLite wystąpiło zdarzenie
Zdarzeniem tym może być dowolna istotna czynność, począwszy od wysłania nowej wiadomości e-mail do nowego odbiorcy dołączającego do listy mailingowej lub powiadomienie o odbiciu.
⇩
Żądanie HTTP POST zostało wysłane
Gdy to zdarzenie ma miejsce, MailerLite wysyła żądanie HTTP POST do określonego adresu URL (tzn. Endpoint webhooka). Żądanie to zawiera dane dotyczące zdarzenia.
⇩
Dane zostały dostarczone
MailerLite wysyła to żądanie do określonego przez Ciebie Endpointu URL webhooka. Następnie serwer lub aplikacja przetwarza dane zawarte w elemencie Payload i uruchamia odpowiednie działania w oparciu o zdarzenie.
(Endpoint URL, to adres URL będący punktem końcowym webhooka.
Payload, to fragment przesyłanych danych, będący formą wiadomości.)
⇩
Natychmiastowe powiadomienie
Ponieważ dane są przekazywane natychmiast po wystąpieniu zdarzenia, użytkownik otrzymuje powiadomienia od razu bez konieczności ciągłego sprawdzania aktualizacji.
Konfigurowanie webhooków w MailerLite
Aby skonfigurować webhooki:
Przejdź do sekcji Integracje.
W sekcji MailerLite API znajdź Webhooks.
Kliknij Sprawdź.
4. Przewiń w dół i kliknij Generuj webhook.
5. Nadaj webhookowi nazwę.
6. Wprowadź Endpoint URL.
7. Wybierz Zdarzenia webhooka, które chcesz subskrybować.
Zdarzenia webhooka
Webhooki MailerLite oferują różne wyzwalacze zdarzeń, aby informować Cię o ważnych działaniach na Twoim koncie. Oto zdarzenia, które możesz subskrybować:
subscriber.created: Wyzwalane po dodaniu nowego odbiorcy do konta.
subscriber.updated: Wyzwalane, gdy którekolwiek z pól dodatkowych odbiorcy zostanie zaktualizowane lub gdy potwierdzi on swoją subskrypcję.
subscriber.unsubscribed: Wyzwalane, gdy odbiorca przestaje być subskrybentem.
subscriber.added_to_group: Wyzwalane, gdy odbiorca zostanie dodany do grupy.
subscriber.removed_from_group: Wyzwalane, gdy odbiorca zostanie usunięty z grupy.
subscriber.bounced: Wyzwalane, gdy adres e-mail zostanie odbity.
subscriber.automation_triggered: Wyzwalane, gdy odbiorca uruchamia automatyzację.
subscriber.automation_completed: Wyzwalane, gdy odbiorca zakończy automatyzację.
subscriber.spam_reported: Wyzwalane, gdy odbiorca oznaczy kampanię jako spam.
campaign.sent: Wyzwalane, gdy kampania zostanie wysłana.
campaign.open: Wyzwalane, gdy odbiorca otworzy kampanię. Opcja Włącz grupowanie zdarzeń jest wymagana dla tego webhooka i musi być ustawiona jako True.
campaign.click: Wyzwalane, gdy odbiorca kliknie link w kampanii. Opcja Włącz grupowanie zdarzeń jest wymagana dla tego webhooka i musi być ustawiona jako True.
subscriber.deleted: Wyzwalane, gdy odbiorca zostanie ustawiony jako usunięty lub zapomniany. Opcja Włącz grupowanie zdarzeń jest wymagana dla tego webhooka i musi być ustawiona jako True.
Na koniec należy zaznaczyć opcję Włącz grupowanie zdarzeń.
Czym jest opcja opcję Włącz grupowanie zdarzeń? 🤔
Jest to technika używana w systemach webhook do łączenia wielu powiadomień o zdarzeniach i wysyłania ich w jednym żądaniu, co może być szczególnie przydatne by ograniczyć liczbę żądań HTTP i by lepiej zarządzać obciążeniem serwera.
Kliknij Utwórz Webhook.
Wszystkie utworzone webhooki zostaną wyświetlone na Liście Webhooków. Użyj przycisku Zarządzaj, aby kontrolować ustawienia webhooków.
Webhooki w automatyzacjach
Aby używać webhooków w ścieżkach wiadomości w MailerLite:
Przejdź do sekcji Automatyzacje.
Wybierz opcję Nowa automatyzacja.
W edytorze automatyzacji zdefiniuj wyzwalacz automatyzacji, aby rozpocząć tworzenie.
Kliknij znak +, aby dodać kolejny krok i wybierz opcję Webhook.
5. W prawym pasku bocznym wprowadź adres Webhook URL i Secret Key.
Secret Key możesz znaleźć na stronie Integracje -> Webhooks, w sekcji Zarządzaj przy danym Webhooku, a tam w sekcji Podpisywanie tajne.
