# Каналы

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

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

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 сервер A → агент поддержки, сервер B → агент разработки
- **По рабочему пространству**, рабочее пространство Slack → командный агент
- **По типу чата**, личные сообщения → ассистент, групповые сообщения → командный бот

### Контроль доступа к личным сообщениям
Настраивайте, какие контакты могут напрямую писать вашему агенту. Варианты включают: разрешить все личные сообщения, только от известных контактов или только из определённого белого списка.

### Фильтрация упоминаний в группах
В групповых чатах настраивайте, отвечают ли агенты на все сообщения или только при упоминании.

## Сопряжение и аутентификация

Каждый канал имеет собственный метод аутентификации:

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