# Instagram Direct + Krokul CRM

Так. Krokul CRM інтегрується з Instagram Direct через Instagram Messaging API. Повідомлення у ваш професійний акаунт стає контактом, угодою й тредом у розділі «Комунікації», а менеджер відповідає з Krokul у ту саму розмову в Direct. Повідомлення доходять до Krokul через його API та вебхуки.

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

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

### Питання під фото товару стає угодою

Покупець бачить товар у вашій стрічці й пише в Direct. Meta доставляє повідомлення в Krokul через поле вебхука `messages` з Instagram-scoped ID відправника. Krokul створює контакт з іменем користувача в Instagram, відкриває угоду у воронці, вибраній для Instagram, і починає тред.

### Менеджер магазину відповідає без телефона

Повідомлення з’являється в «Комунікаціях». Менеджер відповідає з картки угоди, і Krokul надсилає текст через Instagram Messaging API, тож покупець бачить його в Direct. Фото, які надсилає покупець, лишаються в угоді як файли.

### Відлік 24 годин видно на треді

Кожен тред Instagram показує, коли закривається вікно для відповіді. Якщо ніхто не відповів, Krokul ставить задачу менеджеру угоди до закриття вікна. Покупець, який написав увечері, все одно вчасно отримує відповідь.

### Той самий покупець у різних каналах

Коли покупець згодом залишає в Direct телефон чи email і менеджер записує його в контакт, заявки з форм сайту й дзвінки з цього номера зіставляються з тією самою людиною. Тред Instagram лишається в історії контакту.

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

| Instagram Direct | Krokul | Напрям | Коли |
|---|---|---|---|
| Повідомлення в Direct (поле вебхука `messages`) | Контакт, угода й повідомлення в треді | Instagram → Krokul | Кожне повідомлення в професійний акаунт |
| Instagram-scoped ID та ім’я користувача | Зовнішній ключ та ім’я контакту | Instagram → Krokul | Перше повідомлення людини |
| Повідомлення, надіслане через Messaging API | Відповідь, набрана в треді Krokul | Krokul → Instagram | Протягом 24 годин після останнього повідомлення |
| Зображення в повідомленні | Файл в угоді | Instagram ↔ Krokul | Коли його надсилає будь-яка сторона |
| 24-годинне вікно для відповіді | Строк відповіді й задача менеджеру | Instagram → Krokul | Після кожного повідомлення без відповіді |

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

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

1. Переведіть акаунт Instagram у професійний (бізнес чи автор) і дайте своєму застосунку Meta дозволи на повідомлення. У Krokul створіть ключ API для контактів, угод і активностей.
2. Ваш приймач відповідає на перевірочний GET значенням `hub.challenge` і перевіряє `X-Hub-Signature-256` у кожному отриманому повідомленні.
3. Для нового відправника викличте contact/api-create і card/api-create та прив’яжіть Instagram-scoped ID до контакту через externalRef/api-upsert. Далі кожне повідомлення йде в угоду через activity/api-create.
4. Щоб привітати нового покупця в межах 24-годинного вікна, підпишіть вебхук Krokul на card.created, перевіряйте його заголовок x-crm-signature і відповідайте через Messaging API.

**Тригери:** New Media Posted in my Account; New Tagged Media.

**Дії:** Publish Photo(s); Publish Video.

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

Команди з власним застосунком Meta можуть приймати вебхуки Instagram самі. Такий приймач відповідає на перевірочний GET значенням `hub.challenge`, перевіряє `X-Hub-Signature-256` і далі пише в Krokul через публічний REST API. Зберігайте Instagram-scoped ID через `externalRef/api-set` і записуйте кожне повідомлення як активність типу `message`: публічний API приймає її так само, як застосунок.

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

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

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

Так. Krokul інтегрується з Instagram Direct через свої API та вебхуки. Приймач вебхука Instagram Messaging API перетворює повідомлення в Direct на контакти, угоди й треди в Krokul.

### Чи потрібен бізнес-акаунт або акаунт автора?

Так. Meta описує Messaging API для професійних акаунтів Instagram, тож особистий акаунт підключити не вийде.

### Чи можуть Zapier або Make ловити повідомлення з Instagram Direct замість цього?

Їхні стандартні застосунки Instagram for Business працюють із медіа, позначками й коментарями, тригера на повідомлення в Direct там немає. Для Direct приймач вебхука Messaging API пише в Krokul через його API.

### Чи може Krokul першим написати підписнику?

Ні. Instagram дозволяє бізнесу написати людині після того, як вона написала в акаунт, і відповідь має прийти протягом 24 годин.

## Обмеження

Krokul працює з повідомленнями в Direct професійного акаунта Instagram. Дописи, коментарі й особисті акаунти лишаються в Instagram. Meta дозволяє бізнесу написати людині лише після того, як вона написала першою, і на відповідь є 24 години.

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

- [Facebook Messenger](https://krokul.com/uk/integrations/facebook-messenger/index.md)
- [WhatsApp Business](https://krokul.com/uk/integrations/whatsapp-business/index.md)
- [Telegram](https://krokul.com/uk/integrations/telegram/index.md)
- [Meta Lead Ads](https://krokul.com/uk/integrations/meta-lead-ads/index.md)
- [Typeform](https://krokul.com/uk/integrations/typeform/index.md)

[Месенджери з клієнтами](https://krokul.com/uk/integrations/category/messaging/index.md)

Instagram є торговельною маркою Instagram, LLC, що входить до Meta Platforms, Inc. Krokul не пов’язаний з Meta чи Instagram.

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

---

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