# Канали

## Що таке канали?

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

Neotask підтримує **20+ платформ обміну повідомленнями** з коробки.

## Підтримувані канали

### Основні канали (вбудовані)

| Канал | Опис |
|---------|-------------|
| **WhatsApp** | Особисті та бізнес-акаунти через протокол WhatsApp Web. Групи, реакції, медіа, теми, редагування/видалення, пересилання. |
| **Telegram** | Інтеграція через Bot API. Групи, канали, теми, реакції, закріплення. Опційне вживання вебхуків. |
| **Discord** | Повна інтеграція з сервером. Канали, ролі, теми, відстеження голосових каналів, прив'язка агента до конкретного сервера. |
| **Slack** | Застосунок для робочого простору через OAuth. Канали, теми, реакції, обмін файлами. |
| **Signal** | Зашифровані особисті повідомлення та групи через протокол Signal. Зв'язування телефону через QR-код. |
| **Google Chat** | Простори, теми, реакції, відповіді у вигляді карток через вебхук. |
| **iMessage** | Повна підтримка SMS/iMessage через BlueBubbles на macOS. Редагування, видалення, ефекти. |
| **IRC** | Класичний IRC з каналами, особистими повідомленнями, SASL-аутентифікацією, підтримкою кількох серверів. |

### Канали плагінів

| Канал | Опис |
|---------|-------------|
| **Microsoft Teams** | Інтеграція з робочим простором через плагін. |
| **Matrix** | Децентралізований протокол обміну повідомленнями. |
| **Nostr** | Особисті повідомлення децентралізованого соціального протоколу. |
| **Zalo** | В'єтнамська платформа обміну повідомленнями (Bot API та особистий акаунт). |
| **Feishu/Lark** | Корпоративна платформа обміну повідомленнями. |
| **LINE** | Інтеграція через LINE Messaging API. |
| **Nextcloud Talk** | Самостійно розгорнутий обмін повідомленнями через Nextcloud. |
| **Mattermost** | Командний обмін повідомленнями з відкритим кодом. |
| **Tlon** | Обмін повідомленнями на основі Urbit. |
| **Twitch** | Чат прямих трансляцій через IRC. |

## Функції каналів

### Підтримка кількох акаунтів
Запускайте кілька акаунтів на одному каналі. Наприклад, керуйте кількома номерами WhatsApp або Telegram-ботами з одного Gateway.

### Підтримка медіа
Надсилайте та отримуйте зображення, відео, аудіо, документи, стікери та інші типи медіа. Обробка медіа залежить від платформи, але більшість каналів підтримують багаті медіа в обох напрямках.

### Управління групами та каналами
Агенти можуть брати участь у групових розмовах, відповідати на згадки, керувати темами та взаємодіяти з функціями, специфічними для каналу (реакції, опитування, закріплення).

### Теми повідомлень
На платформах, що підтримують це (Slack, Discord, Telegram), агенти можуть створювати теми, відповідати в темах та підтримувати контекст, специфічний для теми.

### Редагування повідомлень та реакції
Агенти можуть редагувати власні повідомлення, відкликати повідомлення та додавати реакції на платформах, що підтримують ці функції.

### Групи мовлення
Надсилайте оголошення до кількох каналів одночасно. Налаштуйте групи мовлення для синхронізації кількох платформ.

## Маршрутизація каналів

### Поведінка за замовчуванням
За замовчуванням основний агент отримує всі вхідні повідомлення з усіх каналів.

### Маршрутизація з кількома агентами
При наявності кількох агентів повідомлення маршрутизуються на основі прив'язок:

- **За каналом**, Всі повідомлення WhatsApp → особистий агент
- **За сервером**, Discord-сервер А → агент підтримки, сервер Б → агент розробки
- **За робочим простором**, Slack-простір → командний агент
- **За типом чату**, Особисті повідомлення → помічник, групові повідомлення → командний бот

### Контроль доступу до особистих повідомлень
Налаштуйте, які контакти можуть надсилати повідомлення вашому агенту безпосередньо. Параметри включають дозвіл всіх особистих повідомлень, лише відомих контактів або конкретного дозволеного списку.

### Обмеження згадок у групах
У групових чатах налаштуйте, чи відповідають агенти на всі повідомлення або лише при згадці.

## Підключення та аутентифікація

Кожен канал має власний метод аутентифікації:

| Канал | Метод аутентифікації |
|---------|-------------|
| WhatsApp | Сканування QR-коду |
| Telegram | Токен бота |
| Discord | Токен бота |
| Slack | OAuth (застосунок робочого простору) |
| Signal | Прив'язування телефону через QR-код |
| Google Chat | URL вебхука |
| iMessage | API-ключ BlueBubbles |
| IRC | Нікнейм + опційний пароль |