# SendGrid + Krokul CRM

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

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

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

### Контакти Krokul у списках Marketing Contacts

Коли контакт створено чи змінено в Krokul, конектор записує його через Marketing Contacts API SendGrid з поштою, імʼям та ідентифікаторами списків, які ви вибрали. UUID контакту Krokul передається як external_id. SendGrid відповідає ідентифікатором завдання й завершує імпорт у фоні.

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

Ви привʼязуєте подію Krokul, наприклад виграну угоду чи оплачений рахунок, до динамічного шаблону SendGrid. Krokul викликає Mail Send з ідентифікатором шаблону, заповнює dynamic_template_data назвою угоди, сумою, номером документа й імʼям менеджера та кладе UUID угоди в custom_args. Коментар в угоді фіксує, який шаблон пішов і кому.

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

SendGrid надсилає події пачками на Event Webhook, і кожна подія несе custom_args з початкового листа. Krokul читає з них UUID угоди й додає події delivered, open і click у стрічку угоди. Менеджер бачить, що клієнт відкрив пропозицію, ще до дзвінка.

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

Події типу bounce, dropped, spamreport, unsubscribe і group_unsubscribe ставлять на контакт Krokul позначку з причиною від SendGrid. Відскок ще й створює задачу перевірити адресу. Далі Krokul пропускає цей контакт у наступних відправках за тим самим правилом.

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

| SendGrid | Krokul | Напрям | Коли |
|---|---|---|---|
| Marketing contact (external_id, list_ids) | Контакт | Krokul → SendGrid | Контакт створено чи змінено |
| Mail Send з template_id і dynamic_template_data | Виграна угода, документ чи оплачений рахунок | Krokul → SendGrid | Спрацьовує подія Krokul |
| Event Webhook delivered, open, click | Активність в угоді | SendGrid → Krokul | SendGrid обробляє лист |
| Event Webhook bounce, dropped | Позначка й задача на контакті | SendGrid → Krokul | Лист неможливо доставити |
| Event Webhook spamreport, unsubscribe, group_unsubscribe | Позначка на контакті | SendGrid → Krokul | Одержувач відмовляється від листів |
| custom_args (UUID угоди) | Посилання на угоду | Krokul → SendGrid → Krokul | Кожна відправка за шаблоном |

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

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

1. Підключіть застосунок Krokul ключем API Krokul, а застосунок SendGrid ключем API SendGrid.
2. Від тригера Krokul Contact Created викличте Create or Update Contact у Zapier, Add or Update a Contact (New) у Make або New\Update contact в Albato.
3. Від тригера Krokul Deal Won чи Invoice Paid викличте Send Email у Zapier, Mail Send в Albato або операцію Mail вузла SendGrid у n8n зі своїм шаблоном.

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

1. Створіть ключ API SendGrid з доступом до Mail Send і Marketing. У Krokul видайте ключ API з правами на контакти, угоди й активності.
2. Підпишіть вебхук Krokul на contact.created, card.won і invoice.paid, перевіряйте x-crm-signature, потім викликайте PUT /v3/marketing/contacts або POST /v3/mail/send з UUID угоди в custom_args.
3. Увімкніть у SendGrid підписаний Event Webhook і перевіряйте ECDSA-підпис на кожній пачці.
4. Кожну подію дедуплікуйте за sg_event_id, знаходьте контакт через contact/api-find і пишіть activity/api-create в угоду з custom_args.

**Тригери:** Watch new Recipients (Legacy); Watch new Lists (Legacy).

**Дії:** Send Email; Create or Update Contact; Find List by Name; Add or Update a Contact (New); Add Emails to Global Suppression; Mail Send; Search Contacts by Emails.

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

Event Webhook SendGrid надсилає JSON-масив подій, кожна з sg_event_id для дедуплікації та sg_message_id для листа. Підписаний вебхук несе ECDSA-підпис у X-Twilio-Email-Event-Webhook-Signature, а мітку часу в другому заголовку; доступний і OAuth з client credentials. SendGrid застерігає від персональних даних у custom_args, тому Krokul передає лише UUID угоди. Імена туди не потрапляють. З боку Krokul contact/api-find знаходить одержувача, а журнал доставок повторює крок, що впав.

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

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

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

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

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

Krokul додає UUID угоди в custom_args кожного листа. SendGrid повертає custom_args у кожній події Event Webhook, тож відкриття й кліки потрапляють в угоду, з якої пішов лист.

### Чи перестає Krokul писати на адресу з відскоком?

Так. Подія bounce чи dropped позначає контакт у Krokul, і правила відправки такий контакт пропускають. SendGrid також тримає для цієї адреси власний список блокування.

### Які шаблони може використовувати Krokul?

Динамічні шаблони SendGrid з ідентифікаторами, що починаються з d-. Дизайн шаблону живе в SendGrid, а Krokul надсилає лише ідентифікатор шаблону й значення його полів.

## Обмеження

Шаблони, домени відправника, репутація IP і групи відписок налаштовуються в SendGrid. Запис контактів у SendGrid іде фоновими завданнями, тож новий контакт зʼявляється у списку трохи пізніше, ніж Krokul його надіслав.

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

- [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)
- [Twilio](https://krokul.com/uk/integrations/twilio/index.md)
- [SendPulse](https://krokul.com/uk/integrations/sendpulse/index.md)
- [ActiveCampaign](https://krokul.com/uk/integrations/activecampaign/index.md)

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

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

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

---

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