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

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

Квесча поддерживает 6 мессенджеров и каналов: Telegram, MAX, VK, Viber, WhatsApp, Jivo. Можно подключить несколько одновременно в одной цепочке — клиент пишет в любом канале, бот отвечает там же.

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

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

Скриншот 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. Подключение нескольких мессенджеров

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

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

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

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

• telegram, tg — Telegram;
• max — MAX;
• vk — VK;
• viber, vb — Viber;
• wa, whatsapp — WhatsApp;
• jivo — Jivo;
• lp — Лендинг.

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

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

---

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

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

---

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

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

---

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

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

---

Что дальше

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