Telegram-бот KIVVI позволяет управлять отправлениями, отслеживать посылки и выполнять другие действия прямо в Telegram. В этой инструкции собраны все доступные функции и команды.
Регистрация в Telegram-боте
Войди в аккаунт KIVVI. Если Telegram-бот ещё не подключён, найди карточку «Telegram» и нажми «Зарегистрироваться в Telegram». Карточка будет отображаться до завершения регистрации.
После этого ты перейдёшь в Telegram-бот. Чтобы начать, введи или выбери команду /start.
В приветственном сообщении будут перечислены доступные возможности бота.
Уведомления в Telegram
Бот автоматически отправляет уведомления о действиях с посылками и изменениях их статуса.
Действия с посылками
| Событие | Уведомление |
|---|---|
| Ожидаемая посылка добавлена | «Ожидаем твою посылку. Трек-номер: [трек-номер]» |
| Новая посылка получена | «Получили твою посылку. Трек-номер: [трек-номер]. Скоро обработаем её». |
| Посылка обработана | «Посылка [трек-номер] обработана. Содержимое: [название товара], количество: [количество]». |
| Отправлено | Твои посылки отправлены со склада и уже в пути. Номер: [номер]. |
| Посылка готова к получению | «[QR-код] Посылка [трек-номер] передана службе доставки и готова к получению в пункте выдачи в городе [город] по адресу: [адрес]. Если появятся вопросы, позвони по номеру [телефон]. Покажи этот QR-код в пункте выдачи. Он содержит данные посылки и будет отсканирован для подтверждения получения». |
Подтверждение складских операций
Уведомления отправляются после подтверждения соответствующей складской операции.
| Cкладские операции | Уведомление |
|---|---|
| Приёмка | «Посылка [трек-номер] поступила на склад KIVVI в городе [город], [страна]. Мы сообщим, когда она будет готова к дальнейшей доставке или получению». |
| Отправка | «Посылка [трек-номер] направляется в следующий пункт обработки для подготовки к международной перевозке». |
| Подтверждение по PIN-коду в пункте выдачи | «Посылка [трек-номер] передана службе доставки [название службы]. Новый трек-номер: [трек-номер службы доставки]. Используй его для дальнейшего отслеживания». |
Проверка статуса посылки, команда /status
После запроса статуса с помощью команды /status бот отправит информацию о посылке.
| Статус посылки | Уведомление |
|---|---|
| Посылка поступила на склад | Трек-номер: [трек-номер] Статус: поступила на склад |
| Посылка обработана | Трек-номер: [трек-номер] Статус: обработана Вес: [вес] Номер объединённой посылки: [номер] |
Интерактивные кнопки:
| Кнопка | Действие |
|---|---|
| Содержимое | Показывает названия товаров и их количество. |
| Общая посылка | Появляется, если несколько посылок объединили для доставки. Показывает трек-номер, статус и список посылок в её составе. |
| Вложенная посылка | Позволяет открыть отдельную посылку из объединения и посмотреть находящиеся в ней товары и их количество. |
Note: Информация об общей посылке отображается только в том случае, если посылка входит в состав другой посылки и пользователю разрешён доступ к этим данным. Для отправленных посылок отображается статус «Отправлена».
Данные профиля, команда /profile
После ввода команды /profile бот покажет следующую информацию:
| Раздел | Описание |
|---|---|
| Профиль пользователя | Данные аккаунта. |
| Адрес доставки | Текущий адрес доставки |
| URL пункта Boxberry | Адрес и ссылку на выбранный пункт выдачи Boxberry, если он указан в настройках доставки. |
| /delivery_methods | Позволяет выбрать или изменить способ доставки. |
| Кнопка US Address | Показывает адрес склада KIVVI в США. |
Примечание: Пожалуйста, обратитесь к файлу Configuration readme для получения дополнительной информации.
Действия по командам Telegram
Добавить ожидаемую посылку с помощью команды /declare
Используй команду /declare, чтобы указать трек-номер посылки, которая должна поступить на склад KIVVI.
| Шаг | Ответ бота |
|---|---|
| 1. Ввод трек-номера | «Введи трек-номер посылки». |
| 2. Неверный формат | «Неверный формат трек-номера. Введи корректный номер. Допустимы латинские буквы A–Z, a–z и цифры 0–9». |
| 3. Подтверждение | «Нажми “Да”, чтобы подтвердить». |
| 4. Посылка успешно добавлена | «Ожидаем новую посылку. Трек-номер: [трек-номер].” |
Обращение в поддержку, команда /support
Используй команду /support, чтобы создать обращение в службу поддержки.
Смена получателя
После подтверждения смены получателя с помощью кнопки «Да» в системе автоматически создаётся обращение в службу поддержки.
| Шаг | Ответ бота |
|---|---|
| 1. Ввод номера посылки | «Введите номер вашей посылки:» |
| 2. Посылка не найдена | «Посылка [номер] не найдена. Проверь указанный номер». |
| 3.Посылка зарегистрирована другому получателю | «Посылка [номер] зарегистрирована на другого получателя». |
| 4. Посылка содержит дочерние посылки | «Получателя нельзя изменить, поскольку эта посылка содержит другие посылки». |
| 5. Посылка уже упакована | «Получателя нельзя изменить. Посылка [номер] уже упакована и готова к отправке». |
| 6. Посылка уже отправлена | «Получателя нельзя изменить, поскольку посылка уже отправлена». |
| 7. Действительная посылка | «Введи личный номер KIVVI нового получателя.». |
| 8. Получатель найден | «Подтверди, что хочешь назначить [имя] получателем посылки [номер]». |
| 9. Кнопки подтверждения | Да / Нет |
Note: В целях конфиденциальности в уведомлении отображаются только имя и первая буква фамилии получателя.
Уведомления о статусе обращения
Бот автоматически уведомляет пользователя при изменении статуса обращения.
| Событие | Уведомление |
|---|---|
| Изменение статуса запроса | «Статус запроса на изменение получателя обновлён. Номер запроса: [номер запроса] Посылка: [номер посылки] Новый статус: [статус]». |
Команды Telegram-бота
| Команда | Описание |
|---|---|
| /start <access_token> | Регистрирует пользователя в Telegram-боте. |
| /status | Проверяет статус посылки по её номеру или трек-номеру. Показывает информацию о посылке и интерактивные кнопки «Содержимое», «Отправление» и «Общая посылка». |
| /declare | Добавляет ожидаемую посылку. |
| /support | Создаёт обращение в службу поддержки. Среди доступных действий есть «Сменить получателя». |
| /profile | Показывает данные профиля. Также содержит кнопку «Адрес доставки», через которую можно открыть адрес склада KIVVI в США. |
| /delivery_methods | Позволяет выбрать способ доставки: доставку по адресу или получение в пункте Boxberry. |
| /cancel | Отменяет текущее действие. |
Поддержка
Если появятся вопросы о функциях Telegram-бота, наша служба поддержки всегда готова помочь.