Гайд

Новая Почта в боте Telegram: город, отделение и ТТН

Покупатель выбирает город и отделение из данных Новой Почты прямо в оформлении, а накладная создаётся из заказа. Статус посылки при этом не отслеживается.

AdminHub

Коротко. Покупатель выбирает город и отделение из настоящего справочника Новой Почты прямо в оформлении, а не пишет их текстом в чат. Накладная создаётся из заказа, и номер возвращается в ту же запись, где лежит адрес. Нужен ваш ключ API, и хранится он зашифрованным. Чего нет: отслеживания статуса — за движением посылки мы не следим, номер смотрите в приложении Новой Почты.

Самая долгая часть продажи в Telegram — обычно не деньги, а адрес. «Напишите город и номер отделения» превращается в три сообщения, опечатку в номере и вашу переписку с самим собой в кабинете перевозчика.

Что видит покупатель

Он начинает вводить город — и получает подсказки из справочника Новой Почты. Выбирает свой. Дальше видит список отделений и почтоматов именно этого города и тыкает нужное.

Ничего из этого он не набирает текстом, и именно поэтому «25е» не приедет как «25а». Данные берутся у перевозчика, а не из памяти покупателя.

Что делаете вы

Ничего до момента отправки. Когда заказ оплачен, накладная создаётся из него же, и номер ТТН возвращается в ту самую запись, где уже есть имя, город и отделение.

Это убирает шаг, на котором теряется больше всего: перенос адреса из чата в кабинет перевозчика руками. Там он и портится — не потому что кто-то невнимателен, а потому что переписка не форма.

Чего нет, прямым текстом

Статуса посылки. Мы создаём накладную и отдаём номер, но за движением не следим: в заказе не появится «прибыла в отделение». Смотреть — в приложении Новой Почты по номеру.

Других перевозчиков в таком виде. Отдельные адаптеры есть у Новой Почты и RajaOngkir; для остальных работает общий путь, где стоимость и сроки задаёте вы.

Работы без ключа. Нужен ваш собственный ключ API Новой Почты. Без него магазин работает, но доставка оформляется руками, как у любого другого перевозчика.

Про ключ

Ключ хранится зашифрованным, а не текстом в базе. Знать это стоит, потому что ключ API перевозчика — это доступ к созданию накладных от вашего имени, и обращаться с ним надо как с паролем.

Если… то…

Если…То…
Вы спрашиваете адрес в перепискеИменно это и убирается — подсказки вместо текста
Вы перебиваете данные в кабинетТТН создаётся из заказа
Вам нужен статус посылкиНе здесь — приложение Новой Почты по номеру
Вы возите другим перевозчикомОбщий путь: стоимость и сроки задаёте сами
Ключа API ещё нетМагазин работает, доставка руками

С чего начать

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

Дальше возьмите ключ в кабинете Новой Почты и впишите его в настройках. После этого проверьте на собственном тестовом заказе: пройдите оформление как покупатель и посмотрите, подсказался ли ваш город.


Где живут заказы и накладная — заказы в магазине Telegram. Магазин в целом — страница магазина. Как продавать в Telegram — руководство.

Что обычно спрашивают

Покупатель вводит адрес вручную?
Нет. Город подсказывается из справочника Новой Почты, а после выбора города показывается список его отделений и почтоматов. То есть «Днепр, 25е отделение» не набирается текстом и не приезжает с опечаткой.
Накладную надо создавать в кабинете?
Нет, ТТН создаётся прямо из заказа, и номер возвращается туда же, где уже лежит адрес покупателя. Перебивать данные в кабинет не нужно.
Вижу ли я статус посылки в заказе?
Нет, и это честная граница. Мы создаём накладную и отдаём номер, но за движением посылки не следим. Статус смотрите в приложении Новой Почты по этому номеру.
Что нужно, чтобы это заработало?
Ваш собственный ключ API Новой Почты. Хранится он в зашифрованном виде, а не текстом.
Это работает для других стран?
Нет. Новая Почта украинская, и адаптер под неё отдельный. Для остальных перевозчиков есть общий путь, где стоимость и сроки вы указываете сами.
А если ключа нет?
Магазин будет работать, но без подсказок города и отделения и без ТТН: доставку придётся оформлять как у всех прочих перевозчиков — руками.