Интеграции

Внешние сервисы подключаются к сценарию двумя способами: как отдельные узлы триггеров и действий прямо на схеме (встроенные интеграции) или через каталог готовых интеграций ActivePieces.

Встроенные интеграции

• Telegram Bot API. Триггер «Сообщение в Telegram» запускает сценарий на каждое новое сообщение боту, действие «Отправить сообщение» отвечает от его имени. Учётные данные (токен бота) хранятся раздельно для dev- и prod-окружений и шифруются перед сохранением. При локальном запуске движок опрашивает Telegram по long polling; если задан публичный адрес, автоматически переключается на вебхуки.

• OpenAI-совместимые модели. Действие «Вызвать AI» отправляет запрос на completion выбранной модели и возвращает текст; отдельный узел выбора «AI Choice» просит модель вернуть один из заранее заданных вариантов со структурированными данными — удобно для ветвления сценария по ответу модели. Базовый адрес API настраивается, поэтому подходит не только api.openai.com, но и Azure OpenAI, локальные серверы вроде llama.cpp и любые другие совместимые провайдеры.

• HTTP-запрос. Универсальное исходящее обращение к любому HTTP API: метод, URL, заголовки и тело задаются выражениями, результат сохраняется в переменную. Отдельных учётных данных не требует — авторизация дописывается прямо в заголовки запроса.

• Вебхук. Универсальный входящий триггер: каждой триггер-функции присваивается собственный URL, вызов которого (POST-запрос) запускает сценарий, передавая тело запроса как входные данные.

ActivePieces — каталог готовых интеграций

Для сервисов, под которые пока нет отдельной встроенной интеграции, используется адаптер поверх открытой библиотеки ActivePieces. Он работает как отдельный сервис, изолированный от остального движка, — сторонний код интеграций выполняется в своём процессе и не получает доступа к ядру системы — и предоставляет курируемый список готовых действий. На сегодняшний день подключено 62 сервиса:

• Мессенджеры — Slack, Discord, Mattermost, Microsoft Teams;
• Google Workspace — Google Sheets, Gmail, Google Drive, Google Calendar, Google Forms;
• Почта и маркетинг — SMTP, IMAP, SendGrid, Resend, Mailchimp, ActiveCampaign, Klaviyo, Sendinblue (Brevo);

• Управление проектами/задачами и CRM — Notion, Trello, Jira Cloud, Todoist, Linear, ClickUp, HubSpot, Salesforce, Pipedrive, Zoho CRM, Close, monday.com, Asana, Wrike;

• Поддержка и хелпдеск — Zendesk, Freshdesk, Intercom;
• Инструменты разработчика — GitHub, GitLab;
• Данные и хранилища — Airtable, Postgres, MySQL, Amazon S3, Dropbox, MongoDB, Box;
• Формы и планирование встреч — Typeform, JotForm, Calendly;
• Связь и видео — Zoom, Twilio;
• Электронная коммерция — Shopify, WooCommerce;
• Платежи и бухгалтерия — Stripe, Razorpay, Paddle, QuickBooks, Xero;
• Документы и электронная подпись — DocuSign, PandaDoc;
• Аналитика — Mixpanel, PostHog;
• Контент и соцсети — WordPress, RSS, YouTube.

Механизм поддерживает базовую авторизацию, произвольные пользовательские поля авторизации и полноценный OAuth2 (всплывающее окно авторизации и автоматическое обновление токена) — поэтому через него можно подключать сервисы, которым нужен OAuth2, даже когда прямой поддержки OAuth2 во встроенных интеграциях ещё нет. Часть сервисов из списка поддерживает несколько способов авторизации (например, Slack, Notion, HubSpot, GitHub) — в этих случаях адаптер выбирает тот способ, что удобнее для self-hosted-развёртывания (как правило, статический токен), а не требует регистрировать OAuth2-приложение у вендора.

Большинство действий выше — типизированные формы, сгенерированные из собственных описаний полей сервиса. У части сервисов (включая Typeform, JotForm, Calendly и Box, а также у общего действия «произвольный вызов API», присутствующего почти у каждого сервиса) поля, чья форма вычисляется вендором только во время выполнения, — для них вместо типизированной формы доступно одно свободное поле-выражение (авторизованный проброс запроса к API вендора), без подсказки конкретных ключей, которые вендор ожидает.

Что дальше

Список встроенных интеграций активно расширяется в сторону сервисов, востребованных на российском рынке: 1С, Bitrix24, amoCRM, ЮKassa/СБП, Диадок/СБИС и другие.