Telegram-бот KIVVI позволяет управлять отправлениями, отслеживать посылки и выполнять другие действия прямо в Telegram. В этой инструкции собраны все доступные функции и команды.
Регистрация в Telegram-боте
Войди в аккаунт KIVVI. Если Telegram-бот ещё не подключён, найди карточку «Telegram» и нажми «Зарегистрироваться в Telegram». Карточка будет отображаться до завершения регистрации.
После этого ты перейдёшь в Telegram-бот. Чтобы начать, введи или выбери команду /start.
В приветственном сообщении будут перечислены доступные возможности бота.
Уведомления в Telegram
Бот автоматически отправляет уведомления о действиях с посылками и изменениях их статуса.
Действия с посылками
| Событие | Уведомление |
|---|---|
| Ожидаемая посылка добавлена | «Мы ожидаем новую посылку для вас. Трек-номер: %(reference name)s.» |
| Новая посылка получена | «Мы получили новую посылку для вас. Трек-номер: %(package)s. Она будет обработана в ближайшее время.» |
| Посылка обработана | «Ваша посылка %(package)s обработана. Содержимое посылки: %(item)s: %(quantity)s» |
| Отправлено | «Отправление %(shipment name)s, содержащее ваши посылки, было отправлено.» |
| Посылка готова к получению | «{QR код} Ваши посылки %(package)s теперь находятся у нашего партнёра по доставке и готовы к получению в нашем офисе в %(warehouse.partner.city)s, адрес: %(warehouse.partner.address)s. Для получения дополнительной информации свяжитесь с нами по телефону %(warehouse.partner.phone)s. Пожалуйста, предъявите этот QR-код в пункте выдачи. QR-код содержит информацию о вашей посылке и будет отсканирован для подтверждения получения.» |
Подтверждение складских операций
Уведомления отправляются после подтверждения соответствующей складской операции.
| Cкладские операции | Уведомление |
|---|---|
| Приёмка | «Ваши посылки %(package)s прибыли на наш склад в %(warehouse.partner.city)s, %(country)s. Пожалуйста, ожидайте дальнейших обновлений, когда ваша посылка будет готова к доставке или получению.» |
| Отправка | «Ваши посылки %(package)s направляются в следующий пункт назначения. Они готовятся к международной пересылке.» |
| Подтверждение по PIN-коду в пункте выдачи | «Код подтверждения PIN %(4_digits_pin)s» |
Проверка статуса посылки, команда /status
После запроса статуса с помощью команды /status бот отправит информацию о посылке.
| Статус посылки | Уведомление |
|---|---|
| Посылка поступила на склад | «Трек-номер: %(package)s Статус: Получена» |
| Посылка обработана | «Трек-номер: %(package)s Статус: Обработана или Отправлена Вес: %(weight)s Родительская посылка: %(parent package)s» |
Интерактивные кнопки:
| Кнопка | Действие |
|---|---|
| Содержимое | Отображает: «%(item)s: %(quantity)s» |
| Родительская посылка | Отображает: «Трек-номер: %(package)s Статус: Получена Дочерние посылки: %(package)s» |
| Дочерняя посылка | Отображает: «%(item)s: %(quantity)s» |
Note: Информация о родительской посылке отображается только в том случае, если в ее состав входят другие посылки и пользователю разрешён доступ к этим данным. Для отправленных посылок отображается статус «Отправлена». .
Данные профиля, команда /profile
После ввода команды /profile бот покажет следующую информацию:
| Раздел | Описание |
|---|---|
| Профиль пользователя | Данные аккаунта. |
| Адрес доставки | Ваш текущий адрес доставки: %(delivery_address)s |
| URL пункта Boxberry | Ваш пункт выдачи Boxberry: %(boxberry_point_url)s |
| /delivery_methods | Опция для установки или изменения способа доставки (если не установлен). |
| Кнопка US Address | Отображает ваш базовый адрес для пересылки при нажатии. |
Примечание: Пожалуйста, обратитесь к файлу Configuration readme для получения дополнительной информации.
Действия по командам Telegram
Add an Awaited Package with /declare
Используй команду /declare, чтобы указать трек-номер посылки, которая должна поступить на склад KIVVI.
| Шаг | Ответ бота |
|---|---|
| 1. Ввод трек-номера | «Введите референс отправления:» |
| 2. Неверный формат | «Неверный формат референса отправления. Пожалуйста, введите корректный референс. Референс должен содержать A-Z a-z 0-9» |
| 3. Подтверждение | «Нажмите «Да» для подтверждения» |
| 4. Посылка успешно добавлена | «Мы ожидаем новую посылку для вас. Трек-номер: %(reference name)s.» |
Обращение в поддержку, команда /support
Используй команду /support, чтобы создать обращение в службу поддержки.
Смена получателя
После подтверждения смены получателя с помощью кнопки «Да» в системе автоматически создаётся обращение в службу поддержки.
| Шаг | Ответ бота |
|---|---|
| 1. Ввод номера посылки | «Введите номер вашей посылки:» |
| 2. Посылка не найдена | «Извините, посылка %(package)s не найдена. Пожалуйста, проверьте референс» |
| 3.Посылка зарегистрирована другому получателю | «Извините, посылка %(package)s принадлежит другому получателю» |
| 4. Посылка содержит дочерние посылки | «Извините, посылка содержит другие посылки, смена получателя невозможна» |
| 5. Посылка уже упакована | «Извините, мы не можем изменить получателя. Ваша посылка %(package)s уже упакована и готова к отправке» |
| 6. Посылка уже отправлена | «Извините, посылка уже отправлена» |
| 7. Действительная посылка | «Введите референс целевого получателя:» |
| 8. Получатель найден | «Подтвердите, что вы хотите назначить %(partner.name)s получателем для %(reference name)s» |
| 9. Кнопки подтверждения | "Yes" / "No" |
Note: В целях конфиденциальности в уведомлении отображаются только имя и первая буква фамилии получателя.
Уведомления о статусе обращения
Бот автоматически уведомляет пользователя при изменении статуса обращения.
| Событие | Уведомление |
|---|---|
| Изменение статуса запроса | «Заявка %(helpdesk_ticket)s - смена получателя для %(package)s имеет статус %(helpdesk_ticket.status)s» |
Команды Telegram-бота
| Команда | Описание |
|---|---|
| /start <access_token> | Регистрирует пользователя в Telegram-боте. |
| /status | Проверяет статус посылки по её номеру или трек-номеру. Показывает информацию о посылке и интерактивные кнопки «Содержимое», «Отправление» и «Общая посылка». |
| /declare | Добавляет ожидаемую посылку. |
| /support | Создаёт обращение в службу поддержки. Среди доступных действий есть «Сменить получателя». |
| /profile | Показывает данные профиля. Также содержит кнопку «Адрес доставки», через которую можно открыть адрес склада KIVVI в США. |
| /delivery_methods | Позволяет выбрать способ доставки: доставку по адресу или получение в пункте Boxberry. |
| /cancel | Отменяет текущее действие. |
Поддержка
Если появятся вопросы о функциях Telegram-бота, наша служба поддержки всегда готова помочь.