Интеграции и каналы
Интеграция — это подключение OneTrace.pro к внешнему сервису: почтовому серверу, SMS-шлюзу, боту в мессенджере, рекламному кабинету или хранилищу файлов. Через подключённые каналы работают цепочки и рассылки, через площадки — выгрузки аудиторий и конверсии в рекламу, через источники — регулярный импорт данных.
Раздел открывается в меню Коммуникации → Интеграции.

Подключённые интеграции сгруппированы по видам. Когда видов несколько, над карточками появляется фильтр: Все, Каналы, CRM и т. д., со счётчиками.
Что можно подключить
Новая интеграция подключается кнопкой Добавить интеграцию: в окне сервисы разбиты по видам, а поиск находит сервис по названию. Кнопка + у заголовка группы на странице открывает окно сразу на этом виде.
Каналы — через них отправляются сообщения:
| Канал | Как работает |
|---|---|
| почтовый сервис платформы — отправка с вашего домена из раздела Домены отправки: подпись DKIM, возвраты, жалобы и стоп-лист работают сами; или свой SMTP-сервер: адрес, порт, шифрование, логин и пароль. В обоих случаях — адрес и имя отправителя, отслеживание открытий и переходов. Для своего SMTP можно указать домен и ящик возвратов, чтобы недоставленные письма отписывали адрес автоматически. Письма клиентов на адрес поддержки можно принимать в онлайн-чат, см. Входящие письма в чате | |
| SMS | провайдер на выбор: SMS.ru, SMSC.ru, Twilio или свой HTTP API шлюза. Статусы доставки приходят на адрес, показанный в интеграции |
| Telegram | бот, созданный в BotFather: достаточно токена, адрес для входящих сообщений бот получит сам |
| Viber (рассылки) | сообщения по номеру телефона через агрегатора: SMSC.ru, Infobip или свой HTTP API |
| Бот Viber | бот Viber по токену из партнёрского кабинета, с приветствием для новых подписчиков |
| Бот MAX | бот мессенджера MAX по токену из business.max.ru, с приветствием и кнопкой «Поделиться номером», см. Бот MAX |
| Сообщество ВКонтакте | сообщения от имени сообщества по ключу доступа, с тарифа «Рост», см. Сообщество ВКонтакте |
| Instagram Direct | сообщения от бизнес-аккаунта Instagram через ваше приложение Meta, с тарифа «Рост», см. Instagram Direct |
| Facebook Messenger | сообщения от страницы Facebook через ваше приложение Meta, с тарифа «Рост», см. Facebook Messenger |
| WhatsApp Business Cloud API: ID номера, ID аккаунта, токен и секрет приложения Meta | |
| Web Push | уведомления в браузере; ключи создаются автоматически, подписки собирает код на сайте, см. Подключение сайта |
| Мобильный push | уведомления в приложении для Android и iOS: пакет и сервисный аккаунт Firebase, bundle id и ключ APNs, см. Мобильные приложения |
| Сообщения в приложении | окно, баннер или полный экран внутри открытого приложения; с тарифа «Рост», см. Мобильные приложения |
| Карты Wallet | карта лояльности в Apple Wallet и Google Wallet: сертификат Pass Type ID Apple, Issuer ID и сервисный аккаунт Google; с тарифа «Рост», см. Карты Wallet |
| Вебхук | запрос на ваш сервер с данными сообщения, например для своей системы уведомлений |
Выгрузки аудиторий — Вебхук, S3 (CSV), Meta Custom Audience, Яндекс Аудитории, VK Реклама и Google Ads Customer Match.
Конверсии в рекламу — Meta Conversions API, офлайн-конверсии Яндекс Метрики и Google Ads, офлайн-события VK Рекламы, см. Конверсии в рекламу.
Источники данных — файл по ссылке, файл из S3 и Google Таблица.
Хранилища данных — S3 (NDJSON), Google Cloud Storage, BigQuery, Snowflake, ClickHouse и PostgreSQL для выгрузки данных проекта. Группа видна на тарифе «Корпоративный».
CRM — amoCRM, Kommo, Битрикс24, HubSpot, Pipedrive, Zoho CRM, Odoo, Salesforce и Microsoft Dynamics 365: контакты, лиды и сделки в профилях и событиях, узлы цепочек для сделок и задач, выгрузка сегментов обратно в CRM, см. CRM. Группа видна с тарифа «Рост».
Одного вида можно подключить несколько интеграций: например, два SMTP-сервера для маркетинговых и транзакционных писем. В шаблонах, цепочках и рассылках вы выбираете, через какую интеграцию отправлять.
Как подключить интеграцию
- Нажмите Добавить интеграцию и выберите сервис, например Email. Слева в окне — виды интеграций с пояснением, сверху — поиск по названию.
- Задайте Название — его вы увидите в шаблонах, цепочках и выгрузках, например «Маркетинговая почта».
- Заполните настройки. Подсказки под полями объясняют, где взять токен или ключ в кабинете сервиса.
- Нажмите Сохранить. Чтобы выбрать другой сервис, нажмите Назад.
- На карточке интеграции нажмите Проверить.


Для некоторых сервисов после сохранения в настройках появляются служебные поля — например, Адрес вебхука и Токен проверки у WhatsApp или Адрес для статусов доставки у SMS. Скопируйте их в кабинет сервиса, иначе статусы доставки и входящие сообщения не будут приходить.
Telegram, Бот Viber, Бот MAX и WhatsApp получают входящие сообщения по адресу вашей установки OneTrace.pro: он должен быть доступен из интернета по HTTPS.
Бот MAX
- Создайте бота на business.max.ru — разместить бота может российское юрлицо, ИП или самозанятый — и скопируйте токен: «Чат-боты» → ⋮ → «Настройки».
- Нажмите Добавить интеграцию, выберите Бот MAX, вставьте Токен бота и сохраните. Адрес для входящих сообщений бот получит сам, а его имя появится в настройках.
- По желанию задайте Приветствие и текст кнопки «Поделиться номером»: бот отправит их, когда покупатель его запустит.

Писать бот может только тем, кто его запустил. С профилем покупатель связывается двумя способами:
- по ссылке — ваш сервер создаёт для вошедшего покупателя ссылку
https://max.ru/{бот}?start=…(POST /api/v1/max/link, так же, как для Telegram), и покупатель открывает бота по ней; - по номеру — покупатель нажимает в приветствии кнопку «Поделиться номером». Если MAX подтвердил, что номер принадлежит его аккаунту, бот привязывается к профилю с этим телефоном. Пересланная чужая карточка контакта не привязывается.
Запуск бота — подписка на канал, остановка бота или удаление диалога — отписка. Сообщения покупателей боту становятся событием max.message и, с тарифа «Рост», диалогами онлайн-чата. Отчётов о доставке у MAX нет: принятое сообщение считается доставленным. Правила MAX запрещают рекламу в служебных сообщениях.
Сообщество ВКонтакте
- В сообществе откройте Управление → Сообщения и включите сообщения сообщества.
- В Управление → Работа с API → Ключи доступа нажмите «Создать ключ» и отметьте права «Управление сообществом», «Сообщения сообщества», «Фотографии» и, если правила будут отвечать на комментарии, «Стена».
- Нажмите Добавить интеграцию, выберите Сообщество ВКонтакте, вставьте Ключ доступа сообщества и сохраните. OneTrace.pro проверит права ключа, сам добавит сервер Callback API в настройки сообщества и покажет название и адрес сообщества.
- По желанию задайте Приветствие: его получит человек, который разрешил сообщения сообщества.

Сообщество может писать только тем, кто разрешил сообщения: написал сам, нажал «Разрешить сообщения» или перешёл по ссылке vk.me. Это и есть подписка на канал, а запрет сообщений — отписка. Ваш сервер может связать человека с профилем покупателя: POST /api/v1/vk/link создаёт для вошедшего покупателя ссылку https://vk.me/{сообщество}?ref=…, а ту же метку можно передать ключом в виджет «Разрешить сообщения».
В сообщении можно отправить текст, картинку и кнопки-ссылки. Картинку ВКонтакте по ссылке не принимает: OneTrace.pro загружает файл сам, один раз на рассылку. Сообщения людей становятся событием vk.message и диалогами онлайн-чата, а комментарии к постам — поводом для правил по ключевым словам. Удаление интеграции убирает и сервер Callback API из настроек сообщества.
Instagram Direct
Instagram подключается через ваше приложение в Meta: для своего аккаунта проверка приложения в Meta не нужна.
- В Meta for Developers создайте приложение, добавьте продукт Instagram и в разделе Настройка API со входом через Instagram подключите бизнес-аккаунт.
- Нажмите «Создать токены доступа» и скопируйте токен. Нужны права
instagram_business_basic,instagram_business_manage_messagesи, для ответов на комментарии,instagram_business_manage_comments. Там же скопируйте секрет приложения Instagram. - Нажмите Добавить интеграцию, выберите Instagram Direct, вставьте токен и секрет и сохраните. В настройках появятся Адрес вебхука и Токен подтверждения.
- Укажите адрес и токен в настройках вебхуков приложения (раздел Instagram). Подписать аккаунт на события OneTrace.pro сможет сам.

Токен живёт 60 дней, OneTrace.pro продлевает его сам. Если продлить не удалось, ошибка появится на карточке интеграции: создайте новый токен и сохраните интеграцию до того, как старый истечёт.
Instagram разрешает писать человеку только в течение 24 часов после его сообщения. Рассылки и цепочки пропускают тех, кто писал раньше, — сообщение не уходит, подписка остаётся. Оператор чата может ответить и позже, до 7 дней, если у приложения есть право Human Agent и в интеграции включено Ответы операторов до 7 дней.
Первое сообщение человека — подписка на канал, «стоп» — отписка. Ссылку на переписку с меткой для связи с профилем создаёт POST /api/v1/instagram/link: https://ig.me/m/{аккаунт}?ref=…. Сообщения и ответы на истории становятся событием instagram.message и диалогами онлайн-чата, а комментарии — поводом для правил по ключевым словам.
Facebook Messenger
Messenger подключается через ваше приложение в Meta, как Instagram: для своей страницы проверка приложения в Meta не нужна.
- В Meta for Developers создайте приложение и добавьте продукт Messenger.
- В разделе Messenger → Настройки API подключите страницу Facebook и создайте токен страницы с правом
pages_messaging. Нужен бессрочный токен: OneTrace.pro его не продлевает. В Настройки приложения → Основное скопируйте секрет приложения. - Нажмите Добавить интеграцию, выберите Facebook Messenger, вставьте токен и секрет и сохраните. OneTrace.pro найдёт страницу, подпишет её на сообщения и покажет Адрес вебхука и Токен подтверждения.
- Укажите адрес и токен в настройках вебхуков приложения (раздел Messenger).
Messenger, как и Instagram, разрешает писать человеку только 24 часа после его сообщения: рассылки и цепочки пропускают тех, кто писал раньше. Оператор чата может ответить до 7 дней, если у приложения есть право Human Agent и в интеграции включено Ответы операторов до 7 дней.
Первое сообщение человека — подписка на канал и Приветствие из настроек интеграции, «стоп» — отписка. Человек получает в профиле идентификатор facebook_psid — номер переписки именно с вашей страницей — и имя из Facebook, если страница его видит. Сообщения, фото и файлы становятся событием messenger.message и диалогами онлайн-чата. Кнопки быстрых ответов оператора приходят в Messenger настоящими кнопками.
Входящие письма в чате
В интеграции email группа Входящие письма в чате принимает письма клиентов на адрес поддержки в онлайн-чат. Ответ оператора уходит этой же интеграцией в ту же переписку. Способы:
- Ящик IMAP — сервер, порт, шифрование, логин, пароль и папка ящика поддержки. Новые письма читаются раз в минуту и отмечаются прочитанными.
- Вебхук — после сохранения появится Адрес вебхука с токеном. Укажите его в почтовом сервисе как адрес для входящих писем. Подходят: Postmark — Inbound webhook, SendGrid — Inbound Parse с «POST the raw, full MIME message» или без него, Mailgun — Routes с действием forward, Cloudflare Email Workers — отправкой письма целиком. Токен в адресе — секрет: не публикуйте адрес. Если адрес мог попасть к посторонним, отметьте Сменить адрес вебхука и сохраните: появится новый адрес, а прежний перестанет принимать письма. Адрес видят только те, кто может управлять интеграцией.
Адрес поддержки обязателен для обоих способов: на него пишут клиенты, он же — адрес для ответа в письмах операторов.
Проверка и статусы
Кнопка Проверить подключается к сервису и показывает результат: «Подключение работает» с подробностями (имя бота, баланс у SMS-провайдера, доступный бакет) или «Проверка не прошла» с текстом ошибки. Время последней проверки показано на карточке.
| Статус | Что значит |
|---|---|
| Работает | подключение в порядке |
| Ошибка | последняя проверка или настройка не удалась; текст ошибки — на карточке. Исправьте настройки и проверьте снова |
| Выключена | интеграция отключена переключателем Включена в её настройках; сообщения через неё не отправляются |
Проверка SMS через свой HTTP API только убеждается, что адрес шлюза доступен: настоящее SMS платное, поэтому отправку проверьте тестовым сообщением из шаблона.
Изменение и удаление
- Изменить открывает настройки. Пароли, токены и ключи после сохранения не показываются: оставьте такое поле пустым, чтобы сохранить прежнее значение.
- Чтобы временно остановить отправку, выключите переключатель Включена — настройки сохранятся.
- Удалить интеграцию — сообщения через неё больше не будут отправляться, а выгрузки и источники с этим подключением остановятся с ошибкой. У ботов Telegram, Viber и MAX и у SMS.ru платформа сама снимает свой вебхук. Если сервис недоступен, появится предупреждение — снимите вебхук вручную в настройках бота или в личном кабинете.
Кто может управлять интеграциями
| Действие | Роли |
|---|---|
| Видеть интеграции | «Владелец», «Администратор», «Менеджер» |
| Подключать, менять, проверять и удалять | «Владелец», «Администратор» |
Роль участника можно ограничить отдельными интеграциями, см. Участники и роли. Такой участник видит в разделе только свои интеграции и управляет только ими, если роль это разрешает. Подключить новую интеграцию он не может: для этого нужно право на весь проект. В редакторах шаблонов и цепочек он по-прежнему выбирает интеграцию из всех подключённых в проекте.
Что важно знать
- Каналы не проверяют подписки и частоту сами: эти правила общие для всех каналов и задаются на странице Правила рассылок.
- Там же можно выключить ненужное расширение, например WhatsApp. Выключенное расширение пропадает из интеграций, шаблонов и цепочек проекта.
- Первое сообщение в WhatsApp и рассылки там возможны только одобренными Meta шаблонами; свободный текст — в течение 24 часов после сообщения клиента. Шаблоны Meta, карусели товаров и формы WhatsApp — в статье Покупки в WhatsApp.
- С почтовым сервисом платформы записи DKIM, SPF и возвратов вы добавляете один раз при подключении домена — см. Домены отправки. Для своего SMTP-сервера SPF, DKIM и DMARC настраиваются на его стороне и на вашем домене.