# Mailgun + Krokul CRM

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

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

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

### Подія угоди надсилає шаблон Mailgun

Ви привʼязуєте подію Krokul до шаблону Mailgun, наприклад оплачений рахунок до квитанції. Krokul викликає Messages API з назвою шаблону, заповнює t:variables назвою угоди, сумою й номером документа та додає UUID угоди параметром v:deal_uuid. Стрічка угоди фіксує, який шаблон пішов і на яку адресу.

### Доставка й реакція в стрічці угоди

Mailgun надсилає вебхук на події delivered, opened і clicked, і кожна з них несе user-variables початкового листа. Krokul читає з них UUID угоди й додає подію в угоду. Менеджер бачить відкриту пропозицію ще до дзвінка.

### Збої й скарги позначають контакт

Подія permanent_fail каже Krokul, що адреса не приймає пошту. Krokul ставить на контакт позначку з причиною з події й відкриває задачу перевірити адресу. Події complained і unsubscribed теж позначають контакт, і наступні правила відправки його пропускають.

### Відповіді клієнтів через маршрут Mailgun

Маршрут із match_recipient на вашу адресу для відповідей пересилає кожен вхідний лист у Krokul. Пересилання несе відправника, тему, stripped-text без цитованої історії та message-headers. Krokul знаходить контакт за адресою відправника, за In-Reply-To виходить на надісланий лист і додає відповідь коментарем у ту угоду.

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

| Mailgun | Krokul | Напрям | Коли |
|---|---|---|---|
| Messages API з шаблоном і t:variables | Виграна угода, документ чи оплачений рахунок | Krokul → Mailgun | Спрацьовує подія Krokul |
| Параметр v:deal_uuid | Посилання на угоду | Krokul → Mailgun → Krokul | Кожна відправка |
| Вебхук delivered, opened, clicked | Активність в угоді | Mailgun → Krokul | Mailgun обробляє лист |
| Вебхук permanent_fail | Позначка й задача на контакті | Mailgun → Krokul | Адреса відхиляє лист |
| Вебхук complained, unsubscribed | Позначка на контакті | Mailgun → Krokul | Одержувач відмовляється від листів |
| Маршрут forward() зі stripped-text | Коментар в угоді | Mailgun → Krokul | Клієнт відповідає |
| Учасник mailing list | Контакт | Krokul → Mailgun | Створено контакт |

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

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

1. Підключіть застосунок Krokul ключем API Krokul, а Mailgun ключем API Mailgun і своїм доменом відправки.
2. Від тригера Krokul Invoice Paid чи Deal Won викличте Send Email у Zapier або Send an email у n8n.
3. Від New Bounce Event чи New Inbound Email via Route у Zapier або New Event: Permanent Failure у Make викличте пошук Krokul Find Contact, а далі Add Comment чи Create Task.
4. Від тригера Krokul Contact Created викличте Add Mailing List Member у Zapier або Add a Mailing List Member у Make.

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

1. Створіть ключ API Mailgun для домену відправки й скопіюйте Webhook Signing Key. У Krokul видайте ключ API з правами на контакти, угоди й активності.
2. Підпишіть вебхук Krokul на card.won, document.created і invoice.paid, перевіряйте x-crm-signature й надсилайте лист через Messages API з UUID угоди у v:deal_uuid.
3. Зареєструйте вебхуки Mailgun на delivered, opened, clicked, permanent_fail, complained і unsubscribed. Перевіряйте HMAC-SHA256 від timestamp і token на кожному запиті, потім пишіть activity/api-create в угоду з user-variables.
4. Додайте маршрут із match_recipient і forward() на свій приймач, знаходьте відправника через contact/api-find і пишіть відповідь коментарем.

**Тригери:** New Delivery Event; New Open/Click Event; New Bounce Event; New Failed Delivery Event; New Complaint Event; New Unsubscribe Event; New Inbound Email via Route; New Event: Permanent Failure; New Event: Opens; New Event: Clicks.

**Дії:** Send Email; Add Mailing List Member; Validate Email; Add a Mailing List Member; Create a Route; Send an email.

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

Mailgun підписує кожен вебхук і кожне пересилання маршруту ключем Webhook Signing Key облікового запису. Приймач рахує HMAC-SHA256 від timestamp, зʼєднаного з token, і порівнює з signature. Відповідь 406 відхиляє запит остаточно, а після інших помилок Mailgun повторює спроби близько восьми годин. Приймач перевіряє кожен запит. З боку Krokul ідентифікатор листа Mailgun живе зовнішнім ключем активності, а журнал доставок Krokul повторює крок, що впав.

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

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

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

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

### Як подія Mailgun знаходить потрібну угоду?

Krokul додає UUID угоди параметром v:deal_uuid до кожного листа. Mailgun повертає його в user-variables кожного вебхука, тож подія потрапляє в угоду, з якої пішов лист.

### Чи доходять у Krokul відповіді клієнтів на лист Mailgun?

Так. Маршрут Mailgun пересилає відповіді в Krokul зі stripped-text, тож коментар в угоді містить нову відповідь без цитованого листування.

### Що відбувається після остаточного збою доставки?

Mailgun не повторює доставку після permanent_fail. Krokul позначає контакт, відкриває задачу виправити адресу й пропускає контакт у наступних відправках за тим самим правилом.

## Обмеження

Домени відправки, записи DNS, шаблони й репутація IP налаштовуються в Mailgun. Mailgun показує власні змінні одержувачу в заголовку листа й обрізає їх у подіях понад 4 КБ, тому Krokul передає туди лише ідентифікатори записів.

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

- [SendGrid](https://krokul.com/uk/integrations/sendgrid/index.md)
- [Postmark](https://krokul.com/uk/integrations/postmark/index.md)
- [Brevo](https://krokul.com/uk/integrations/brevo/index.md)
- [Mailchimp](https://krokul.com/uk/integrations/mailchimp/index.md)
- [SendPulse](https://krokul.com/uk/integrations/sendpulse/index.md)

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

Mailgun є торговою маркою Mailgun Technologies, Inc. Krokul не афілійований з Mailgun.

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

---

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