# Telegram + Krokul CRM

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

**Статус:** Нативна. **Платформи автоматизації:** Zapier, Make, n8n, Albato.

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

### Клієнт пише боту компанії

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

### Клієнт говорить із менеджером особисто

З Telegram Business бот компанії підключається до особистого акаунта менеджера в Telegram. Клієнт бачить у чаті менеджера, а кожне бізнес-повідомлення потрапляє в розмову Krokul. Повідомлення, які менеджер пише з телефона, зберігаються як вихідні й нової угоди не відкривають.

### Фото й файли йдуть разом з угодою

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

### Правки й видалення видно в розмові

Коли клієнт редагує повідомлення, Krokul оновлює текст у розмові й позначає його як змінений. Повідомлення, видалене в чаті Telegram Business, позначається як видалене, тож команда не відповідає на те, чого вже немає.

### Співробітники отримують сповіщення Krokul у Telegram

Співробітник бере в Krokul код прив’язки й надсилає боту компанії `/link` з цим кодом. Відтоді цей чат отримує сповіщення Krokul для цього співробітника окремо від розмов із клієнтами.

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

| Telegram | Krokul | Напрям | Коли |
|---|---|---|---|
| Особисте повідомлення боту (оновлення `message`) | Контакт, угода й повідомлення в розмові | Telegram → Krokul | На кожному колі опитування або одразу в режимі вебхука |
| Бізнес-повідомлення (оновлення `business_message`) | Та сама розмова, вхідне чи вихідне за відправником | Telegram → Krokul | Коли клієнт чи менеджер пише в підключеному особистому акаунті |
| Змінене чи видалене повідомлення (`edited_message`, `edited_business_message`, `deleted_business_messages`) | Позначка «змінено» чи «видалено» в розмові | Telegram → Krokul | Коли повідомлення змінюється в Telegram |
| Фото, документ, голосове (`getFile`) | Файл в угоді | Telegram ↔ Krokul | Коли будь-яка сторона його надсилає |
| sendMessage (текст до 4096 символів) | Відповідь, набрана в розмові Krokul | Krokul → Telegram | Коли менеджер надсилає відповідь |
| Надісланий контакт (номер телефону) | Телефон контакту | Telegram → Krokul | Коли клієнт ділиться контактом |
| Команда `/link` з кодом | Канал сповіщень співробітника | Telegram → Krokul | Один раз, коли співробітник прив’язує чат |

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

### Підключення бота (нативно, без коду)

1. Створіть бота в @BotFather і скопіюйте його токен. Щоб працювали й особисті акаунти, увімкніть для бота Business Mode в @BotFather.
2. У Krokul відкрийте «Маркетплейс», виберіть Telegram і вставте токен бота. Krokul перевіряє токен і попереджає, якщо в бота вже є вебхук деінде.
3. Виберіть воронку й джерело для нових розмов. З порожньою воронкою Krokul створює контакти й розмови, але не угоди.
4. За бажанням менеджер підключає бота компанії до свого особистого акаунта в налаштуваннях Telegram. Відтоді чати цього акаунта теж приходять у Krokul.
5. Надішліть боту тестове повідомлення й відкрийте розмову в «Комунікаціях». Журнал показує кожне оновлення й кожну відповідь, а коли Telegram щось відхиляє, то й текст помилки.

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

1. Підключіть застосунок Krokul ключем API і візьміть для автоматизацій другого бота, бо одного бота не можуть читати два інструменти.
2. Поєднайте тригер Krokul, наприклад Deal Won чи Task Created, з дією Telegram Send Message, щоб публікувати в чат команди.

**Тригери:** New Message.

**Дії:** Send Message; Send Photo; Send Poll; React to Message.

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

Krokul читає Telegram через getUpdates і явно запитує оновлення повідомлень, правок, бізнес-повідомлень і видалень, бо типовий набір бізнес-оновлень не містить. Режим вебхука перевіряє секретний токен у заголовку `x-telegram-bot-api-secret-token`. Розмови й повідомлення входять у публічний REST API, тож власний інструмент може прочитати розмову чи надіслати відповідь тим самим каналом, а нові контакти й угоди запускають підписані вебхуки Krokul `contact.created` і `card.created`.

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

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

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

Так, нативно. Токен бота Telegram підключається в «Маркетплейсі», а особисті чати стають контактами, угодами й розмовами, на які ви відповідаєте з Krokul.

### Чи можуть клієнти спілкуватися з живою людиною, а не з ботом?

Так, через Telegram Business. Бот компанії підключається до особистого акаунта, клієнт бачить цю людину, а Krokul однаково веде розмову. До одного особистого акаунта можна підключити одного бота.

### Чи можна використовувати того самого бота в Zapier і в Krokul?

Ні. Бот Telegram має або один вебхук, або його читають опитуванням. Для автоматизацій, яким потрібен тригер Zapier New Message, візьміть окремого бота.

### Чи доходять файли від клієнтів до угоди?

Так. Фото, документи й голосові повідомлення зберігаються в угоді файлами, а менеджер може надіслати файл у відповідь із розмови.

## Обмеження

Krokul працює з особистими чатами. Групові чати й канали лишаються в Telegram. Бота Telegram читають або опитуванням, або через один вебхук, тож бот, підключений до Krokul, не може водночас обслуговувати другий інструмент.

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

- [WhatsApp Business](https://krokul.com/uk/integrations/whatsapp-business/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)
- [Gmail](https://krokul.com/uk/integrations/gmail/index.md)

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

Telegram є торговельною маркою Telegram Messenger Inc. Krokul не пов’язаний з Telegram.

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

---

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