# Viber + Krokul CRM

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

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

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

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

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

### Відповідь менеджера в той самий чат

Менеджер пише в треді угоди. Krokul викликає send_message з ідентифікатором клієнта, і відповідь приходить у чат Viber від імені бота. Разом із текстом можна надіслати файл, наприклад рахунок із картки угоди.

### Привітання при відкритті чату

Подія conversation_started приходить, коли людина вперше відкриває чат з ботом. У відповідь Krokul надсилає одне вітальне повідомлення, яке задає адміністратор. Контакт з’являється пізніше, з першим повідомленням людини.

### Видно, що клієнт прочитав

Події delivered і seen показують, що повідомлення дійшло й відкрите. Krokul ставить ці позначки біля повідомлення в треді. Подія failed позначає відповідь, яку Viber не доставив, і менеджер обирає інший канал.

### Відписка зупиняє листування

Коли клієнт відписується від бота, Viber надсилає unsubscribed. Krokul позначає канал Viber у контакті як закритий, і поле відповіді в треді показує, що писати цьому клієнту бот більше не може.

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

| Viber | Krokul | Напрям | Коли |
|---|---|---|---|
| Подія message (текст, файл, контакт, локація) | Контакт, угода й повідомлення в треді «Комунікацій» | Viber → Krokul | Клієнт пише боту |
| send_message | Відповідь менеджера в треді | Krokul → Viber | Менеджер надсилає повідомлення |
| Подія conversation_started | Вітальне повідомлення | Viber ↔ Krokul | Людина відкриває чат з ботом |
| Події delivered, seen, failed | Позначки доставки й прочитання біля повідомлення | Viber → Krokul | Після кожної відповіді |
| Події subscribed і unsubscribed | Стан каналу Viber у контакті | Viber → Krokul | Підписка чи відписка |
| Ідентифікатор користувача Viber | Ідентичність контакту в каналі | Viber → Krokul | Перше повідомлення |

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

### Застосунок Krokul в Albato

1. Підключіть бота Viber в Albato його токеном і застосунок Krokul ключем API Krokul.
2. Тригер Viber Message from the user received з’єднайте з діями Krokul «Знайти контакт», «Створити угоду» і «Додати активність».
3. Тригер Krokul «Етап угоди змінено» з’єднайте з дією Viber Send message, щоб клієнт отримав повідомлення про статус.

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

1. Скопіюйте токен бота з панелі Viber і випустіть у Krokul ключ API зі scope на контакти, угоди й активності.
2. Зареєструйте свій обробник викликом set_webhook із заголовком X-Viber-Auth-Token.
3. На подію message перевірте X-Viber-Content-Signature, знайдіть чи створіть контакт через `contact/api-create`, відкрийте угоду через `card/api-create` і запишіть текст через `activity/api-create`. Ідентифікатор Viber збережіть через `externalRef/api-set`.
4. Підпишіть вебхук Krokul на `card.statusChanged` і надсилайте клієнту повідомлення через send_message.

**Тригери:** Message from the user received; User subscribed; User has unsubscribed.

**Дії:** Get User Details; Send message; Custom API request.

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

Viber підписує кожну подію заголовком X-Viber-Content-Signature, тобто HMAC-SHA256 від тіла токеном бота, а кожен запит до API несе X-Viber-Auth-Token. Клієнт у Viber має власний ідентифікатор без номера телефону, тому Krokul тримає його зовнішнім ключем контакту через `externalRef`. Повторна доставка тієї самої події за message_token другого повідомлення не створює.

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

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

### Чи можна вести листування Viber у Krokul?

Так. Повідомлення клієнтів боту Viber потрапляють у тред угоди в «Комунікаціях», а відповіді менеджерів ідуть назад у Viber від імені бота.

### Чи може бот Viber першим написати клієнту за номером телефону?

Ні. Бот пише лише тим, хто підписався на нього або вже написав. Розсилки за номером телефону робить сервіс бізнес-повідомлень, наприклад TurboSMS.

### Як Krokul впізнає клієнта, який написав у Viber удруге?

За ідентифікатором користувача Viber, збереженим у контакті. Нове повідомлення лягає в ту саму відкриту угоду.

### Що потрібно для підключення Viber до Krokul?

Чат-бот Viber вашої компанії і його токен. Бот оформлюється у Viber на комерційних умовах, а Krokul працює з ним через REST Bot API.

## Обмеження

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

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

- [Telegram](https://krokul.com/uk/integrations/telegram/index.md)
- [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)
- [TurboSMS](https://krokul.com/uk/integrations/turbosms/index.md)

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

Viber є торговою маркою Viber Media S.à r.l. Krokul не афілійований із Viber.

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

---

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