​

Каналы и интеграции

​

Общая модель

​

Общие настройки channels

{
  "channels": {
    "sendProgress": true,
    "sendToolHints": false
  }
}

​

allowFrom

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "123456:...",
      "allowFrom": ["123456789"]
    }
  }
}

• [] — запретить всем;
• ["*"] — разрешить всем;
• список id — разрешить только указанным отправителям.

​

Telegram

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "BOT_TOKEN",
      "allowFrom": ["USER_ID"]
    }
  }
}

veles gateway

​

ВКонтакте

1. Разрешите пользователям отправлять сообщения сообществу.
2. В разделе работы с API включите долгий опрос.
3. В типах событий включите новые входящие сообщения (message_new).
4. Создайте ключ доступа сообщества с правом работы с сообщениями.
5. Запишите числовой идентификатор сообщества без знака минус.

{
  "channels": {
    "vk": {
      "enabled": true,
      "token": {
        "source": "local",
        "provider": "veles",
        "id": "channels.vk.token"
      },
      "groupId": 123456789,
      "allowFrom": ["12345678"],
      "replyToMessage": false,
      "longPollTimeout": 25,
      "maxRetries": 3,
      "retryBaseDelay": 1.0
    }
  }
}

• при коде failed=1 принимает новый указатель событий ts;
• при failed=2 получает новые сервер и ключ, сохраняя текущий ts;
• при failed=3 заново получает сервер, ключ и ts;
• при сетевых ошибках повторяет запросы с увеличивающейся задержкой и после maxRetries полностью пересоздаёт состояние долгого опроса.

​

Другие встроенные каналы

​

Push-уведомления (Firebase Cloud Messaging)

"push": {
  "enabled": true,
  "apiKey": { "source": "local", "provider": "veles", "id": "channels.push.apiKey" },
  "authDomain": "<project>.firebaseapp.com",
  "projectId": "<project-id>",
  "storageBucket": "<project>.firebasestorage.app",
  "messagingSenderId": "<sender-id>",
  "appId": "<app-id вашего web-приложения>",
  "measurementId": "",
  "vapidKey": "<публичный ключ Web Push certificate>",
  "serviceAccount": { "source": "local", "provider": "veles", "id": "channels.push.serviceAccount" },
  "defaultTitle": "Veles",
  "notifyOnReplies": true,
  "presenceTtlSeconds": 100
}

• channels.push.apiKey — web API key Firebase. Он в любом случае отдается браузеру (это публичное значение по модели Firebase), но по политике деплоя хранится в секретах.
• channels.push.serviceAccount — полный JSON сервисного аккаунта Firebase. Это настоящий серверный секрет: им подписываются отправки через FCM HTTP v1.

1. Создайте проект в Firebase console и включите Cloud Messaging.
2. Добавьте web-приложение для каждого домена/инстанса — каждое получает свой appId (остальные значения проекта общие).
3. В Cloud Messaging → Web configuration сгенерируйте пару ключей Web Push (VAPID) — публичный ключ идет в vapidKey.
4. В Project settings → Service accounts скачайте JSON сервисного аккаунта и сохраните его строкой в секрет channels.push.serviceAccount.

​

WhatsApp и мост

veles channels login

veles channels status
veles plugins list

​

Каналы-расширения

​

Сессии по каналам

<channel>:<chat_id>

web:default
telegram:123456789
cli:direct

​

Каналы и безопасность

• allowFrom не пустой случайно и не ["*"] без причины;
• tools.restrictToWorkspace включён;
• exec выключен или ограничен;
• секреты не лежат в рабочей области открытым текстом;
• токен интерфейса и сервера Велеса не опубликован;
• прогресс и подсказки об инструментах не раскрывают лишнего.