Інтеграція Нової Пошти з Home Assistant: посилки відслідковуються в розумному будинку

Всі ми час від часу ловимо себе на думці: «А де моя посилка?» — особливо, коли Новою Поштою замовили щось критично важливе, наприклад, кабель на AliExpress або каву, яка рятує ваш ранок. Добрі новини: якщо ви користуєтесь Home Assistant, то більше не доведеться відкривати додаток НП або ловити SMS, бо існує інтеграція Нової Пошти з Home Assistant. Ваш розумний будинок сам усе відстежить і навіть скаже, коли бігти до відділення.

У цій статті розповім, як інтегрувати Нову Пошту в Home Assistant за допомогою готового компоненту. Все просто, без ручних REST-запитів — усе, як ми любимо.

🧰 Що нам потрібно

Перед початком переконайтесь, що у вас є:

• Home Assistant (звісно, якщо ви попали на цю сторінку, то без нього ніяк).
• Встановлений HACS (Home Assistant Community Store), але це не обов’язково.
• Обліковий запис у Новій Пошті.
• API-ключ від Нової пошти (легко отримати, покажу далі).

🔑 Отримуємо API-ключ від Нової Пошти

• Заходимо у кабінет користувача Нової пошти.
• Авторизуємось як приватна особа.

• У вкладці “Безпека” натискаємо “Створити ключ”.
• Погоджуємось з ліцензійними умовами.

Скопіюйте цей ключ і бережіть, як свою IP-камеру — він особистий.

🚀 Встановлюємо інтеграцію Nova Poshta

• Відкриваємо HACS → Integrations → натискаємо кнопку з трьома крапками вгорі.
• Обираємо “Custom repositories”, вставляємо посилання:

https://github.com/krasnoukhov/homeassistant-nova-poshta

• Тип: Integration. Натискаємо “Add”.
• Знаходимо Nova Poshta у списку і натискаємо Install.
• Перезавантажуємо Home Assistant (Settings → System → Restart).

🛠 Якщо у вас немає HACS — ручне встановлення

Без HACS цю інтеграцію можна встановити вручну. Просто зробіть кілька кроків:

1. Скачайте останню версію інтеграції з GitHub:
   https://github.com/krasnoukhov/homeassistant-nova-poshta

2. Розпакуйте архів homeassistant-nova-poshta.zip.

3. Скопіюйте папку nova_poshta у директорію вашого Home Assistant:

   config/custom_components/nova_poshta

4. Перезапустіть Home Assistant.

5. Після цього ви зможете знайти інтеграцію в меню Налаштування → Пристрої та сервіси → Додати Інтеграцію як Nova Poshta.

⚙️ Підключаємо інтеграцію

Після перезавантаження:

1. Йдемо в Налаштування → Пристрої та сервіси → Додати Інтеграцію (або Settings → Devices & Services → Add Integration, якщо у вас англомовний інтерфейс).
2. Шукаємо Nova Poshta.
3. Вставляємо API-ключ.

👀 Що показує інтеграція

Інтеграція створює сенсори з іменем nova_poshta_delivered_parcels_in_CITY_XXX, де CITY — ваше місто, а XXX — номер відділення чи поштомату. Коли на ваше ім’я (тобто на ПІБ та номер телефону, прив’язані до облікового запису) прибуває посилка, лічильник у відповідному сенсорі збільшується. Також в атрибуті parcels буде доступна інформація про відправника та вміст посилки, зазначений у декларації.

💡 Використання в Lovelace

Додамо Lovelace-картку, яка показуватиме, що саме прибуло.

Атрибут parcels містить список посилок, які очікують на пошті, у форматі “Відправник – Опис”. Якщо не хочете бачити формальні назви на кшталт “ФОП Іванов” або “ОМНІ Груп”, можна додати шаблон, який відокремлює другу половину по роздільнику “-“.

type: vertical-stack
cards:
  - show_state: false
    show_name: false
    camera_view: auto
    type: picture-entity
    entity: sensor.nova_poshta_delivered_parcels_in_CITY_XXX
    image: /local/media/nova_poshta.png
  - type: markdown
    content: >
    **Посилки на Новій Пошті**
    {% for item in
    (state_attr('sensor.nova_poshta_delivered_parcels_in_CITY_XXX',
    'parcels')) %}
        * {{item.split ('-')[0]}}
    {%- endfor %}

Скачати картинку з логотипом можна тут. Результат виглядає приблизно так:

Щоб не захаращувати інтерфейс будинку, коли нічого на пошті не чекає, я винесла цю картку на додаткову вкладку, яку зробила допоміжною.

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

Коли на пошту прибуває посилка, Home Assistant показує мені делікатне повідомлення — невеликий нотифікатор, на який при бажанні можна натиснути і переглянути деталі.

🤖 Автоматизації

Я особисто вимкнула push-повідомлення з офіційного застосунку Нової Пошти — дратували недоречні рекламні пуші та запити оцінити сервіс щоразу після відвідування відділення. Замість цього, про посилку Home Assistant повідомляє мені в Telegram. Налаштування Telegram-бота — тема окремої статті, тому тут наведу лише шаблон для тих, у кого вже є налаштований бот:

- id: nova-poshta-arrived
  alias: Notify Telegram - Прибула посилка
  trigger:
  - platform: state
    entity_id:
    - sensor.nova_poshta_delivered_parcels_in_CITY_XXX
    for:
      hours: 0
      minutes: 0
      seconds: 1
  condition:
  - condition: template
    value_template: '{{ (trigger.from_state.state|int(0) < trigger.to_state.state|int(0))
    }}'
  action:
  - service: notify.telegram_tetiana
  data:
    title: "{{\"\U0001F4E6\"}} *На Нову Пошту прибула посилка*"
    message: "Наразі на пошті очікує: {% for item in trigger.to_state.attributes.parcels
      %} \n • {{ item.split ('-')[0] }}{% endfor %}"
  mode: single