Ecomail umożliwia wysyłanie informacji z Ecomail do dalszego wykorzystania. Można do tego użyć tzw. webhooków.
ℹ️ Do testowania webhooków zalecamy użyć strony https://requestbin.com/.
1. Webhook w automatyzacji
Webhooki są dostarczane na określony adres URL przy użyciu metody POST w formacie JSON z następującą zawartością:
{"account": "foo", "pipeline": 1, "action": 2, "subscribers":[{"id":792107,"name":null,"email":"[email protected]","gender":null,"inserted_at":"2016-04-20 09:49:14","last_position":null,"surname":null}]}
Gdzie wartości:
account - ID konta w Ecomail
pipeline - ID automatyzacji
action - ID akcji
subscribers - pole z obiektami JSON użytkowników, o których chodzi w tym zdarzeniu
Przetworzanie webhooka jest zależne od używanego języka programowania.
W przypadku PHP może to wyglądać na przykład tak:
$json = json_decode(file_get_contents('php://input'));
Zastosowanie w automatyzacji
W automatyzacji możesz ustawić krok, który wyśle aktualizację danych do webhooka. Automatyzacja może wyglądać następująco:
Krok "Wyślij do webhook" będzie wyglądać następująco:
ℹ️ Aktualnie Ecomail nie sprawdza, czy webhook został przetworzony pomyślnie, czy nie, i pozostawia tę odpowiedzialność klientowi.
2. Aktywność w kampanii
Jeśli chcesz uzyskać informacje o poszczególnych zdarzeniach z wysłanej kampanii, takich jak dostarczenie, odbicie, kliknięcie itp. możesz to zrobić za pomocą webhooka.
Webhook jest wysyłany metodą POST w formie JSON na zdefiniowany adres url. Jeśli webhook nie zostanie odebrany w ciągu 10 sekund, nastąpi przekroczenie limitu czasu. Po ustawieniu adresu url dla webhooka, zostanie wysłany przykładowy webhook.
Konfiguracja adresu url do wysyłania webhooków
Ustaw adres URL w sekcji Zarządzaj kontem > Dla deweloperów > Webhook
Zdarzenia, które są wysyłane to:
bounce
delivery
injection
spam_complaint
out_of_band
policy_rejection
delay
click
open
initial_open
amp_click
amp_open
amp_initial_open
generation_failure
generation_rejection
list_unsubscribe
link_unsubscribe
relay_injection
relay_rejection
relay_delivery
relay_tempfail
relay_permfail
ab_test_completed
ab_test_cancelled
success
error
Wszystkie wydarzenia są dostępne tutaj.
❓
Masz pytanie? Napisz do nas na [email protected]