Интеграции
Внешний сервис подключается к проекту в документе Интеграции, а потом используется в схемах: как триггер (что запускает сценарий) и как шаги (что сделать в сервисе).
Подключение
Заголовок раздела «Подключение»- Откройте документ Интеграции вверху дерева проекта и нажмите «+ Добавить интеграцию».
- Выберите сервис («Вендор»). Название заполнится само — его можно поменять, например «Бот поддержки».
- Заполните учётные данные: токен бота, ключ API, строку подключения. У каждого поля два значения — для тестового стенда (dev) и для прода (prod): так на стенде работает тестовый бот или тестовая база, а в проде — настоящие. Для сервисов с авторизацией через сайт (amoCRM, Google и другие) вместо полей — кнопка «Подключить».
- Сохраните. Теперь в меню валентной точки в группе Интеграции появятся шаги этого сервиса, а при создании триггера его можно выбрать в поле «Учётные данные».
В проекте может быть несколько интеграций одного сервиса — например, два разных бота. Секреты хранятся в зашифрованном виде, в экспорт проекта и в историю версий не попадают, а после сохранения не показываются.
Поля учётных данных можно оставить пустыми и заполнить позже — например, если интеграцию создал ИИ-агент. Проверьте, что prod-значения заполнены, прежде чем публиковать проект.
Мессенджеры
Заголовок раздела «Мессенджеры»Telegram
Заголовок раздела «Telegram»- Триггеры: «При сообщении» — на каждое новое сообщение боту; «При команде» — на одну команду (
/start,/help, …). Если в проекте есть оба, подходящая команда попадает только в свой триггер. - Отправить сообщение — ответ от имени бота.
- Задать вопрос — сообщение с кнопками; сценарий ждёт нажатия и продолжает по ветке выбранной кнопки. Можно задать таймаут: если никто не ответил, кнопки убираются и сценарий идёт по ветке «Таймаут».
- Ждать сообщение — сценарий ждёт, пока пользователь напишет следующее сообщение в чат. Две ветки:
message— ответ доступен какreply(reply.text,reply.from, файлы), иtimeout— если сообщения не было за указанное время (обязательно, по умолчанию10m). Удобно, чтобы спросить имя, телефон или адрес и сразу получить ответ. Ответ доходит до сценария, даже если тот запущен командой (например,/start); команда со своим триггером «При команде» уходит в него. - Отправить файл — фото, документ, видео, аудио или голосовое.
- Фото, документы, голосовые, аудио и видео во входящем сообщении автоматически становятся файлами:
message.photo,message.voiceи т. д. - Учётные данные — токен бота от @BotFather.
Те же триггеры и шаги, что у Telegram. Токен бота выдаёт платформа для партнёров MAX (business.max.ru). Нажатие
«Начать» в новом диалоге приходит в сценарий как /start (переход по ссылке с параметром start — как
/start <параметр>), поэтому триггер «При команде» start работает так же, как в Telegram. Входящие изображения,
файлы, аудио и видео становятся файлами. Отличия: message.messageId — строка, message.timestamp — время в
миллисекундах.
ВКонтакте
Заголовок раздела «ВКонтакте»Бот сообщества с теми же триггерами и шагами, кнопки вопроса — callback-кнопки. Ключ доступа создаётся в сообществе:
Управление → Работа с API → Ключи доступа, с правами «Сообщения сообщества», «Фотографии», «Документы» и
«Управление сообществом»; в настройках сообщений включите сообщения сообщества и возможности ботов. «Начать» приходит
как /start, переход по ссылке vk.me/<сообщество>?ref=… — как /start <ref>. message.chat.id — это peer_id
ВКонтакте, отвечайте в него. Входящие фото, документы и голосовые становятся файлами (видео — нет).
Группы и модерация
Заголовок раздела «Группы и модерация»Боты Telegram, MAX и ВКонтакте умеют работать не только в личных чатах, но и в группах, каналах и сообществах: встречать новичков, удалять спам, исключать и банить нарушителей.
Настройки триггеров «При сообщении» и «При команде». Поле «Чаты» — слушать любые чаты, только личные или только группы и каналы (так в одном проекте могут жить сценарий для личных чатов и отдельный сценарий для группы). Поле «Диалог» — «Один запуск на чат» (по умолчанию), «Один запуск на пользователя в чате» (отдельный диалог с каждым участником) или «Новый запуск на каждое сообщение» (без состояния — для антиспама и модерации). Как работают эти режимы и что происходит с сообщением, пришедшим во время идущего запуска, — на странице Диалоги и запуски бота.
Триггеры участников. Каждое событие запускает отдельное выполнение; данные лежат в переменной event (в заявке
Telegram и ВКонтакте — request).
| Мессенджер | Триггеры | Что в данных |
|---|---|---|
| Telegram | «Участник вошёл», «Участник вышел» (kicked отличает исключение), «Заявка на вступление» |
чат, пользователь, кто пригласил/исключил, ссылка-приглашение, время |
| MAX | «Участник вошёл», «Участник вышел» | чат, пользователь, byId — кто пригласил или исключил (нет при входе по ссылке и самостоятельном выходе) |
| ВКонтакте | «Участник сообщества вошёл/вышел», «Заявка на вступление» (только уведомление), «Участник беседы вошёл/вышел» | сообщество или беседа, пользователь, кто добавил, вход по ссылке |
Действия модерации.
- Telegram: «Забанить участника» (на срок или навсегда, можно удалить все его сообщения), «Разбанить участника», «Удалить сообщение», «Одобрить / Отклонить заявку», «Получить участника» (статус, администратор ли).
- MAX: «Исключить участника» (по умолчанию с блокировкой — это бан; блокировка работает только в чатах со ссылкой) и «Удалить сообщение».
- ВКонтакте: «Исключить из беседы» и «Удалить сообщение».
Повторное действие не считается ошибкой: уже удалённое сообщение или уже исключённый участник — это успех.
Права бота. Бота нужно сделать администратором группы или чата. Telegram: права на блокировку пользователей, удаление сообщений и приглашение пользователей; без админских прав бот видит в группе только команды и ответы ему. MAX: право читать все сообщения (иначе события участников не приходят), добавлять и удалять участников, удалять сообщения. ВКонтакте: ключ сообщества с доступом к сообщениям, а для исключения из беседы сообщество должно быть её администратором.
Ограничения.
- События участников не приходят через тест-бота платформы (Тест-бот) — чтобы их проверить, подключите собственного бота со своим токеном.
- Кнопки вопроса, нажатые в группе, возвращаются в сценарий только в режиме «Один запуск на чат»; для остальных режимов задавайте вопросы в личных чатах.
- ВКонтакте нельзя банить на уровне сообщества, а заявку на вступление нельзя одобрить или отклонить из сценария — только получить уведомление.
- OpenAI-совместимые модели: «Вызвать AI» — текстовый ответ модели, можно с вложенными файлами (например, фото от пользователя); AI Choice — модель выбирает один из заданных вами вариантов, и сценарий идёт по его ветке, у каждого варианта могут быть свои данные; «Вызвать AI (изображение)» генерирует картинку; «Вызвать AI (распознавание)» превращает аудио в текст. Учётные данные — ключ API и адрес API (подходит любой совместимый с OpenAI провайдер).
- GigaChat и YandexGPT — текстовый ответ модели. GigaChat: ключ авторизации из личного кабинета разработчика
Сбера и область доступа; YandexGPT: API-ключ сервисного аккаунта и идентификатор каталога, имя модели вводится
вручную (например,
yandexgpt/latest).
ИИ-шаги в сценариях оплачиваются вашим провайдером по вашему ключу, а не с баланса Шагомата. С баланса оплачивается только ИИ-агент, который строит схемы.
HTTP и вебхуки
Заголовок раздела «HTTP и вебхуки»HTTP-запрос
Заголовок раздела «HTTP-запрос»Обращение к любому HTTP API: метод, адрес, заголовки и тело задаются выражениями, ответ сохраняется в переменную. Если ответ — файл (PDF, картинка, архив), его можно сохранить как файл, и наоборот — отправить файл телом запроса. Отдельных учётных данных не нужно: авторизация пишется прямо в заголовки.
Поле «При ошибке сети» задаёт, что делать, если ответа нет совсем (сервер недоступен, таймаут): «Повторять до успеха» (по умолчанию) или «Вернуть статус 0» — одна попытка до 30 секунд, после чего сценарий сам решает, что делать, например отправить уведомление.
Входящий триггер: POST-запрос на адрес триггера запускает сценарий, тело запроса становится входными данными. У каждого триггера свой адрес, отдельно для тестового стенда и прода. Оба адреса показаны в Проект → Адреса (см. ниже) и в окне «Защита вебхука». Адрес тестового стенда работает, пока стенд запущен, адрес прода — пока включён прод. Триггер, добавленный при запущенном стенде, начинает принимать запросы после Тестовый стенд → Перезапустить.
Чтобы принимать запросы только от своих систем, откройте триггер и нажмите «Защита вебхука» на тулбаре: включите
«Требовать подписанные запросы» — появятся секреты для dev и prod. Запрос должен передавать секрет в заголовке
X-Webhook-Secret либо подпись в заголовке X-Webhook-Signature: sha256=<hex> (HMAC-SHA256 тела запроса с секретом
как ключом), иначе ответ — 401. Секрет не хранится в проекте и не попадает в экспорт; «Сгенерировать новый секрет»
заменяет его, старый перестаёт работать сразу.
Адреса триггеров
Заголовок раздела «Адреса триггеров»Вебхук, Битрикс24 и ЮKassa сами не знают, куда слать события, — адрес триггера нужно вставить в их настройки. Проект → Адреса открывает вкладку со всеми такими адресами проекта: для каждого триггера — адрес тестового стенда и адрес прода, с кнопкой копирования; клик по названию открывает триггер. Обычно в настройках внешнего сервиса сначала указывают адрес стенда, а перед запуском в работу меняют его на адрес прода.
Telegram, MAX, ВКонтакте и amoCRM подключают свои вебхуки сами, их адреса указывать не нужно. На той же вкладке перечислены тест-боты платформы.
Встроенные возможности
Заголовок раздела «Встроенные возможности»Не требуют учётных данных — доступны в любом проекте.
- Расписание — запуск по интервалу или cron-выражению.
- Файлы — создание, чтение, публикация и отправка файлов.
- Медиа — обработка изображений, видео и аудио.
- Задачи для людей — пауза сценария до решения человека.
И одна интеграция с подключением: Базы данных — Postgres и MySQL.
CRM, учёт и платежи
Заголовок раздела «CRM, учёт и платежи»- Шаги: создать, изменить, получить и найти сделку; создать сделку сразу с контактом и компанией; создать, изменить и найти контакт; создать компанию; создать и завершить задачу; добавить примечание; связать сущности. Смена этапа воронки — «Изменить сделку» с ID этапа.
- Вызвать метод API — доступ к остальным ~170 методам API v4 (воронки и этапы, поля, теги, списки, покупатели, неразобранное и др.) с подсказками параметров. Результат — ответ API как есть.
- Триггеры: события сделки (создание, изменение, смена этапа, смена ответственного, удаление, восстановление, примечание), контакта, компании, задачи, покупателя, беседы и сообщения в чате. Вебхук в amoCRM подписывается автоматически при запуске; для этого нужен тариф «Расширенный» или «Профессиональный». Если подписаться не удалось, в журнале запуска появятся адрес и список событий, чтобы добавить вебхук вручную (amoМаркет → Web hooks).
- Подключение — кнопка «Подключить» и вход в аккаунт amoCRM. Поддерживаются только аккаунты amocrm.ru.
- Ошибки запроса (4xx) завершают шаг без повторов, превышение лимита запросов (около 7 в секунду) повторяется автоматически.
Битрикс24
Заголовок раздела «Битрикс24»Триггер «Event (outgoing webhook)» запускает сценарий на любое событие портала (ONCRMLEADADD, ONCRMDEALUPDATE, …);
имя события лежит в event.event, так что один триггер может ветвиться по нему. Адрес триггера (из Проект →
Адреса) указывается в настройках исходящего вебхука портала, учётные данные — его application_token. Действий нет: REST API Битрикс24
вызывается HTTP-запросом на адрес входящего вебхука портала.
Триггер «Событие (платёж/возврат)» срабатывает на уведомления вроде payment.succeeded, payment.canceled,
refund.succeeded. Шагомат перечитывает платёж из API ЮKassa и передаёт в сценарий только подтверждённые данные.
Учётные данные — Shop ID и секретный ключ, адрес триггера (из Проект → Адреса) указывается в разделе «Уведомления»
личного кабинета ЮKassa.
Платёж создаётся HTTP-запросом (Basic-авторизация и заголовок Idempotence-Key).
«Получить записи» читает коллекцию (например, Catalog_Контрагенты) из базы 1С:Предприятия через стандартный интерфейс
OData, с необязательным фильтром $filter. Учётные данные: адрес OData (…/odata/standard.odata), пользователь и пароль
1С. Нужна платформа 8.3.5+ с опубликованным интерфейсом OData. Пока только чтение.
«Получить документы» возвращает список документов ящика организации (до 50, только метаданные). Подключается по OAuth2
через собственное приложение Контура: адрес перенаправления https://api.shagomat.ru/oauth2/callback/diadoc, Client ID
и секрет, затем «Подключить», плюс идентификатор ящика. Отправка и подписание документов не поддерживаются.
МойСклад, Ozon, Wildberries
Заголовок раздела «МойСклад, Ozon, Wildberries»У каждого одно действие «Call method» с выбором из всего API (около 1 200 методов у МойСклада, 470 у Ozon, 270 у Wildberries); параметры подсказываются. Учётные данные: токен МойСклада; Client-Id и Api-Key Ozon; API-токен Wildberries (действует 180 дней, перевыпускается в кабинете продавца). Лимиты частоты запросов обрабатываются автоматическими повторами.
Каталог дополнительных интеграций
Заголовок раздела «Каталог дополнительных интеграций»Для сервисов без встроенной интеграции есть каталог готовых действий на основе открытой библиотеки ActivePieces — больше 60 сервисов:
- мессенджеры — Slack, Discord, Mattermost, Microsoft Teams;
- Google — Sheets, Gmail, Drive, Calendar, Forms;
- почта и маркетинг — SMTP, IMAP, SendGrid, Resend, Mailchimp, ActiveCampaign, Klaviyo, Brevo;
- задачи и CRM — Notion, Trello, Jira, Todoist, Linear, ClickUp, HubSpot, Salesforce, Pipedrive, Zoho CRM, Close, monday.com, Asana, Wrike;
- поддержка — Zendesk, Freshdesk, Intercom;
- разработка — GitHub, GitLab;
- данные и хранилища — Airtable, Amazon S3, Dropbox, MongoDB, Box;
- формы и встречи — Typeform, JotForm, Calendly; связь — Zoom, Twilio;
- магазины и платежи — Shopify, WooCommerce, Stripe, Paddle, QuickBooks, Xero;
- документы, аналитика, контент — DocuSign, PandaDoc, Mixpanel, PostHog, WordPress, RSS, YouTube.
Сервисы с OAuth подключаются кнопкой «Подключить» — регистрировать своё приложение у сервиса не нужно. Если нужного сервиса нет в списке «Добавить интеграцию», напишите в поддержку.
Действия каталога добавляются в схему через пункт меню интеграций. У части действий (например, «произвольный вызов API») параметры задаются одним свободным выражением без подсказок конкретных полей.