Документация СМЕТРУМ
Документация/Интеграции и API

Продажи: подключить мессенджеры, Авито и витрину

Глава 33Интеграции и APIРуководителю и менеджеру · 12 мин

Пошаговое подключение Telegram, WhatsApp, MAX, сообществ VK и Авито. Публикация витрины, установка виджета, права сотрудников и восстановление связи.

Что подключается к Продажам

В «Продажи → Чаты» собираются обращения клиентов из подключённых аккаунтов, сообществ и витрины. Сотрудник может прочитать диалог, ответить от имени подключённого аккаунта и нажать «Создать лид», чтобы начать работу с обращением в продажах.

Подключение относится к выбранной компании. Импортированные диалоги видят её сотрудники с правом просмотра Продаж, включая доступные личные разговоры рабочего аккаунта. Подключайте аккаунт, перепиской которого уполномочены делиться с командой.

КаналЧто потребуется
TelegramРабочий личный аккаунт, телефон для QR-входа и пароль двухэтапной проверки, если он включён.
WhatsApp*Приложение WhatsApp или WhatsApp Business на телефоне; подключение как связанного устройства по QR-коду.
MAXРабочий личный аккаунт и приложение на телефоне для QR-входа.
ВКонтактеСообщество с включёнными сообщениями и собственный ключ доступа к ним. Можно подключить несколько сообществ.
АвитоClient ID и Client secret приложения персональной авторизации, доступ аккаунта к API мессенджера.
Витрина и виджетУслуги, фотографии, форма заявки и реквизиты исполнителя. Внешний аккаунт не нужен.

Права сотрудников и подготовка

  1. Выберите компанию, для которой настраиваете приём обращений.
  2. Для просмотра подключений нужны права «Настройки — просмотр» и «Продажи — просмотр». Для подключения, отключения и сохранения витрины также нужны права изменения в обоих разделах.
  3. Чтобы читать клиентские диалоги, сотруднику нужен просмотр Продаж; чтобы отвечать и создавать лиды — изменение Продаж. Проверьте роль в разделе «Сотрудники → Роли и права».
  4. Откройте «Настройки → Интеграции → Для продаж» и выберите канал в блоке «Подключения для продаж».
  5. Прочитайте условия подключения и обработки переписки. Подтвердите полномочия на подключение аккаунта и нажмите «Продолжить подключение». Затем выполните шаги своего канала ниже.
Открыть подключения для продаж Условия подключения и обработки переписки Способы подключения, маршрут обработки данных и ограничения сервиса. Настроить роли сотрудников

Telegram: вход по QR-коду и двухэтапная проверка

Подключается пользовательская сессия Telegram. Импортируются личные диалоги; группы, каналы, боты, «Избранное» и служебный диалог с кодами Telegram в этот список не входят. Подключение не переносит полный архив аккаунта.

  1. Нажмите «Подключить Telegram» и пройдите подтверждение условий.
  2. На телефоне откройте Telegram → «Настройки» → «Устройства» → «Подключить устройство». Отсканируйте QR-код из Сметрума и подтвердите вход.
  3. Если появилось поле «Пароль двухэтапной проверки Telegram», введите пароль, который вы задали в Telegram, и нажмите «Подтвердить». Это отдельный пароль Telegram, а не пароль от Сметрума.
  4. Дождитесь статуса «Подключён», проверьте имя аккаунта и нажмите «Открыть диалоги».
  5. Если QR-код истёк, нажмите «Обновить QR». При ошибке пароля проверьте раскладку; если вход уже завершился ошибкой, используйте «Повторить».

WhatsApp* и приложение WhatsApp Business

  1. Нажмите «Подключить WhatsApp» и пройдите подтверждение условий.
  2. На телефоне откройте WhatsApp или приложение WhatsApp Business → «Настройки» либо меню ⋮ → «Связанные устройства» → «Привязка устройства».
  3. Отсканируйте QR-код из Сметрума и выполните подтверждение на телефоне, если приложение его запросит.
  4. Дождитесь статуса «Подключён» и откройте «Продажи → Чаты». Дайте приложению время передать доступную историю.
  5. Если код устарел, нажмите «Обновить QR». Если WhatsApp завершил сеанс, подключите устройство заново.

MAX: подключить рабочий личный аккаунт

Для этого подключения используется неофициальная библиотека. Изменения MAX могут потребовать повторного входа или обновления сервиса Сметрума. QR-вход подключает переписку аккаунта к Продажам; привязка к боту Сметрума настраивается отдельно.

  1. Нажмите «Подключить MAX» и пройдите подтверждение условий.
  2. На телефоне откройте MAX → «Настройки» → «Устройства» → «Войти по QR-коду». Отсканируйте код и подтвердите вход.
  3. Если Сметрум запросит пароль двухэтапной проверки MAX, введите его и нажмите «Подтвердить».
  4. Дождитесь статуса «Подключён», проверьте имя аккаунта и откройте диалоги.
  5. При истёкшем коде используйте «Обновить QR», при завершившейся ошибке — «Повторить».

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

Здесь используется официальный VK API сообщений сообществ. Ключ от личной страницы не заменяет ключ сообщества. Сохранённый ключ хранится на сервере в зашифрованном виде; не вставляйте его в переписку с клиентом или обращение в поддержку.

Если текст отправляется, а вложения отклоняются, проверьте разрешения ключа для соответствующего типа вложений. После изменения или отзыва ключа повторите подключение с актуальным ключом.

  1. Войдите во ВКонтакте под аккаунтом с правом управления нужным сообществом. Включите сообщения сообщества в его настройках.
  2. В сообществе откройте «Управление → Дополнительно → Работа с API → Ключи доступа» и нажмите «Создать ключ». Названия пунктов могут отличаться в разных версиях VK.
  3. Разрешите доступ к сообщениям сообщества. Если будете отправлять документы или голосовые сообщения, добавьте доступ к документам; для фотографий проверьте право доступа к фотографиям.
  4. В Сметруме нажмите «Подключить сообщество», подтвердите условия и заполните поля «Ссылка или ID сообщества» и «Ключ доступа сообщества».
  5. Нажмите «Подключить сообщество». Сметрум проверит ключ, принадлежность к сообществу и доступ к сообщениям. Дождитесь статуса «Подключён».
  6. Для другого сообщества нажмите «Подключить ещё сообщество» и повторите шаги с его ссылкой и его ключом. У каждого сообщества отдельное подключение.

Авито: Client ID и Client secret

  1. Откройте портал разработчика Авито под основным аккаунтом компании.
  2. В разделе «Мои приложения» найдите приложение персональной авторизации и скопируйте его Client_id и Client_secret.
  3. В Сметруме нажмите «Подключить Авито», подтвердите условия и вставьте значения в поля «Client ID» и «Client secret».
  4. Нажмите «Подключить аккаунт». Сметрум проверит ключи, аккаунт и доступ к его переписке.
  5. После статуса «Подключён» откройте диалоги. Для дополнительного аккаунта используйте «Подключить ещё аккаунт» и его собственные ключи.
Мои приложения на портале Авито Открывайте под аккаунтом, переписку которого подключаете.

Витрина: услуги и форма заявки

Витрина принимает заявку и без выбора услуг. Если клиент выбрал работы и объём, вместе с обращением придёт предварительный расчёт. Итоговую стоимость уточняйте с клиентом.

  1. В блоке «Витрина и заявки» нажмите «Настроить витрину». Откроется раздел «Витрина и виджет».
  2. Выберите готовый стиль и заполните «Первый экран»: название, описание, город, обложку и логотип.
  3. В «Услуги и цены» добавьте работы, единицы и цены. Пустая цена означает стоимость по договорённости. В «Фото работ» добавьте примеры.
  4. В «Форма заявки» настройте поля, обязательность, подсказки и способы связи с клиентом. Имя остаётся обязательным. Можно добавить собственные поля.
  5. Проверьте версии для компьютера и телефона. Предпросмотр показывает оформление, но не отправляет заявки.

Опубликовать ссылку и установить виджет на сайт

Код виджета уже содержит идентификатор вашей витрины. Используйте код из своего раздела «Публикация». После изменения оформления сохраните настройки и обновите страницу сайта.

  1. Откройте «Публикация». Укажите наименование исполнителя, контакт по вопросам персональных данных и ссылку на политику обработки данных вашей компании.
  2. Включите «Опубликовать витрину» и нажмите «Сохранить изменения». Убедитесь, что появился статус «Опубликовано».
  3. В блоке «Ссылка на витрину» нажмите «Копировать ссылку». Эту общую ссылку можно разместить в соцсетях, объявлении или отправить клиенту.
  4. Для собственного сайта сначала настройте вид кнопки в «Кнопка на сайт», затем сохраните изменения.
  5. В «Публикация → Установить кнопку-виджет» нажмите «Копировать код». Вставьте выданный код перед закрывающим тегом </body> на нужных страницах сайта либо передайте его специалисту по сайту.
  6. Откройте опубликованную ссылку и страницу сайта с виджетом. Нажмите кнопку: должна открыться ваша витрина с формой. Для проверки приёма можно отправить одну заявку со своими тестовыми контактами.
Открыть конструктор витрины

Получить заявку с витрины и ответить клиенту

  1. Откройте «Продажи → Чаты» и найдите диалог канала «Витрина». В первом сообщении будут контакты, ответы формы, выбранные услуги и предварительная сумма.
  2. При необходимости нажмите «Создать лид», чтобы вести обращение в продажах. Сам импорт переписки не создаёт лид из каждого разговора.
  3. Напишите ответ в диалоге. Клиент увидит его в чате на витрине.
  4. После заявки клиент может скопировать личную ссылку на переписку и вернуться по ней позже. Эту ссылку следует сохранить у себя, а не публиковать вместо общей ссылки на витрину.

Какую историю и действия поддерживают каналы

В тестовой версии загружаются последние доступные диалоги. Telegram, MAX, VK и Авито запрашивают до 40 последних сообщений при загрузке истории чата; WhatsApp передаёт историю связанного устройства самостоятельно. Отсутствие старых сообщений не означает, что они удалены в мессенджере.

Импорт полного архива не предусмотрен. Количество диалогов, доступность вложений, скорость обновления и статусы зависят от канала и ответа провайдера. После подключения откройте нужный диалог и используйте «Обновить переписку», если сообщения ещё не появились.

Доступные действия видны прямо в чате. В Авито отправляются текст и изображения; текст к изображению отправьте отдельным сообщением. Витрина поддерживает текстовую переписку. Максимальный размер отправляемого вложения в поддерживающих их каналах — 10 МБ.

Восстановить связь или отключить канал

После повторного подключения проверьте аккаунт, канал и актуальные диалоги. Не рассчитывайте, что новый вход сам восстановит полный архив или объединит всю переписку прежнего подключения.

  1. В «Настройки → Интеграции → Для продаж» найдите аккаунт в списке подключений. «Состояние» открывает подключённый аккаунт, «Продолжить» — незавершённое подключение.
  2. При статусе «Восстанавливаем связь» подождите и проверьте состояние снова. Если появилась ошибка, прочитайте её текст: для отозванной сессии нужен новый QR-вход, для VK или Авито — проверка актуальных ключей и доступа.
  3. Для остановки обмена нажмите «Отключить» у нужного аккаунта и подтвердите действие. Уже загруженные в Сметрум сообщения не удаляются.
  4. При необходимости также отзовите связанную сессию в самом мессенджере или ключ у провайдера. Учитывайте, что этот ключ может использоваться и в других ваших сервисах.
  5. Для остановки витрины снимите «Опубликовать витрину» и сохраните изменения. Новые заявки и сообщения посетителей перестанут приниматься, история останется в CRM.

Чем подключения продаж отличаются от ботов VK/MAX

Код привязки к боту не подключает личную переписку к Продажам. Ключ сообщества для продаж также не заменяет привязку сотрудника к боту. Управляйте нужной связью в соответствующей вкладке.

Где настраиватьДля чего нужно
Интеграции → Для продажКлиентская переписка подключённых аккаунтов и сообществ, общая для сотрудников с доступом к Продажам.
Интеграции → Чаты компанииПривязка сотрудника к боту VK/MAX, рабочие беседы компании и проектов, связанные с ними сообщения и уведомления.
Инструкция по чатам компании и привязкам VK/MAX

Если подключение или виджет не работает

Для обращения в поддержку укажите канал, время ошибки и её текст. Не прикладывайте QR-код для входа, ключ доступа, Client secret, пароль или личную ссылку клиента на переписку.

Что произошлоЧто проверить
Кнопка подключения недоступнаВыбранную компанию, права просмотра и изменения Настроек и Продаж, сообщение о доступности сервиса над списком аккаунтов.
Telegram сообщает, что подключение ещё настраиваетсяПередайте текст ошибки поддержке Сметрума. Ключи приложения на сервере настраивает администратор сервиса.
QR не считывается или вход не завершилсяСканируйте код через раздел устройств нужного мессенджера на телефоне. Обновите истёкший QR, подтвердите вход и при запросе введите пароль двухэтапной проверки.
VK отклоняет ключИспользуйте ключ именно указанного сообщества. Включите сообщения сообщества и разрешение доступа к сообщениям у ключа. Для вложений проверьте дополнительные разрешения.
Авито отклоняет Client ID или Client secretСкопируйте оба значения из одного приложения персональной авторизации нужного аккаунта, без лишних пробелов. При ограничении подписки проверьте доступ к API мессенджера в Авито.
Канал подключён, но старого диалога нетПроверьте выбранную компанию и аккаунт, откройте или обновите чаты. Учитывайте ограничения импорта истории и типов диалогов.
Сообщение или файл не отправляетсяПроверьте статус канала, права изменения Продаж, доступный тип и размер вложения. При ограничении частоты запросов повторите позже.
Виджет не появилсяПроверьте публикацию и сохранение витрины, наличие полного кода на странице и разрешение сайта на внешние скрипты. Если ссылка работает, а кнопка нет, передайте код виджета специалисту по сайту.
Заявка не появилась после предпросмотраПредпросмотр не отправляет заявки. Откройте опубликованную ссылку и заполните обязательные поля формы и согласие. Затем проверьте «Продажи → Чаты».