Craft PodiumУ компании есть канал в Telegram, посты в него уходят по расписанию, и всё работает. Потом появляется канал в МАКС. Те же посты туда носят руками: копируют текст, перекладывают картинки, забывают. На прошлой неделе мы подключали МАКС к SMM-платформе заказчика, чтобы посты кампании уходили в оба канала одновременно. Ниже рассказываем, что для этого нужно со стороны компании, как выглядит подключение по шагам и на чём оно ломается чаще всего.
Для кого это
Для тех, у кого посты уже готовятся централизованно: в SMM-сервисе, в своей платформе или хотя бы в общей таблице с датами. Если канал в МАКС ведётся отдельно и от руки, бот ничего не ускорит. Если же контент один и тот же и его просто нужно доставить ещё в одно место, подключение окупает себя сразу: исчезает ручное копирование и расхождения между каналами.
Отдельно это важно компаниям, которые завели канал в МАКС «потому что надо», а наполнять его некому. Автопубликация решает именно эту проблему: канал живёт тем же контентом, что и Telegram, без второй смены для сотрудника.
Что подготовить со стороны компании
Самое важное в этом списке первое, и его нельзя обойти.
Проверенная организация в МАКС. Бот для публикаций создаётся на платформе МАКС для партнёров, и создать его может только организация, прошедшая проверку: юрлицо или ИП. Без прохождения этой проверки токен бота получить нельзя, а без токена не будет и публикации. Поэтому проверку стоит запускать раньше всего остального: разработка может идти параллельно, а вот запуск без неё невозможен.
Доступ к каналу. Бота нужно будет добавить в канал администратором с правом публикации. Сделать это может только человек, который управляет каналом со стороны компании. Ему стоит заранее объяснить, зачем бот и что он будет публиковать. Одной фразы хватит.
Тестовый канал. Отдельный закрытый канал, в который можно публиковать что угодно. Первые посты уходят туда, и только после проверки бот подключается к боевым каналам. Завести его недолго. А сэкономит он нервы всем, кто участвует в запуске: ошибку с адресом, номером канала или правами бота лучше увидеть на посте, который никто, кроме вас, не прочитает.
Понимание, что именно публиковать. В нашем случае сценарий был простой: те же посты кампании, которые уходят в Telegram, параллельно уходят в МАКС. Если у вас для МАКС нужен другой текст или другой график, это стоит проговорить до начала работ.
Подключение по шагам
1. Создать бота. На платформе МАКС для партнёров от имени проверенной организации создаётся бот и выдаётся его токен. Токен хранится на стороне сервиса, который будет публиковать, и никуда больше не передаётся. 2. Добавить бота в канал. Администратор канала добавляет бота с правом публикации. Сначала в тестовый канал. 3. Указать адрес API. Публикация идёт через официальный адрес API МАКС для ботов: platform-api.max.ru. Это стоит зафиксировать в настройках явно, почему именно этот адрес, расскажем в ошибках ниже. 4. Указать номер канала. Для API номер канала пишется со знаком минус в начале. Именно в таком виде его и нужно сохранить в настройках. 5. Опубликовать тестовый пост. Текст, картинка, ссылка, всё, что будет в реальных постах. Открыть канал и посмотреть, как пост выглядит в самом МАКС. Логи сервиса этого не покажут. 6. Подключить боевые каналы. Те же настройки, другой номер канала. После первой реальной публикации проверить ещё раз.
Три ошибки, на которых ломается публикация
Не тот адрес API. У МАКС есть официальный адрес для ботов, platform-api.max.ru. Если указать другой, на нём стоит сертификат, которому серверы по умолчанию не доверяют. Запрос с сервера просто не проходит. Снаружи это выглядит как «ничего не работает», без внятного объяснения, и люди начинают искать причину в коде, в токене, в правах бота. Адрес стоит проверить первым делом.
Номер канала без минуса. Для API номер канала начинается со знака минус. Если его потерять при копировании, МАКС отвечает ошибкой формата, а человек на стороне сервиса видит только «не удалось опубликовать» и не понимает, что делать. Мы столкнулись с этим на подключении и сделали так, чтобы сервис в этом случае показывал понятную ошибку с подсказкой, что именно исправить. Такую проверку стоит просить у любого подрядчика: ошибка должна называть причину, а не констатировать факт.
Бот есть, прав нет. Бота добавили в канал, но не администратором, или администратором без права публикации. Со стороны сервиса всё настроено верно. Посты не уходят. Поэтому в чек-лист стоит включить не «бот добавлен», а «бот добавлен администратором с правом публикации», и проверять это на тестовом канале до боевого.
Сколько это занимает и чем поможем
Самая долгая часть не на нашей стороне: проверка организации в МАКС. Пока она не пройдена, токен не выдать, а значит, запуск невозможен, сколько бы ни было готово в коде. Поэтому первое, что мы спрашиваем на старте: есть ли у компании проверенный статус на платформе МАКС для партнёров. Если нет, начинаем с него, а подключение готовим параллельно.
Сама интеграция при готовом токене и настроенном канале сводится к шагам выше: адрес, номер канала, тестовый пост, боевые каналы. Если посты уже уходят в Telegram через автопостинг, МАКС добавляется к нему как ещё один канал доставки: без отдельной системы, без второго расписания и без человека, который по вечерам переносит посты из одного приложения в другое.
Если хотите, чтобы ваш канал в МАКС жил тем же контентом, что и Telegram, напишите нам. Разберём, что у вас уже есть, и скажем, с чего начать.