В APX можно принимать обращения через Telegram, MAX и сообщения сообщества VK, но способ подключения определяет, от чьего имени отвечает команда. Токен бота, авторизация личного аккаунта и разрешение на работу с сообществом — разные маршруты. Выбирать нужно сначала адрес, который увидит клиент, и только потом заполнять форму подключения.
Проверьте это до публикации контактов на сайте. Если клиенту обещан разговор с личным аккаунтом менеджера, ссылка на нового бота изменит привычный путь. Если поддержка должна выступать от имени сообщества, подключение личного профиля не заменяет сообщения группы.
Telegram: бот по токену или аккаунт по QR-коду
Для бота откройте «Управление → Каналы связи», добавьте канал и выберите Telegram BOT. Нужен токен, полученный у BotFather; APX использует его для подключения бота. Задайте название и сотрудников канала, завершите создание и отправьте боту тестовое сообщение с другого аккаунта. Подробная последовательность есть в инструкции подключения Telegram-бота.
Для обычного личного диалога с ботом попросите пользователя сначала открыть бота и нажать «Начать» или написать сообщение. Бот не может сам начать такую переписку с произвольным человеком. Добавление бота в группу — отдельный сценарий: оно не открывает личную переписку со всеми участниками. Разместите ссылку на бота и понятное предложение начать разговор. Это правило описано в официальном руководстве Telegram.
Для личного аккаунта выберите «Telegram (личный)». В мастере используется QR-код: на телефоне откройте «Настройки → Устройства → Подключить устройство». Если включён облачный пароль, авторизация потребует дополнительного подтверждения. Это сеанс вашего аккаунта; не завершайте его на телефоне, если канал должен продолжать работать.
Личный маршрут позволяет работать от имени аккаунта, но не делает переписку неограниченной. Возможность написать конкретному адресату зависит от доступности контакта и правил платформы. Старая история до подключения Telegram PERSONAL не импортируется автоматически — ориентируйтесь на новые сообщения и описание личного подключения.
MAX: два разных варианта в мастере каналов
Для бота выберите MAX Messenger и введите токен бота. В форме APX есть переход на платформу партнёров MAX для получения данных подключения. Официальный API MAX описывает работу именно ботов: нельзя переносить его возможности и правила на личный аккаунт только из-за общего названия мессенджера.
Для аккаунта в полном мастере каналов предусмотрен отдельный вариант «MAX (личный)». Он открывает авторизацию с QR-кодом или номером телефона и кодом подтверждения; при запросе аккаунта потребуется дополнительный пароль. Это отдельная ветка подключения, поэтому вставлять токен бота в неё не нужно. Краткое окно быстрого добавления может показывать меньше типов, чем полная страница каналов.
После авторизации проверьте не только появление названия аккаунта, но и сообщение в обе стороны. Для бота проведите проверку из начатого пользователем диалога. Наличие идентификатора клиента само по себе не доказывает право отправить ему сообщение. В документации отправки MAX отдельно описаны адресат и ошибки запроса; успешное подключение не отменяет этих проверок.
VK: подключается сообщество
В APX выберите «VK сообщество». Откроется авторизация VK: войдите аккаунтом, который управляет нужным сообществом, разрешите доступ и выберите группу из полученного списка. Сообщения сообщества должны быть включены. Далее задайте сотрудников, которые будут обрабатывать обращения. Маршрут описан в инструкции подключения VK.
Этот канал не подключает личную переписку пользователя VK. Ответ приходит от сообщества, а не от сотрудника, прошедшего авторизацию. Если нужной группы нет, проверяйте выбранный аккаунт и его права, а не создавайте наугад ещё один канал.
Разрешение получать сообщения от сообщества — отдельное условие. В официальной схеме API VK для его проверки есть метод messages.isMessagesFromGroupAllowed. Поэтому подписку на сообщество и доступность личной переписки с ним не следует считать одним действием. Для приёмки используйте обычного участника, который действительно открыл сообщения группы.
Вложения проверяют по направлению и типу
Успешная отправка фотографии не подтверждает работу документа, голосового сообщения или видео. Подготовьте небольшой учебный набор: текст, изображение и тот формат файла, который реально нужен вашей поддержке. Отправьте каждый из мессенджера в APX, откройте вложение у оператора, затем проверьте обратное направление.
Фиксируйте, что именно получилось: файл открылся, сохранилось имя, видна подпись, понятна ошибка неподдерживаемого действия. Не обещайте клиентам единый численный лимит для всех каналов. Ограничения платформы, тип аккаунта и текущая поддержка формата в APX могут различаться; большая фотография и документ с теми же байтами проходят разные пути обработки.
Редактирование, удаление, реакции и статусы тоже проверяйте отдельно. В Telegram PERSONAL интерфейс APX ориентируется на возможности, подтверждённые сервером для конкретного диалога. Отсутствие кнопки нельзя исправить выдачей сотруднику лишних прав, если действие не поддерживает сам канал.
Имя профиля ещё не подтверждает владельца заказа
В мессенджере вы получаете идентификатор собеседника и доступные данные профиля. Это помогает продолжать тот же разговор, но не доказывает, что человек владеет заказом с названным номером. Совпадение имени, аватара или подписи не должно становиться основанием для изменения контактных данных заказа.
Попросите минимальные сведения, необходимые для вашей процедуры проверки, и объясните их назначение. Для обычного вопроса о режиме работы проверка личности не нужна. Для изменения доставки используйте установленный компанией способ подтверждения, а не просьбу прислать лишние документы прямо в чат.
Итог подключения — проверенный маршрут: клиент нашёл правильный адрес, начал диалог, оператор увидел обращение и отправил ответ, нужное вложение открылось с обеих сторон. Сохраните название типа канала и результат этой проверки. Тогда при сбое будет понятно, какой именно маршрут работал, вместо общего «MAX подключён» или «Telegram не отвечает».
