Kivvi предлагает Telegram бота, который позволяет управлять отправками, отслеживать посылки и выполнять различные действия прямо из вашего мессенджера. Это руководство охватывает все доступные функции и команды.
Register in Telegram Bot
Sign in to your account. If you don't have a Telegram bot account, locate the "Telegram" card and press the "Register in Telegram" button. The card remains visible until you complete the registration.
You will be redirected to the Telegram bot. To begin, enter or select the /start command. Please check all the bot features in that post.
Уведомления в Telegram
Бот автоматически отправляет пользователям уведомления в 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-код содержит информацию о вашей посылке и будет отсканирован для подтверждения получения.» |
Подтверждение складской операции (Picking Validation)
Уведомления отправляются при подтверждении настроенного типа операции.
| Тип операции | Уведомление |
|---|---|
| Приёмка | «Ваши посылки %(package)s прибыли на наш склад в %(warehouse.partner.city)s, %(country)s. Пожалуйста, ожидайте дальнейших обновлений, когда ваша посылка будет готова к доставке или получению.» |
| Отправка | «Ваши посылки %(package)s направляются в следующий пункт назначения. Они готовятся к международной пересылке.» |
| Передача перевозчику | «Ваши посылки %(package)s прибыли в пункт доставки и были переданы курьеру %(delivery_method)s. Трек-номер курьера: %(tracking number)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» |
Примечание: Информация о родительской посылке отображается только в том случае, если посылка имеет родительскую посылку и партнёр авторизован для её просмотра. Для отправленных посылок статус отображается как «Отправлена».
Информация о профиле (команда /profile)
При запросе информации о профиле через команду /profile бот отвечает:
| Элемент ответа | Описание |
|---|---|
| Профиль пользователя | Информация о вашем аккаунте. |
| Адрес доставки | Ваш текущий адрес доставки: %(delivery_address)s |
| URL пункта Boxberry | Ваш пункт выдачи Boxberry: %(boxberry_point_url)s |
| /delivery_methods | Опция для установки или изменения способа доставки (если не установлен). |
| Кнопка US Address | Отображает ваш базовый адрес для пересылки при нажатии. |
Примечание: Пожалуйста, обратитесь к файлу Configuration readme для получения дополнительной информации.
Действия выполняемые по запросам из Telegram
Создание ожидаемой посылки (команда /declare)
Для объявления новой ожидаемой посылки используйте команду /declare.
| Шаг | Ответ |
|---|---|
| 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. Кнопки подтверждения | «Кнопка Да / Кнопка Нет» |
Примечание: В уведомлении отображаются только имя и первая буква фамилии для обеспечения конфиденциальности.
Уведомления о статусе заявок в поддержку
Уведомления об изменении статуса заявок в поддержку отправляются пользователям автоматически при изменении статуса.
| Событие | Уведомление |
|---|---|
| Изменение статуса заявки | «Заявка %(helpdesk_ticket)s - смена получателя для %(package)s имеет статус %(helpdesk_ticket.status)s» |
Справочник команд Telegram
| Команда | Описание |
|---|---|
| /start <access_token> | Регистрирует пользователя в боте. |
| /status | Проверяет статус посылки по названию или референсу. Отображает информацию о посылке с интерактивными кнопками: Содержимое, Отправление, Родительская посылка. |
| /declare | Объявляет новую ожидаемую посылку. |
| /support | Создаёт запрос в поддержку. Отображает варианты запросов с кнопкой: Смена получателя. |
| /profile | Получает информацию о профиле пользователя. Включает кнопку Адрес доставки (базовый адрес для пересылки для пользователей с референсом партнёра). |
| /delivery_methods | Устанавливает способ доставки. Отображает: Доставка по адресу (заполните соответствующие поля) или Доставка Boxberry (выберите с помощью виджета). |
| /cancel | Отменяет любое выполняемое действие. |
Поддержка
Если у вас возникли вопросы по функциям Telegram бота, наша служба поддержки всегда готова помочь.