OneTrace.pro Справка

Интеграции и каналы

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

Раздел открывается в меню Коммуникации → Интеграции.

Страница «Интеграции» с подключёнными каналами

Подключённые интеграции сгруппированы по видам. Когда видов несколько, над карточками появляется фильтр: Все, Каналы, CRM и т. д., со счётчиками.

Что можно подключить

Новая интеграция подключается кнопкой Добавить интеграцию: в окне сервисы разбиты по видам, а поиск находит сервис по названию. Кнопка + у заголовка группы на странице открывает окно сразу на этом виде.

Каналы — через них отправляются сообщения:

Канал Как работает
Email почтовый сервис платформы — отправка с вашего домена из раздела Домены отправки: подпись 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 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-сервера для маркетинговых и транзакционных писем. В шаблонах, цепочках и рассылках вы выбираете, через какую интеграцию отправлять.

Как подключить интеграцию

  1. Нажмите Добавить интеграцию и выберите сервис, например Email. Слева в окне — виды интеграций с пояснением, сверху — поиск по названию.
  2. Задайте Название — его вы увидите в шаблонах, цепочках и выгрузках, например «Маркетинговая почта».
  3. Заполните настройки. Подсказки под полями объясняют, где взять токен или ключ в кабинете сервиса.
  4. Нажмите Сохранить. Чтобы выбрать другой сервис, нажмите Назад.
  5. На карточке интеграции нажмите Проверить.

Окно «Новая интеграция»: виды интеграций, поиск и сервисы

Окно подключения интеграции Email

Для некоторых сервисов после сохранения в настройках появляются служебные поля — например, Адрес вебхука и Токен проверки у WhatsApp или Адрес для статусов доставки у SMS. Скопируйте их в кабинет сервиса, иначе статусы доставки и входящие сообщения не будут приходить.

Telegram, Бот Viber, Бот MAX и WhatsApp получают входящие сообщения по адресу вашей установки OneTrace.pro: он должен быть доступен из интернета по HTTPS.

Бот MAX

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

Окно подключения бота MAX

Писать бот может только тем, кто его запустил. С профилем покупатель связывается двумя способами:

  • по ссылке — ваш сервер создаёт для вошедшего покупателя ссылку https://max.ru/{бот}?start=… (POST /api/v1/max/link, так же, как для Telegram), и покупатель открывает бота по ней;
  • по номеру — покупатель нажимает в приветствии кнопку «Поделиться номером». Если MAX подтвердил, что номер принадлежит его аккаунту, бот привязывается к профилю с этим телефоном. Пересланная чужая карточка контакта не привязывается.

Запуск бота — подписка на канал, остановка бота или удаление диалога — отписка. Сообщения покупателей боту становятся событием max.message и, с тарифа «Рост», диалогами онлайн-чата. Отчётов о доставке у MAX нет: принятое сообщение считается доставленным. Правила MAX запрещают рекламу в служебных сообщениях.

Сообщество ВКонтакте

  1. В сообществе откройте Управление → Сообщения и включите сообщения сообщества.
  2. В Управление → Работа с API → Ключи доступа нажмите «Создать ключ» и отметьте права «Управление сообществом», «Сообщения сообщества», «Фотографии» и, если правила будут отвечать на комментарии, «Стена».
  3. Нажмите Добавить интеграцию, выберите Сообщество ВКонтакте, вставьте Ключ доступа сообщества и сохраните. OneTrace.pro проверит права ключа, сам добавит сервер Callback API в настройки сообщества и покажет название и адрес сообщества.
  4. По желанию задайте Приветствие: его получит человек, который разрешил сообщения сообщества.

Окно подключения сообщества ВКонтакте

Сообщество может писать только тем, кто разрешил сообщения: написал сам, нажал «Разрешить сообщения» или перешёл по ссылке vk.me. Это и есть подписка на канал, а запрет сообщений — отписка. Ваш сервер может связать человека с профилем покупателя: POST /api/v1/vk/link создаёт для вошедшего покупателя ссылку https://vk.me/{сообщество}?ref=…, а ту же метку можно передать ключом в виджет «Разрешить сообщения».

В сообщении можно отправить текст, картинку и кнопки-ссылки. Картинку ВКонтакте по ссылке не принимает: OneTrace.pro загружает файл сам, один раз на рассылку. Сообщения людей становятся событием vk.message и диалогами онлайн-чата, а комментарии к постам — поводом для правил по ключевым словам. Удаление интеграции убирает и сервер Callback API из настроек сообщества.

Instagram Direct

Instagram подключается через ваше приложение в Meta: для своего аккаунта проверка приложения в Meta не нужна.

  1. В Meta for Developers создайте приложение, добавьте продукт Instagram и в разделе Настройка API со входом через Instagram подключите бизнес-аккаунт.
  2. Нажмите «Создать токены доступа» и скопируйте токен. Нужны права instagram_business_basic, instagram_business_manage_messages и, для ответов на комментарии, instagram_business_manage_comments. Там же скопируйте секрет приложения Instagram.
  3. Нажмите Добавить интеграцию, выберите Instagram Direct, вставьте токен и секрет и сохраните. В настройках появятся Адрес вебхука и Токен подтверждения.
  4. Укажите адрес и токен в настройках вебхуков приложения (раздел Instagram). Подписать аккаунт на события OneTrace.pro сможет сам.

Окно подключения Instagram Direct

Токен живёт 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 не нужна.

  1. В Meta for Developers создайте приложение и добавьте продукт Messenger.
  2. В разделе Messenger → Настройки API подключите страницу Facebook и создайте токен страницы с правом pages_messaging. Нужен бессрочный токен: OneTrace.pro его не продлевает. В Настройки приложения → Основное скопируйте секрет приложения.
  3. Нажмите Добавить интеграцию, выберите Facebook Messenger, вставьте токен и секрет и сохраните. OneTrace.pro найдёт страницу, подпишет её на сообщения и покажет Адрес вебхука и Токен подтверждения.
  4. Укажите адрес и токен в настройках вебхуков приложения (раздел 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 настраиваются на его стороне и на вашем домене.