mailhook
mailhook copied to clipboard
ushis
Micro service receiving mails and posting them to web hooks.
mailhook
Micro service receiving emails and posting them to web hooks.
Install
Download the binary from the Releases Page or build from source.
Usage
mailhook -hook-dir /etc/mailhook/hooks -listen :25
Hook Directory
A hook directory contains a number of hook files with .yml extension.
Hook File
A hook file includes a YAML encoded set of web hooks and email address patterns.
---
# catch mails to [email protected] and [email protected]
- hook: 'https://api.example.com/v1/mails'
emails:
- '[email protected]'
# catch mails to *@example.net and *@example.org
- hook: 'http://example.net/messages'
emails:
- '@example.net'
- '@example.org'
# catch all mails
- hook: 'http://example.net/fallback'
emails:
- '@'
Payload
The request that will be sent to the HTTP endpoint will be encoded as multipart/form-data with the following payload:
| Field | Value |
|---|---|
mail[sender] |
SMTP sender address |
mail[recipient] |
SMTP recipient address |
mail[message][from][][name] |
Names taken from the From header |
mail[message][from][][email] |
Adresses takem from the From header |
mail[message][to][][name] |
Names taken from the To header |
mail[message][to][][email] |
Adresses takem from the To header |
mail[message][cc][][name] |
Names taken from the Cc header |
mail[message][cc][][email] |
Adresses takem from the Cc header |
mail[message][bcc][][name] |
Names taken from the Bcc header |
mail[message][bcc][][email] |
Adresses takem from the Bcc header |
mail[message][reply_to][][name] |
Names taken from the ReplyTo header |
mail[message][reply_to][][email] |
Adresses takem from the ReplyTo header |
mail[message][subject] |
Subject of the message |
mail[message][date] |
RFC3339 encoded date of the message |
mail[message][message_id] |
ID taken from the MessageID header |
mail[message][in_reply_to] |
ID taken from the InReplyTo header |
mail[message][references][] |
IDs taken from the References header |
mail[message][text] |
Text body of the message |
mail[message][html] |
HTML body of the message (can be empty) |
mail[message][attachments][] |
Attachments of the message |
ushis