Każdy z webhooków ma swoją strukturę, zależną od jego typu. Po zasubskrybowaniu konkretnego webhook będziesz dostawał poniższe informacje na wskazany adres.
Typ open
1 2 3 4 5 6 7 8 | { "module": "transactional_email", "name": "open", "messageId": "03.02.02.aaaaa.1245...", "ip": "127.0.0.1", "time": 1618996547, "version": 1 } |
Typ click
1 2 3 4 5 6 7 8 9 10 | { "module": "transactional_email", "name": "click", "messageId": "03.02.02.aaaaa.1245...", "ip": "127.0.0.1", "userAgent": "Mozilla/5.0 ...", "url": "https://www.freshmail.pl", "time": 1618996547, "version": 1 } |
Typ bounce
1 2 3 4 5 6 7 8 9 | { "module": "transactional_email", "name": "bounce", "messageId": "03.02.02.aaaaa.1245...", "type": "hard", "reason": "reason ...", "time": 1618996547, "version": 1 } |
Co oznaczają poszczególne pola w strukturze webhook
module
- jakiego modułu dotyczy dany webhook
name
- nazwa zdarzenia. Aktualnie są dostępne:
- open - otwarcie maila
- click - kliknięcie w link znajdujący się w wiadomości mail
- bounce - odbicie wiadomości
messageId
- unikalny identyfikator określający jakiej wiadomości dotyczy informacja
id
- IP odbiorcy maila (ta informacja znajduje się tylko w click i open)
userAgent
klient pocztowy za pomocą jakiego została otwarta wiadomość mail (ta informacja znajduje się tylko w click i open)
url
- adres URL w który odbiorca kliknął (ta informacja jest tylko w click)
time
- czas zdarzenia
reason
- odpowiedź serwera w przypadku odbicia wiadomości email (ta informacja znajduje się tylko w bounce)
type
- określa typ odbicia wiadomości email - może przyjąć dwie wartości: hard, soft (ta informacja znajduje się tylko w bounce)
version
- określa wersję webhook