Каналы

Что такое каналы?

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

Ключевые концепции:

• Конфигурация на уровне агента -- Каждое подключение канала настраивается на уровне агента. Один агент может быть подключён к Slack, а другой, к Discord, или один агент может быть подключён к нескольким каналам одновременно.
• Двунаправленность -- Каналы поддерживают как отправку, так и получение сообщений. Агенты могут отвечать на входящие сообщения, инициировать исходящие сообщения или и то, и другое.
• Несколько аккаунтов -- Вы можете подключить несколько аккаунтов одного типа канала (например, два разных рабочих пространства Slack или несколько адресов электронной почты).

Поддерживаемые каналы

Подключение канала

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

OAuth Flow

Используется: Slack, Microsoft Teams, Google Chat, Email / Gmail

1. Откройте вкладку Каналы агента.
2. Нажмите Подключить рядом с каналом, который хотите добавить.
3. Вас перенаправят на страницу авторизации сервиса.
4. Войдите в свой аккаунт и предоставьте Neotask запрошенные разрешения.
5. После авторизации вас перенаправят обратно на панель управления, и канал появится как подключённый.

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

Токен бота

Используется: Discord, Telegram

1. Создайте бота на соответствующей платформе:
   • Discord -- Создайте приложение на Портале разработчиков Discord и сгенерируйте токен бота.
   • Telegram -- Напишите @BotFather в Telegram для создания бота и получения токена.
2. Откройте вкладку Каналы агента и нажмите Подключить рядом с каналом.
3. Вставьте токен бота в поле токена.
4. Нажмите Сохранить для установки соединения.

QR-код

Используется: WhatsApp

1. Откройте вкладку Каналы агента и нажмите Подключить рядом с WhatsApp.
2. На экране появится QR-код.
3. Откройте WhatsApp на телефоне, перейдите в Связанные устройства и отсканируйте QR-код.
4. Соединение устанавливается после того, как телефон подтверждает связь.

API-ключ

Используется: SMS

1. Получите API-ключ от вашего SMS-провайдера (например, Twilio, Vonage).
2. Откройте вкладку Каналы агента и нажмите Подключить рядом с SMS.
3. Введите API-ключ и любые дополнительные обязательные поля (например, номер телефона, SID аккаунта).
4. Нажмите Сохранить для активации канала.

Токен

Используется: Matrix, Line, Zalo

1. Сгенерируйте токен доступа в настройках разработчика или административной панели соответствующей платформы.
2. Откройте вкладку Каналы агента и нажмите Подключить рядом с каналом.
3. Вставьте токен в поле токена.
4. Нажмите Сохранить для установки соединения.

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

Используется: IRC

1. Откройте вкладку Каналы агента и нажмите Подключить рядом с IRC.
2. Введите адрес сервера, порт, никнейм и (опционально) пароль.
3. Укажите каналы для подключения при входе.
4. Нажмите Сохранить для подключения.

Локальное приложение

Используется: Signal, iMessage

1. Убедитесь, что необходимое приложение установлено и запущено на хост-машине:
   • Signal -- Signal Desktop должен быть установлен и связан с вашим аккаунтом Signal.
   • iMessage -- Требует хост macOS с настроенным Messages.app.
2. Откройте вкладку Каналы агента и нажмите Подключить рядом с каналом.
3. Neotask обнаружит локальное приложение и установит соединение.
4. Если приложение не обнаружено, вам будет предложено его установить или настроить.

Тестирование соединения

После подключения любого канала Neotask автоматически запускает зонд задержки для проверки соединения:

• Через API канала отправляется и получается тестовое сообщение.
• Измеряется задержка туда-обратно и отображается результат.
• В случае сбоя теста сообщение об ошибке описывает проблему (например, недействительный токен, истёкший OAuth-грант, недоступный сервер).

Вы можете повторно запустить тест соединения в любое время из настроек канала.

Операции с каналами

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

Включить / Отключить

Переключайте канал вкл./выкл. без отключения. При отключении:

• Агент перестаёт прослушивать сообщения на этом канале.
• Исходящие сообщения через него не отправляются.
• Учётные данные соединения сохраняются, поэтому вы можете повторно включить канал в любое время без переконфигурации.

Проверить подключение

Запустите проверку подключения по требованию, чтобы убедиться, что канал доступен и отвечает. Тест:

• Отправляет лёгкий API-запрос к сервису канала.
• Измеряет задержку туда-обратно в миллисекундах.
• Сообщает результат как Подключено (с задержкой) или Сбой (с деталями ошибки).

Просмотр задержки

Каждый подключённый канал отображает последние показания задержки на вкладке Каналы. Это помогает с первого взгляда определить медленные или деградировавшие соединения. Задержка обновляется:

• Автоматически после каждого теста соединения.
• Периодически в фоне, пока канал активен.

Отключение / Выход

Чтобы полностью удалить подключение канала:

1. Нажмите Отключить рядом с каналом.
2. Подтвердите действие в диалоговом окне.
3. Neotask отзывает или удаляет сохранённые учётные данные (OAuth-токены отзываются на стороне провайдера там, где это поддерживается).
4. Канал удаляется из списка активных каналов агента.

Чтобы снова подключиться после отключения, выполните исходные шаги подключения.