# Facebook Messenger + Krokul CRM

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

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

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

### Розмова зі сторінкою відкриває угоду

Людина пише на вашу сторінку, і Meta надсилає вебхук із полем `messages`. Krokul читає page-scoped ID відправника, бере імʼя з профілю Messenger, створює контакт і відкриває угоду у воронці, заданій для Messenger. Наступні повідомлення цієї людини потрапляють у той самий тред.

### Один тред на людину, відповідь з угоди

Чат Messenger видно в «Комунікаціях» і в картці угоди, поруч із комерційними пропозиціями й задачами. Коли менеджер набирає відповідь, Krokul надсилає її через Send API від імені сторінки. Зображення й файли від людини зберігаються в угоді.

### Команда бачить вікно для відповіді

Кожен тред Messenger показує, скільки лишилось від 24-годинного вікна. Коли вікно минуло, Krokul пропонує відповідь людини з тегом HUMAN_AGENT, поки тривають 7 днів. Після цього Krokul повідомляє менеджеру, що Messenger більше не приймає повідомлень у цій розмові.

### Контактні дані зводять людину з різних каналів

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

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

| Facebook Messenger | Krokul | Напрям | Коли |
|---|---|---|---|
| Повідомлення на сторінку (поле вебхука `messages`) | Контакт, угода й повідомлення в треді | Messenger → Krokul | Кожне повідомлення від людини |
| Page-scoped ID й імʼя з профілю | Контакт із зовнішнім ключем | Messenger → Krokul | Перше повідомлення людини |
| Повідомлення від сторінки через Send API | Відповідь, набрана в треді Krokul | Krokul → Messenger | Коли менеджер надсилає її в межах дозволеного вікна |
| Вкладення (зображення, файл) | Файл в угоді | Messenger ↔ Krokul | Коли його надсилає будь-яка сторона |
| Звіти про доставку й прочитання (`message_deliveries`, `message_reads`) | Статус надісланих повідомлень | Messenger → Krokul | Коли їх повідомляє Meta |

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

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

1. Підключіть застосунок Krokul із ключем API.
2. Зʼєднайте тригер Messenger New Message Sent to Page з діями Krokul на кшталт Create Contact, Create Deal чи Add Activity.
3. Для вихідних повідомлень почніть із тригера Krokul, наприклад Deal Stage Changed, і запустіть Send Message From Page.

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

1. Створіть ключ API Krokul із правами на контакти, угоди й активності.
2. В обробнику вебхуків сторінки шукайте відправника через contact/api-find. Якщо людина нова, створіть контакт і угоду через contact/api-create і card/api-create, а page-scoped ID збережіть через externalRef/api-upsert.
3. Кожне вхідне повідомлення записуйте в угоду через activity/api-create.
4. Для відповідей підпишіть вебхук Krokul на card.statusChanged, перевіряйте його заголовок x-crm-signature і надсилайте текст через Send API своєї сторінки.

**Тригери:** New Message Sent to Page.

**Дії:** Send Message From Page.

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

Власний обробник для Messenger відповідає на перевірочний GET значенням `hub.challenge` і звіряє `X-Hub-Signature-256` із секретом застосунку. З боку Krokul він працює з публічним REST API за ключем, зберігає page-scoped ID як зовнішній ключ контакта й записує рядки чату як активності типу `message`. Вебхуки Krokul підписані HMAC-SHA256, і їх можна повторно надіслати з журналу доставок.

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

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

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

Так. Krokul інтегрується з Facebook Messenger через застосунок Krokul у Zapier і Make, а також через свої API й вебхуки.

### Що потрібно з боку Facebook?

Сторінка Facebook і людина з правом керувати її повідомленнями. Під час входу вона підтверджує доступ для Krokul.

### Чому через добу відповідь можуть не прийняти?

Meta дозволяє компанії відповідати протягом 24 годин після останнього повідомлення людини. Відповідь людини з тегом HUMAN_AGENT дозволена до 7 днів. Krokul показує, яке з правил діє для кожного треду.

### Як Krokul упізнає ту саму людину пізніше?

За page-scoped ID, який Messenger дає кожній людині для вашої сторінки. Krokul зберігає його як зовнішній ключ контакта.

## Обмеження

Krokul веде розмови з вашою сторінкою. Коментарі під дописами, реклама й сама сторінка лишаються в Meta Business Suite. Meta дозволяє компанії відповісти протягом 24 годин після останнього повідомлення людини або до 7 днів, якщо відповідає людина й повідомлення має тег HUMAN_AGENT.

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

- [Instagram Direct](https://krokul.com/uk/integrations/instagram-direct/index.md)
- [WhatsApp Business](https://krokul.com/uk/integrations/whatsapp-business/index.md)
- [Telegram](https://krokul.com/uk/integrations/telegram/index.md)
- [Twilio](https://krokul.com/uk/integrations/twilio/index.md)
- [Meta Lead Ads](https://krokul.com/uk/integrations/meta-lead-ads/index.md)

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

Facebook і Messenger є торговими марками Meta Platforms, Inc. Krokul не афілійований з Meta.

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

---

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