Мессенджеры¶
Schemix поддерживает мессенджеры как точку входа в процесс. Клиент пишет сообщение — процесс запускается автоматически.
Поддерживаемые каналы¶
| Канал | Подключение | Режимы |
|---|---|---|
| Telegram | Напрямую через Bot API | Polling / Webhook |
| Через Wazzup | Webhook | |
| Через Wazzup | Webhook | |
| Viber | Через Wazzup | Webhook |
| MAX (VK Teams) | Напрямую через MAX API | Polling / Webhook |
| Web-чат | Через API Schemix | REST API + Webhook |
Telegram¶
Настройка¶
- Создайте бота через @BotFather в Telegram.
- Скопируйте токен бота.
- В Schemix: Администрирование → Каналы → Добавить → Telegram.
- Вставьте токен, выберите режим (Polling для разработки, Webhook для production).
- Нажмите «Проверить» — бот ответит в Telegram.
Режимы работы¶
Polling — бот опрашивает серверы Telegram. Подходит для разработки, не требует HTTPS.
Webhook — Telegram отправляет обновления на ваш сервер. Требует HTTPS и публичный URL. Обязательно задайте TELEGRAM_WEBHOOK_SECRET в .env.
Wazzup (WhatsApp, Instagram, Viber)¶
Настройка¶
- Зарегистрируйтесь на wazzup24.com.
- Подключите мессенджеры (WhatsApp, Instagram и др.).
- Скопируйте API Key из личного кабинета Wazzup.
- В Schemix: Администрирование → Каналы → Добавить → Wazzup.
- Вставьте API Key.
- Нажмите «Проверить и загрузить каналы» — появится список подключённых мессенджеров.
- Нажмите «Настроить Webhook» — Schemix зарегистрирует URL для приёма сообщений.
Транспорты¶
Один аккаунт Wazzup может содержать несколько мессенджеров (транспортов). Каждый транспорт — отдельный канал связи: WhatsApp бизнес-номер, Instagram аккаунт и т.д.
Список транспортов синхронизируется автоматически при нажатии «Проверить и загрузить каналы».
MAX (VK Teams)¶
Настройка¶
- Создайте бота в MAX Platform.
- Скопируйте токен.
- В Schemix: Администрирование → Каналы → Добавить → MAX.
- Вставьте токен, выберите режим.
Использование в процессе¶
Start Event¶
Выберите тип триггера (Telegram / Wazzup / MAX) и конкретного бота. При входящем сообщении — процесс запускается.
Service Task → Мессенджер¶
Для отправки ответа клиенту в текущем диалоге: Service Task → тип «Мессенджер (текущий диалог)» → шаблон сообщения с переменными.
Web-чат¶
Web-чат позволяет подключить чат на вашем сайте или во внешней системе к процессам Schemix. В отличие от мессенджеров, Web-чат работает через REST API: ваша система отправляет сообщения в Schemix, а ответы получает на webhook.
Подробная инструкция по настройке: Интеграции — Web-чат и внешние системы.