Подключение бота

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

Квесча поддерживает множество каналов: мессенджеры (Telegram, MAX, WhatsApp, WhatsApp Business, VK, Viber, Instagram), доски объявлений (Avito, Циан), маркетплейсы (Wildberries, Ozon), соцсети (TikTok), а также сайт (бот-лендинг/виджет, Jivo). Можно подключить несколько одновременно в одной цепочке — клиент пишет в любом канале, бот отвечает там же.

Возможности и применение каналов

Что собой представляет каждая платформа и для каких задач подходит — в статье Каналы и платформы.

Платформы Meta в РФ

Instagram, WhatsApp, WhatsApp Business и Facebook принадлежат компании Meta Platforms, Inc.; деятельность организации признана в РФ экстремистской и запрещена.

Где подключать

Боты → выбрать мессенджер → вставить токен по инструкции.

Скриншот 1. Список подключённых каналов в проекте.

---

Часть 1. Telegram

Самый популярный и простой для подключения мессенджер.

Шаг 1. Создайте бота в Telegram

1. Откройте Telegram → найдите @BotFather.
2. Отправьте команду /newbot.
3. Введите имя бота (например, Мой Магазин Бот).
4. Введите username — должен заканчиваться на bot (например, my_shop_bot).
5. BotFather пришлёт токен вида 123456789:ABCdefGHI....

Шаг 2. Подключите в Квесче

1. Боты → Telegram.
2. Вставьте токен.
3. Нажмите «Подключить».

Скриншот 2. Поле для токена Telegram.

Что дальше

• Подключите WebApp через @BotFather → Bot Settings → Menu Button.
• Настройте описание, аватарку, команды (через того же BotFather).
• Дайте боту права админа в группах/каналах, если они будут использоваться.

---

Часть 2. MAX

Российский мессенджер с быстрой интеграцией.

Шаг 1. Получите токен в MAX

1. Откройте бота MAX «MasterBot» или раздел разработчиков в приложении.
2. Создайте бота — получите токен.

Шаг 2. Подключите в Квесче

1. Боты → MAX.
2. Вставьте токен.
3. «Подключить».

После подключения добавьте бот в конструктор — он появится в списке.

Скриншот 3. Подключение бота МАКС.

---

Часть 3. VK (ВКонтакте)

Через сообщества VK.

Шаг 1. Создайте сообщество

В VK создайте новое сообщество (или используйте существующее). Бот будет работать от имени сообщества.

Шаг 2. Авторизуйте Квесчу

1. Боты → VK.
2. Откроется окно авторизации VK.
3. Войдите в свой аккаунт VK с правами админа сообщества.
4. Дайте Квесче доступ к управлению сообщениями сообщества.
5. Выберите нужное сообщество из списка.

Скриншот 4. Авторизация и выбор сообщества VK.

---

Часть 4. Viber

Шаг 1. Создайте Viber-бота

1. Зарегистрируйтесь на Viber Admin Panel.
2. Создайте паблик-аккаунт → получите токен.

Шаг 2. Подключите в Квесче

1. Боты → Viber.
2. Вставьте токен.
3. «Подключить».

После подключения Квесча автоматически выставит вебхук в Viber для приёма сообщений.

---

Часть 5. WhatsApp

Используется официальное WhatsApp Business API (не приватный аккаунт).

Шаг 1. Зарегистрируйте аккаунт green-api.com

1. Зарегистрируйтесь.
2. Добавьте инстанс, авторизуйте номер WhatsApp.

Шаг 2. Подключите в Квесче

В Боты → WhatsApp введите:

• Номер телефона;
• ID инстанса;
• Токен инстанса;
• Ссылка на хост API;
• Ссылка на хост API для файлов;

Нажмите «Подключить».

Риски блокировки

Платформа Квесча не несёт ответственности за блокировку номера WhatsApp.

---

Часть 6. Jivo

Подключение бота к Jivo Bot API — для интеграции с live-чатом Jivo.

Шаг 1. Настройка вебхука в Jivo

В личном кабинете Jivo создайте Bot API → получите вебхук-адрес или укажите свой.

Шаг 2. Подключите в Квесче

В Боты → Jivo вставьте полученный вебхук → «Подключить».

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

---

Часть 7. Новые каналы: маркетплейсы, доски объявлений, соцсети

Подключаются на той же странице Боты. Что умеет каждый канал и для чего нужен — в статье Каналы и платформы.

WhatsApp Business (официальный, Meta Cloud API)

В Meta for Developers создайте приложение с продуктом WhatsApp, возьмите Phone Number ID и постоянный токен. В Боты → WhatsApp Business вставьте их; для приёма сообщений укажите в Meta показанные Callback URL и Verify token (подпишитесь на поле messages). Опционально — App Secret (проверка подписи вебхука) и резервный шаблон для отправки вне 24-часового окна.

Instagram

Нужен бизнес/авторский аккаунт. В Meta for Developers получите долгоживущий токен Instagram, вставьте в Боты → Instagram; вебхук настраивается как у WhatsApp Business (поле messages).

Avito

Нужен бизнес-аккаунт Avito с доступом к API. В Боты → Avito укажите Client ID и Client Secret — токен и вебхук подключатся автоматически. Бот отвечает на входящие сообщения по объявлениям.

Циан

Для агентств недвижимости с доступом к API Циан. В Боты → Циан вставьте ключ авторизации и пропишите показанный адрес вебхука в кабинете Циан.

Wildberries

В кабинете продавца WB (Настройки → Доступ к API) создайте токен категории «Вопросы и отзывы» (и при необходимости отдельный токен «Чат с покупателями»). Вставьте в Боты → Wildberries. Новые вопросы, отзывы и сообщения забираются автоматически по расписанию.

Ozon

В Ozon Seller (Настройки → API-ключи) создайте ключ (для чата обычно нужен Premium Plus). В Боты → Ozon укажите Client-Id и Api-Key; для мгновенных ответов пропишите push-адрес в настройках уведомлений Ozon.

TikTok

Нужен бизнес-аккаунт и доступ к TikTok Business Messaging API (бета, зависит от региона). В Боты → TikTok вставьте Access Token и пропишите вебхук в TikTok for Business.

---

Часть 8. Подключение нескольких мессенджеров

Один проект в Квесче может содержать множество подключённых каналов. Это значит:

• Один сценарий работает сразу в Telegram + MAX + VK;
• Подписчик пишет в любой канал — бот отвечает в том же;
• Аналитика и списки общие.

Как разделять логику по каналам

Используйте шаблон замен [Messenger] — он возвращает идентификатор канала:

• telegram, tg — Telegram;
• max — MAX;
• vk — VK;
• viber, vb — Viber;
• wa, whatsapp — WhatsApp;
• wabusiness — WhatsApp Business;
• instagram — Instagram;
• avito — Avito;
• cian — Циан;
• wb — Wildberries;
• ozon — Ozon;
• tiktok — TikTok;
• jivo — Jivo;
• lp — Лендинг.

В блоке-условии: [Messenger] = telegram, [Messenger] = max.

Скриншот 5. Ветвление по типу мессенджера.

---

Часть 9. Сравнение мессенджеров

Мессенджер	Аудитория	WebApp	Бан-риски	Сложность setup
Telegram	Огромная глобально	✓ полный	Низкие	Простая (BotFather)
MAX	Растущая в РФ	✓	Низкие	Простая
VK	Большая в РФ/СНГ	✗	Низкие	Средняя (сообщество)
Viber	Бизнес-аудитория	✗	Низкие	Средняя
WhatsApp	Огромная глобально	✗	Высокие (Meta)	Сложная (BusinessAPI)
Jivo	Через сайт	✗	Через Jivo	Простая

---

Часть 10. Что делать после подключения

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

---

Частые ошибки

• Webhook failed — токен неверный или просрочен. Перевыпустите.
• Telegram бот не отвечает — другой сервис уже подключён к этому токену (вебхук). Отключите старый или сгенерируйте новый токен. Обновите токен в конструкторе.
• VK сообщения не приходят — не выданы права на управление сообщениями сообщества при авторизации.
• WhatsApp заблокирован — нарушили правила Meta (массовая рассылка без opt-in). Используйте Business API, не приватный аккаунт.
• MAX токен не работает — перевыпустите токен и обновите в конструкторе.

---

Что дальше

• Проекты — контейнер логики бота.
• Архитектура бота — как устроена логика в Квесче.
• Цепочки — первая цепочка приветствия.
• Сценарии — конструктор диалога на доске.
• Группы и каналы Telegram / МАКС — публикации в каналы.