Помощь

С чего начать

От регистрации до первого клиента, которому вы ответили, — шесть шагов. При первой регистрации — пробный период: месяц полного доступа.

Подключение каналов

Пошаговые инструкции для каждого канала. Каналы подключаются к сайту (виджету) в личном кабинете, в разделе «Каналы»; после сохранения Smartbtn проверяет, что площадка принимает сообщения. Сообщения из всех каналов приходят в «Диалоги».

Telegram‑ботПонадобится: бот от @BotFather, его username и токен.6 шагов → Сообщество ВКонтактеПонадобится: ключ доступа сообщества и ссылка или ID сообщества.5 шагов → MAX‑ботПонадобится: верифицированная организация на business.max.ru, никнейм и токен бота.6 шагов → WhatsApp Business (Cloud API)Понадобится: приложение Meta Business с WhatsApp, номер, Phone number ID, WABA ID и бессрочный маркер.6 шагов · около 10 минут → Кабинеты AvitoПонадобится: аккаунт Avito с подходящей подпиской; авторизация через Avito.4 шага → ЦИАНПонадобится: тариф «Базовый» в ЦИАН, ключ Циан API и адрес кабинета.5 шагов → Messenger (Facebook)Понадобится: долгоживущий токен Страницы и её адрес.5 шагов → Viber‑ботПонадобится: коммерческий бот Viber, его URI и токен (app key).5 шагов → Группа в ОдноклассникахПонадобится: ключ доступа и ссылка на диалог с группой.6 шагов → AliExpressПонадобится: API‑токен из кабинета продавца AliExpress и адрес или ID магазина.5 шагов → Apple Messages for BusinessПонадобится: аккаунт Messages for Business, связанный с Infobip, Apple Business ID и API‑ключ Infobip.7 шагов → WordPress и другие CMSУстановка кода виджета на сайт на CMS.3 шага →

Telegram‑бот

Клиенты пишут вашему боту в Telegram, вы отвечаете из Smartbtn — ответ приходит в Telegram.

1. Создайте бота у @BotFatherВ Telegram откройте @BotFather, отправьте команду /newbot и задайте имя и username бота. Username должен оканчиваться на «bot».
2. Скопируйте токенBotFather пришлёт токен вида 123456:AAH… — скопируйте его целиком.
3. Укажите username ботаВ личном кабинете откройте «Каналы», выберите Telegram и введите username бота без символа @.
4. Вставьте токенВставьте токен в поле «Токен бота».
5. Подключите TelegramНажмите «Подключить Telegram». Smartbtn спросит у Telegram, отвечает ли бот, — зелёная отметка появится только после его ответа.
6. Отправьте боту /startОткройте бота в Telegram и отправьте ему /start. После этого он сможет переписываться с клиентами.

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

Сообщения в ваше сообщество ВКонтакте приходят в Smartbtn, ответы уходят обратно во ВКонтакте от имени сообщества. Можно подключить несколько сообществ.

1. Создайте ключ доступа сообществаВ сообществе откройте «Управление» → «Дополнительно» → «Работа с API» → вкладка «Ключи доступа» → «Создать ключ». Отметьте права «Сообщения сообщества», «Управление сообществом», «Фотографии», «Документы» и нажмите «Создать»; подтвердите действие в приложении ВКонтакте или по СМС.
2. Вставьте ключВ личном кабинете откройте «Каналы» → ВКонтакте и вставьте ключ в поле «Токен сообщества».
3. Укажите сообществоВ поле «Ссылка или ID сообщества» вставьте адрес сообщества (например vk.com/club123456) или его числовой ID.
4. Подключите сообществоНажмите «Подключить». Приём сообщений (Callback API, событие message_new) настраивается автоматически — дополнительных действий не нужно.
5. ПроверьтеНапишите сообществу тестовое сообщение — оно появится в «Диалогах».

MAX‑бот

Сообщения вашему боту в мессенджере MAX приходят в Smartbtn, ответы уходят обратно в MAX.

1. Создайте бота на платформе MAX для партнёровВойдите на business.max.ru (или в мини‑приложение «MAX для бизнеса»), создайте и верифицируйте профиль организации, ИП или самозанятого (доступно резидентам РФ), затем в разделе «Чат‑боты» нажмите «Создать».
2. Заполните карточку ботаЗагрузите логотип, укажите название и описание. Никнейм создаётся автоматически (вида idИНН_bot). После создания бот проходит модерацию.
3. Скопируйте токенПосле модерации откройте «Чат‑боты» → ваш бот → ⋮ → «Настройки» и скопируйте токен.
4. Укажите никнейм ботаВ личном кабинете откройте «Каналы» → MAX и введите никнейм бота без @.
5. Вставьте токенВставьте токен в поле «Токен бота».
6. СохранитеНажмите «Сохранить настройки».

WhatsApp Business (Cloud API)

WhatsApp подключается через официальный WhatsApp Business Cloud API от Meta: один номер отвечает в диалогах и отправляет рассылки одобренными шаблонами. Настройка — в разделе «Подключения», около 10 минут.

1. Создайте приложение MetaВ Meta for Developers создайте приложение типа Business (или возьмите существующее) и добавьте продукт WhatsApp.
2. Добавьте номерWhatsApp → API Setup: добавьте свой номер (он не должен быть занят в приложении WhatsApp), подтвердите его кодом и дождитесь одобрения отображаемого имени.
3. Скопируйте идентификаторыСкопируйте Phone number ID и WhatsApp Business Account ID.
4. Создайте бессрочный маркерMeta Business → Настройки → Системные пользователи: создайте администратора, дайте ему приложение и аккаунт WhatsApp, сгенерируйте маркер со сроком «Никогда» и доступами whatsapp_business_messaging и whatsapp_business_management.
5. Сохраните и проверьтеВ личном кабинете откройте «Подключения» → WhatsApp, вставьте данные и нажмите «Сохранить и проверить».
6. Включите входящиеНажмите «Подключить автоматически» и выберите проекты (сайты) для ответов и рассылок.

Кабинеты Avito

Чаты Avito подключаются через кабинеты: каждый кабинет — отдельная авторизация в Avito, кабинетов может быть несколько. Нужна подписка Avito: для Товаров и Работы — «Максимальный», для Услуг — «Расширенный» или «Максимальный».

1. Придумайте имя кабинетаВ разделе «Каналы» → Avito введите имя кабинета (до 50 символов) — по нему вы будете различать кабинеты.
2. Добавьте кабинетНажмите «Добавить кабинет» — откроется страница авторизации Avito.
3. Разрешите доступВойдите в нужный аккаунт Avito, проверьте права на чтение и модифицирование сообщений в мессенджере Авито и нажмите «Авторизовать приложение».
4. Управляйте кабинетамиДобавляйте новые кабинеты или удаляйте ненужные — список находится на той же странице.

ЦИАН

Сообщения из вашего кабинета ЦИАН приходят в Smartbtn.

1. Получите ключ Циан APIНужен тариф «Базовый». В личном кабинете Циан откройте раздел API и нажмите «Получить ключ API».
2. Найдите ключ в почтеЦиан пришлёт ключ (ACCESS KEY) на email аккаунта. Также проверьте, что получение сообщений включено в my.cian.ru/settings/chats.
3. Укажите адрес кабинетаВ разделе «Каналы» → ЦИАН вставьте адрес вашего кабинета ЦИАН.
4. Вставьте ключВставьте ключ в поле «Ключ Циан API (ACCESS KEY)».
5. СохранитеНажмите «Сохранить настройки».

Messenger (Facebook)

Сообщения в Messenger вашей Страницы Facebook приходят в Smartbtn. Messenger разрешает свободные ответы в течение 24 часов после сообщения клиента.

1. Выберите MessengerВ разделе «Каналы» нажмите иконку Messenger.
2. Получите токен СтраницыПолучите долгоживущий токен доступа Страницы по инструкции Meta for Developers.
3. Укажите адрес СтраницыВставьте адрес Страницы Facebook в поле «Адрес Страницы Facebook».
4. Вставьте токенВставьте токен Страницы в поле «Секретный ключ».
5. СохранитеНажмите «Сохранить настройки».

Viber‑бот

Сообщения вашему боту Viber приходят в Smartbtn.

1. Выберите ViberВ разделе «Каналы» нажмите иконку Viber.
2. Получите бота ViberС 5 февраля 2024 года боты Viber создаются только на коммерческих условиях: подайте заявку напрямую в Viber или через его официального партнёра (developers.viber.com). Токен — в Viber: More → Settings → Bots → Edit Info → «Your app key».
3. Укажите URI ботаВставьте URI бота (тот же, что в ссылках viber://pa?chatURI=…) в поле «URI бота».
4. Вставьте токенВставьте токен (Your app key) в поле «Токен бота».
5. СохранитеНажмите «Сохранить настройки».

Группа в Одноклассниках

Сообщения в вашу группу в Одноклассниках приходят в Smartbtn.

1. Получите ключ доступаПолучите ключ доступа группы, как описано в инструкции API Одноклассников.
2. Выберите OKВ разделе «Каналы» нажмите иконку OK.
3. Укажите адрес группыВ настройках группы скопируйте из строки «Прямая ссылка на диалог с группой» часть вида group/58269558636565/messages и вставьте в поле «Адрес группы».
4. Вставьте ключВставьте ключ из шага 1 в поле «Ключ доступа (токен)».
5. СохранитеНажмите «Сохранить настройки». Веб‑хук регистрируется автоматически.
6. ПроверьтеSmartbtn покажет, подтвердили ли Одноклассники приём сообщений. Напишите в группу тестовое сообщение — оно появится в «Диалогах».

AliExpress

Сообщения покупателей AliExpress приходят в Smartbtn.

1. Откройте страницу API‑токеновВойдите в кабинет продавца (seller.aliexpress.ru) и откройте seller.aliexpress.ru/token‑management/active.
2. Создайте токенНажмите «Создать токен», затем нажмите на появившийся токен и скопируйте его.
3. Укажите магазинВ разделе «Каналы» → AliExpress введите адрес или ID магазина.
4. Вставьте токенВставьте токен в поле «API‑токен».
5. СохранитеНажмите «Сохранить настройки».

Apple Messages for Business

Сообщения из Apple Messages for Business (бывший Business Chat) приходят в Smartbtn через провайдера Infobip: прямого доступа Apple бизнесу не даёт.

1. Зарегистрируйтесь в AppleВ Apple Business Register (register.apple.com) зарегистрируйте организацию и создайте аккаунт Messages for Business; провайдером (Messaging Service Provider) выберите Infobip.
2. Свяжите аккаунт с InfobipСвяжите аккаунт со своим аккаунтом Infobip и дождитесь одобрения Apple — статус станет ONLINE.
3. Укажите Base URL InfobipВ разделе «Каналы» → Messages for Business вставьте Base URL вашего аккаунта Infobip (вида xxxxx.api.infobip.com).
4. Укажите Apple Business IDСкопируйте его в Apple Business Register: аккаунт Messages for Business → «Links» → «Copy ID».
5. Вставьте API‑ключ InfobipСоздайте API‑ключ в Infobip (API key management) и вставьте его — ниже появится Callback URL.
6. Укажите Callback URL в InfobipВ Infobip: Channels and Numbers → Channels → Apple Messages for Business → Senders → ⋮ → Edit inbound configurations → Forwarding to HTTP, вставьте Callback URL.
7. СохранитеНажмите «Сохранить настройки».

WordPress, Tilda и другие CMS

Виджет ставится одним кодом установки — он подходит для любого сайта и CMS.

1. Скопируйте код установкиВ личном кабинете откройте раздел «Виджет» и скопируйте код установки.
2. Вставьте на сайтДобавьте код на все страницы перед закрывающим тегом </body>: в WordPress — через тему (footer.php) или любой плагин вставки кода в header/footer; в других CMS — в поле для своего HTML/JS‑кода.
3. ПроверьтеОткройте сайт — появится кнопка; дальнейшие изменения оформления делаются в кабинете без переустановки кода.

База знаний

Поможет, подскажет, научит. Начните вводить — список отфильтруется на лету.

smartbtn_widget_api.setContactInfo({
  name: "Василий Васильев",
  email: "email@example.com",
  phone: "+17584987855",
  description: "Description text"
});

smartbtn_widget_api.setCustomData([
  {
    title: "Actions",
    content: "Add contact",
    link: "https://crm.example.com/contacts/new"
  },
  {
    content: "Open customer profile",
    link: "https://crm.example.com/customers/42"
  }
]);

curl -H "Authorization: Bearer <token>" https://<host>/api/v1/chats

// → { "data": [...], "next_cursor": "..." | null }

• Отдельное окно без адресной строки браузера, со счётчиком непрочитанных в доке и Web Push‑уведомлениями
• Мгновенный доступ ко всем инструментам: мессенджеры, Avito, ИИ‑суфлёр, чат‑бот, обратный звонок, «Как добраться», «Прайс»
• Push‑уведомления о новых сообщениях и заявках на звонок
• Контроль операторов, SLA‑таймеры и статистика — прямо в приложении

Обратная связь

Есть вопрос или предложение? Напишите нам!

Реквизиты

Реквизиты компании для договоров и счетов.

Документы

Условия использования сервиса и обработки персональных данных.