# WhatsApp Business + Krokul CRM

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

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

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

### Перше повідомлення у WhatsApp відкриває угоду

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

### Менеджер відповідає всередині угоди

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

### Шаблони знову відкривають закриту розмову

Коли від останнього повідомлення клієнта минуло 24 години, Meta дозволяє лише затверджені шаблони повідомлень. Krokul показує затверджені шаблони вашого WhatsApp Business Account і пропонує їх у полі відповіді. Їхні поля, як-от імʼя клієнта, номер угоди й сума, приходять заповненими з угоди.

### Статус доставки лишається на повідомленні

Meta повідомляє про кожне надіслане повідомлення один зі статусів sent, delivered, read чи failed. Krokul показує цей статус поруч із ним у треді. Невдале повідомлення зберігає текст помилки. Менеджер знає причину й не думає, що клієнт його отримав.

### Зміна етапу сповіщає клієнта

Правило автоматизації в Krokul надсилає шаблон, коли угода доходить до етапу, наприклад «Замовлення відправлено». Повідомлення з’являється в треді, як і будь-яка відповідь менеджера, тож уся розмова лишається в одному місці.

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

| WhatsApp Business | Krokul | Напрям | Коли |
|---|---|---|---|
| Вхідне повідомлення (поле вебхука `messages`) | Контакт, угода й повідомлення в треді | WhatsApp → Krokul | Кожне повідомлення клієнта |
| Медіа в повідомленні (зображення, документ, аудіо) | Файл, прикріплений до угоди | WhatsApp ↔ Krokul | Коли будь-яка сторона надсилає файл |
| Відповідь у межах вікна обслуговування | Повідомлення, набране в треді Krokul | Krokul → WhatsApp | Коли менеджер його надсилає |
| Затверджений шаблон повідомлення | Відповідь шаблоном або правило автоматизації | Krokul → WhatsApp | Поза 24-годинним вікном або на зміну етапу |
| Статус повідомлення (sent, delivered, read, failed) | Статус повідомлення в треді | WhatsApp → Krokul | Коли Meta про нього повідомляє |
| Статус шаблону (`message_template_status_update`) | Перелік шаблонів, доступних у Krokul | WhatsApp → Krokul | Коли Meta затверджує чи відхиляє шаблон |

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

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

1. Підключіть застосунок Krokul ключем API.
2. Почніть із тригера WhatsApp Business New Message Received і візьміть дії Krokul, наприклад Create Contact, Create Deal чи Add Activity.
3. У зворотний бік візьміть тригер Krokul, наприклад Deal Won, і запустіть Send Template Message.

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

1. Дайте своєму приймачу ключ API Krokul зі scope для контактів, угод і активностей.
2. Підпишіть вебхук Cloud API на поле `messages` і перевіряйте X-Hub-Signature-256. Потім зіставте телефон відправника через contact/api-find або додайте людину через contact/api-create і відкрийте угоду через card/api-create.
3. Записуйте кожне вхідне повідомлення в стрічку угоди через activity/api-create, а WhatsApp ID тримайте на контакті через externalRef/api-upsert.
4. Для вихідних шаблонів підпишіть вебхук Krokul на card.statusChanged, перевірте `x-crm-signature` і викличте ендпоінт messages у Cloud API.

**Тригери:** New Message Received; Message Status Updated.

**Дії:** Send Freeform Message; Send Template Message; Send Media Message.

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

Для власних потоків Krokul дає публічний REST API, підписані вебхуки з журналом доставок і зовнішні ключі, що привʼязують контакт до його WhatsApp ID. Активності приймають ті самі типи, що й застосунок, серед них `message`, тож власний приймач може записувати чати в стрічку угоди. Тестова компанія з демоданими й ключем API допомагає перевірити потік до того, як він дійде до справжніх клієнтів.

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

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

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

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

### Що вимагає Meta, щоб номер запрацював?

Бізнес-портфоліо Meta, WhatsApp Business Account і номер телефону, зареєстрований для Cloud API. Шаблон можна надіслати лише зі статусом APPROVED, і кожен шаблон належить до категорії marketing, utility чи authentication.

### Скільком клієнтам можна написати першими?

Meta обмежує, на скільки різних номерів бізнес-портфоліо може писати поза вікном обслуговування за 24 години. Нові портфоліо починають із 250. Верифікація бізнесу є одним зі шляхів до 2000, а вищі рівні залежать від якості повідомлень.

### Чи створює кожне повідомлення нову угоду?

Ні. Krokul тримає один тред на клієнта й додає нові повідомлення до відкритої угоди цього контакта. Нова угода починається лише тоді, коли попередню закрито.

## Обмеження

Krokul працює з номерами на WhatsApp Business Platform (Cloud API). Застосунок WhatsApp Business на одному телефоні лишається поза інтеграцією. Правила шаблонів, 24-годинне вікно обслуговування клієнта й ліміти повідомлень задає Meta, і Krokul їх дотримується.

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

- [Telegram](https://krokul.com/uk/integrations/telegram/index.md)
- [Facebook Messenger](https://krokul.com/uk/integrations/facebook-messenger/index.md)
- [Instagram Direct](https://krokul.com/uk/integrations/instagram-direct/index.md)
- [Twilio](https://krokul.com/uk/integrations/twilio/index.md)
- [Calendly](https://krokul.com/uk/integrations/calendly/index.md)

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

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

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

---

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