# Postmark + Krokul CRM

Так. Krokul CRM інтегрується з Postmark. Перехід угоди на новий етап, новий документ чи оплачений рахунок надсилає контакту лист за шаблоном Postmark, а вебхуки Postmark повідомляють у ту саму угоду про доставку, відкриття, кліки, відскоки й скарги на спам. Відповіді клієнтів приходять через вхідну обробку Postmark і лягають в угоду активностями. Звʼязка працює через застосунок Krokul у Zapier, Make, n8n і Albato або через API і вебхуки Krokul.

**Статус:** Через API і вебхуки. **Платформи автоматизації:** Zapier, Make, n8n, Albato.

## Що отримує команда

### Події угоди надсилають шаблони Postmark

Ви привʼязуєте подію Krokul до псевдоніма шаблону Postmark. Коли угода доходить до вибраного етапу чи рахунок оплачено, Krokul викликає шаблонний ендпоінт Postmark із TemplateModel, заповненим з угоди, Tag для події та UUID угоди в Metadata. Postmark повертає MessageID. Krokul тримає його в угоді.

### Доставка, відкриття й кліки в стрічці

Postmark надсилає вебхуки Delivery, Open і Click з Metadata початкового листа. Krokul читає UUID угоди, додає подію в стрічку угоди й відкидає повтори за MessageID. Менеджер бачить, коли клієнт уперше відкрив комерційну пропозицію.

### Відскоки й скарги на спам позначають контакт

Вебхук Bounce називає адресу й тип відскоку, наприклад HardBounce. Krokul позначає контакт, записує тип і на жорсткий відскок створює задачу виправити адресу. SpamComplaint чи SubscriptionChange, що зупиняє відправку, теж позначає контакт, і правила подій Krokul його пропускають.

### Відповіді клієнта повертаються в угоду

Вихідні листи угоди мають адресу Reply-To на вхідному сервері Postmark із номером угоди після знака плюс. Коли клієнт відповідає, вебхук Inbound доставляє розібраний лист, а MailboxHash містить цей номер угоди. Krokul знаходить угоду й контакт за адресою From і зберігає StrippedTextReply як активність, а вкладення як посилання на файли.

## Що передається між системами

| Postmark | Krokul | Напрям | Коли |
|---|---|---|---|
| Лист за шаблоном (TemplateAlias, TemplateModel, Metadata) | Етап угоди, документ чи оплачений рахунок | Krokul → Postmark | Спрацьовує подія Krokul |
| MessageID | Коментар в угоді | Postmark → Krokul | Postmark прийняв лист |
| Вебхуки Delivery, Open, Click | Активність в угоді | Postmark → Krokul | Одержувач отримує чи відкриває лист |
| Bounce (HardBounce), SpamComplaint | Позначка й задача на контакті | Postmark → Krokul | Доставка не вдалась чи клієнт поскаржився |
| SubscriptionChange | Позначка на контакті | Postmark → Krokul | Відправку на адресу зупинено чи відновлено |
| Вхідний лист (MailboxHash, StrippedTextReply) | Активність в угоді | Postmark → Krokul | Клієнт відповідає |

## Як підключити сьогодні

### Застосунок Krokul у Zapier, Make, n8n чи Albato

1. Підключіть застосунок Krokul ключем API Krokul, а застосунок Postmark токеном сервера Postmark.
2. Від тригера Krokul Deal Stage Changed чи Invoice Paid викличте Send Email With Template у Zapier або Send Email with Template в Albato.
3. Для зворотного шляху почніть із New Bounce чи New Inbound Message у Zapier, Watch Delivered Emails у Make, Postmark Trigger у n8n або Message Delivery в Albato, потім використайте дії Krokul Find Contact і Add Activity.

### Власний потік через API і вебхуки Krokul

1. Створіть токен сервера Postmark і задайте адресу вебхука з Basic-автентифікацією для Delivery, Bounce, Open, Click і SpamComplaint, а також адресу вхідного вебхука. У Krokul видайте ключ API з правами на контакти, угоди й активності.
2. Підпишіть вебхук Krokul на card.statusChanged та invoice.paid, перевіряйте x-crm-signature і викликайте POST /email/withTemplate з UUID угоди в Metadata.
3. На кожен вебхук Postmark перевіряйте Basic-облікові дані, пропускайте вже оброблений MessageID, знаходьте контакт через contact/api-find і пишіть activity/api-create в угоду.

**Тригери:** New Bounce; New Inbound Message; New Email Open; Watch Delivered Emails; Watch Clicked Emails; Watch Spam Complaints; Watch Subscription Change; Message Delivery; Link Click.

**Дії:** Send an Email; Send Email With Template; Send Email with Template; Send single Email; Activate a Bounce.

### Для інтеграторів

Postmark повторює вебхук після відповідей 5xx, 408 і 429 та мережевих збоїв через 1, 5, 10, 10, 10 і 15 хвилин. Заголовок X-PM-Retries-Remaining показує, скільки спроб лишилось. Інші відповіді 4xx подію відкидають. Postmark також ставить на паузу тип події для адреси, яка постійно падає, доки ви її знову не підтвердите. З боку Krokul Metadata несе UUID угоди, externalRef привʼязує MessageID до активності, а журнал доставок повторює крок, що впав.

[Документація API](https://app.krokul.com/api/v1/docs)

## Питання й відповіді

### Чи інтегрується Krokul з Postmark?

Так. Krokul інтегрується з Postmark через застосунок Krokul у Zapier, Make, n8n і Albato та через свої API і вебхуки, для листів за шаблоном, подій доставки й вхідних відповідей.

### Як відповідь клієнта потрапляє в потрібну угоду?

Адреса Reply-To кожного листа угоди несе номер угоди після знака плюс. Postmark повертає цю частину як MailboxHash у вебхуку Inbound, і Krokul привʼязує відповідь до цієї угоди.

### Як Krokul перевіряє, що вебхук прийшов від Postmark?

Postmark не підписує вебхуки HMAC. Krokul дає Postmark адресу з обліковими даними Basic-автентифікації й приймає виклики лише з IP-діапазонів Postmark.

### Який message stream Postmark використовує Krokul?

Типовий транзакційний потік outbound, якщо в правилі події ви не вибрали інший. Broadcast-потоки лишаються для розсилок, які надсилає сам Postmark.

## Обмеження

Шаблони, підписи відправника, message streams і список блокування Postmark лишаються в Postmark. Вебхуки Postmark не мають HMAC-підпису, тому адресу приймача захищають Basic-автентифікацією й опублікованими IP-діапазонами Postmark.

## Пов’язані сервіси

- [SendGrid](https://krokul.com/uk/integrations/sendgrid/index.md)
- [Brevo](https://krokul.com/uk/integrations/brevo/index.md)
- [Mailchimp](https://krokul.com/uk/integrations/mailchimp/index.md)
- [Gmail](https://krokul.com/uk/integrations/gmail/index.md)
- [Twilio](https://krokul.com/uk/integrations/twilio/index.md)
- [SendPulse](https://krokul.com/uk/integrations/sendpulse/index.md)

[Email-розсилки](https://krokul.com/uk/integrations/category/email-marketing/index.md)

Postmark є торговою маркою ActiveCampaign, LLC. Krokul не афілійований з Postmark.

Оновлено: 2026-10-15

---

Застосунок: https://app.krokul.com/ · API: https://app.krokul.com/api/v1/docs