Гайд

Нова Пошта в боті Telegram: місто, відділення і ТТН

Покупець обирає місто й відділення з даних Нової Пошти просто в оформленні, а накладна створюється із замовлення. Статус посилки при цьому не відстежується.

AdminHub

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

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

Що бачить покупець

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

Нічого з цього він не набирає текстом, і саме тому «25е» не приїде як «25а». Дані беруться в перевізника, а не з пам’яті покупця.

Що робите ви

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

Це прибирає крок, на якому втрачається найбільше: перенесення адреси з чату в кабінет перевізника руками. Там вона й псується — не тому, що хтось неуважний, а тому що переписка не форма.

Чого немає, прямим текстом

Статусу посилки. Ми створюємо накладну й віддаємо номер, але за рухом не стежимо: у замовленні не з’явиться «прибула у відділення». Дивитися — в застосунку Нової Пошти за номером.

Інших перевізників у такому вигляді. Окремі адаптери є в Нової Пошти та RajaOngkir; для решти працює спільний шлях, де вартість і терміни ви задаєте самі.

Роботи без ключа. Потрібен ваш власний ключ API Нової Пошти. Без нього магазин працює, але доставка оформлюється руками, як у будь-якого іншого перевізника.

Про ключ

Ключ зберігається зашифрованим, а не текстом у базі. Це варто знати, бо ключ API перевізника — це доступ до створення накладних від вашого імені, і поводитися з ним треба як з паролем.

Якщо… то…

Якщо…То…
Ви питаєте адресу в переписціСаме це й прибирається — підказки замість тексту
Ви перебиваєте дані в кабінетТТН створюється із замовлення
Вам потрібен статус посилкиНе тут — застосунок Нової Пошти за номером
Ви возите іншим перевізникомСпільний шлях: вартість і терміни задаєте самі
Ключа API ще немаєМагазин працює, доставка руками

З чого почати

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

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


Де живуть замовлення й накладна — замовлення в магазині Telegram. Магазин загалом — сторінка магазину. Як продавати в Telegram — керівництво.

Що зазвичай запитують

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