Канали

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

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

Ключові концепції:

Конфігурація для кожного агента, Кожне підключення каналу налаштовується на рівні агента. Один агент може бути підключений до Slack, тоді як інший обробляє Discord, або один агент може одночасно бути підключений до кількох каналів.
Двонаправленість, Канали підтримують як надсилання, так і отримання повідомлень. Агенти можуть відповідати на вхідні повідомлення, ініціювати вихідні або робити обидва.
Декілька акаунтів, Ви можете підключити кілька акаунтів для одного типу каналу (наприклад, два різних воркспейси Slack або кілька адрес електронної пошти).

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

Канал	Метод автентифікації	Функції
Slack	OAuth	Повноцінний обмін повідомленнями, канали, потоки, реакції, завантаження файлів
Discord	Токен бота	Серверний обмін повідомленнями, канали, особисті повідомлення, вбудування, реакції
WhatsApp	QR-код	Текстові повідомлення, медіаповідомлення, групові чати
Telegram	Токен бота	Текстові повідомлення, групи, канали, inline-клавіатури, обмін файлами
Signal	Локальний додаток	Наскрізно зашифрований обмін повідомленнями, групові чати
Microsoft Teams	OAuth	Команди, канали, чати, адаптивні картки, обмін файлами
Google Chat	OAuth	Простори, особисті повідомлення, картки, тематичні розмови
SMS	API-ключ	Вихідний та вхідний обмін текстовими повідомленнями через підтримуваних провайдерів
Електронна пошта / Gmail	OAuth	Надсилання, отримання, чернетки, відповіді, вкладення, управління мітками
Matrix	Токен	Федеративний обмін повідомленнями, кімнати, наскрізне шифрування
Line	Токен	Текстові повідомлення, стікери, групові чати, розширені меню
Zalo	Токен	Текстові повідомлення, обмін медіафайлами
IRC	Конфігурація	Серверні підключення, канали, особисті повідомлення
iMessage	Локальний	Нативний обмін повідомленнями macOS (потрібен хост на macOS)

Підключення каналу

Процес підключення залежить від методу автентифікації каналу.

Потік OAuth

Використовується: Slack, Microsoft Teams, Google Chat, Електронна пошта / Gmail

Відкрийте вкладку Канали агента.
Натисніть Підключити поруч із каналом, який хочете додати.
Вас буде перенаправлено на сторінку авторизації сервісу.
Увійдіть у свій акаунт та надайте Neotask запитані дозволи.
Після авторизації вас буде перенаправлено назад на панель, і канал з'явиться як підключений.

Для мобільних платформ доступна опція QR-коду. Відскануйте QR-код з телефону, щоб завершити авторизацію без необхідності входити з браузера на комп'ютері.

Токен бота

Використовується: Discord, Telegram

Створіть бота на відповідній платформі:
- Discord, Створіть застосунок на Порталі розробників Discord та згенеруйте токен бота.
- Telegram, Напишіть @BotFather у Telegram, щоб створити бота та отримати токен.
Відкрийте вкладку Канали агента та натисніть Підключити поруч із каналом.
Вставте токен бота у поле токена.
Натисніть Зберегти для встановлення підключення.

QR-код

Використовується: WhatsApp

Відкрийте вкладку Канали агента та натисніть Підключити поруч із WhatsApp.
На екрані з'явиться QR-код.
Відкрийте WhatsApp на телефоні, перейдіть до Пов'язані пристрої та відскануйте QR-код.
Підключення встановлюється після підтвердження посилання з телефону.

API-ключ

Використовується: SMS

Отримайте API-ключ від вашого SMS-провайдера (наприклад, Twilio, Vonage).
Відкрийте вкладку Канали агента та натисніть Підключити поруч із SMS.
Введіть API-ключ та будь-які додаткові обов'язкові поля (наприклад, номер телефону, SID акаунту).
Натисніть Зберегти для активації каналу.

Токен

Використовується: Matrix, Line, Zalo

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

Конфігурація сервера

Використовується: IRC

Відкрийте вкладку Канали агента та натисніть Підключити поруч із IRC.
Введіть адресу сервера, порт, нікнейм та (за потреби) пароль.
Вкажіть канали для приєднання при підключенні.
Натисніть Зберегти для підключення.

Локальний застосунок

Використовується: Signal, iMessage

Переконайтеся, що необхідний застосунок встановлено та запущено на хост-машині:
- Signal, Потрібно встановити Signal Desktop та прив'язати його до вашого акаунту Signal.
- iMessage, Потрібен хост на macOS з налаштованим Messages.app.
Відкрийте вкладку Канали агента та натисніть Підключити поруч із каналом.
Neotask виявить локальний застосунок та встановить підключення.
Якщо застосунок не виявлено, вам буде запропоновано встановити або налаштувати його.

Перевірка підключення

Після підключення будь-якого каналу Neotask автоматично запускає перевірку затримки для верифікації підключення:

Тестове повідомлення надсилається та отримується через API каналу.
Вимірюється затримка в обидва боки та відображається.
Якщо тест не вдається, повідомлення про помилку описує проблему (наприклад, недійсний токен, прострочений OAuth-грант, недоступний сервер).

Ви можете повторно запустити тест підключення в будь-який час з налаштувань каналу.

Операції з каналами

Після підключення каналу ви можете керувати ним на вкладці Канали агента.

Увімкнення / Вимкнення

Перемикайте канал без відключення. При вимкненні:

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

Перевірка підключення

Запустіть перевірку підключення за запитом, щоб переконатися, що канал доступний та відповідає. Тест:

Надсилає легкий API-запит до сервісу каналу.
Вимірює затримку в обидва боки в мілісекундах.
Повідомляє результат як Підключено (із затримкою) або Помилка (з деталями помилки).

Перегляд затримки

Кожен підключений канал відображає своє останнє значення затримки на вкладці Канали. Це допомагає відразу ідентифікувати повільні або деградовані підключення. Затримка оновлюється:

Автоматично після кожного тесту підключення.
Periodично у фоні, поки канал активний.

Відключення / Вихід

Щоб повністю видалити підключення каналу:

Натисніть Відключити поруч із каналом.
Підтвердіть дію в діалоговому вікні.
Neotask відкликає або відхиляє збережені облікові дані (OAuth-токени відкликаються на стороні провайдера, де це підтримується).
Канал видаляється зі списку активних каналів агента.

Щоб повторно підключитися після відключення, повторіть кроки початкового підключення.