Інтеграція створює відправлення й отримує номер ТТН. Збереження ТТН у замовленні, зміна статусу в CRM і повідомлення покупцю потребують окремого налаштування загального сценарію роботи AI-агента.
Як працює інтеграція
1
Підключіть акаунт Нової Пошти
Додайте назву й API-ключ. CostCare AI перевірить доступ і збереже підключення для вашої компанії.
2
Налаштуйте відправника та умови доставки
Збережіть контактні дані відправника, відділення та стандартні параметри посилки.
3
AI-агент отримує дані одержувача
У сценарії АІ-агента визначте, як саме CostCare AI має збирати дані покупця (задайте поведінку та/або скрипти) та коли переходити до оформлення (на якому етапі переписки).
4
CostCare AI формує відправлення
Система вибирає акаунт, знаходить населений пункт і місце отримання та об’єднує дані замовлення з налаштуваннями акаунта.
5
Нова Пошта повертає результат
CostCare AI отримує номер ТТН. Додатково можуть повертатися ідентифікатор відправлення, вартість і запланована дата доставки.
Перед початком
Доступ до CostCare AI
Вам потрібен доступ до робочого простору та розділу інтеграцій.
API-ключ Нової Пошти
Підготуйте ключ доступу до акаунта, з якого оформлюватимете відправлення.
Дані відправника
Підготуйте ім’я або назву відправника, телефон, країну та відділення відправлення.
Умови доставки
Визначте платника, тип доставки, категорію вантажу, вагу, розміри, оголошену вартість і валюту.
Як підключити Нову Пошту до CostCare AI
1. Відкрийте інтеграції
У CostCare AI перейдіть у розділ Інтеграції, оберіть Нова Пошта та натисніть Додати акаунт.
2. Додайте назву та API-ключ
У полі Назва акаунта введіть зрозумілу назву, наприклад «Основний склад». Вставте ключ доступу в поле API-ключ та натисніть Підключити. У вікні також є посилання Як отримати API-ключ.
- Назва не може бути порожньою.
- У межах компанії не можна створити два акаунти з повністю однаковою назвою.
- Ви можете підключити декілька акаунтів для різних складів.
- Кожна компанія має доступ лише до власних підключень.
Якщо Нова Пошта тимчасово недоступна, під час перевірки може з’явитися повідомлення про недійсний ключ. Перевірте правильність ключа та повторіть спробу пізніше.
3. Налаштуйте відправника
Для підключеного акаунта вкажіть:- Ім’я або назву відправника.
- Телефон.
- Країну відправлення.
- Відділення відправлення.
- Електронну пошту, якщо потрібна.
4. Задайте стандартні умови доставки
Збережіть для акаунта:- Хто оплачує доставку.
- Тип доставки.
- Категорію вантажу.
- Стандартну вагу та розміри посилки.
- Оголошену вартість.
- Валюту.
5. Визначте акаунт для AI-агента
Якщо у компанії один акаунт Нової Пошти, CostCare AI може вибрати його автоматично. Якщо акаунтів декілька, вкажіть назву потрібного акаунта в налаштуванні інструмента агента, наприклад «Львівський склад».Якщо потрібний акаунт не знайдено або вибір не визначено, оформлення зупиняється. Система повертає пояснення та перелік доступних акаунтів. Якщо акаунтів немає, спочатку підключіть Нову Пошту.
Налаштування сценарію AI-агента
Задайте у скрипті або рекомендаціях для AI-агента, які питання він має ставити покупцю та як використовувати інформацію із замовлення. Це можна зробити в налаштуваннях агента або під час взаємодії з Aura. Окремо визначте:- Які дані агент має отримати перед оформленням.
- За яких умов дозволено створювати ТТН.
- Як розраховується сума післяплати.
- Коли та як номер ТТН має потрапити в замовлення.
- Коли змінювати статус замовлення в CRM і повідомляти покупця.
Підключення Нової Пошти саме по собі не налаштовує весь діалог із покупцем і подальші дії із замовленням.
Які дані потрібні для відправлення
Дані одержувача
Для оформлення CostCare AI використовує отримані з чату:- Ім’я одержувача.
- Номер телефону.
- Населений пункт.
- Відділення або поштомат.
Як поєднуються дані
Поточний сценарій формує одну посилку на відправлення. CostCare AI автоматично переводить вагу у формат, потрібний для запиту до Нової Пошти.
Як вибираються населений пункт і відділення
CostCare AI шукає місто або селище в довіднику Нової Пошти. За замовчуванням пошук виконується в Україні.- Якщо є точний збіг назви, система вибирає його.
- Якщо точного збігу немає, поточна реалізація вибирає перший результат пошуку.
- Якщо результатів немає, система повідомляє, що населений пункт не знайдено.
Як працює післяплата
Якщо передана сума післяплати ненульова, CostCare AI додає її до запиту на відправлення. Якщо сума відсутня або дорівнює нулю, послуга не додається. Наприклад:- Оголошена вартість товару — 1 500 грн.
- Покупець уже сплатив 300 грн.
- Сума післяплати — 1 200 грн.
Оголошена вартість і післяплата — окремі значення. Інтеграція використовує передану суму післяплати. Різницю між вартістю товару та передоплатою має розрахувати інша частина сценарію CostCare AI.
Що відбувається під час створення ТТН
1
Перевірка відправника
CostCare AI перевіряє наявність імені, телефону та відділення відправлення.
2
Формування відправлення
Система об’єднує налаштування акаунта й дані замовлення, за потреби додає післяплату та позначає відправлення в запиті як «Готове до відправлення».
3
Передача даних Новій Пошті
CostCare AI надсилає запит і чекає на результат.
4
Отримання номера ТТН
Основний результат — номер ТТН. Якщо його немає у відповіді, система повідомляє про помилку й не вважає оформлення успішним.
Керування підключенням
Ви можете переглядати підключені акаунти, змінювати їхні назви, замінювати ключі доступу, оновлювати дані відправника та стандартні умови доставки. Після заміни ключа CostCare AI перевіряє новий ключ і, якщо перевірка успішна, позначає акаунт як підключений. Повторно вводити ключ для кожного відправлення не потрібно. CostCare AI автоматично підтримує доступ до Нової Пошти. Якщо тимчасовий доступ перестає діяти, система намагається оновити його та повторити запит.Як видалити підключення
У переліку підключених акаунтів Нової Пошти виберіть потрібний акаунт і видаліть його з CostCare AI.Як перевірити налаштування
1
Перевірте акаунт
Переконайтеся, що підключення збережене, а для кількох акаунтів у налаштуванні інструмента агента вказана потрібна назва.
2
Перевірте відправника й умови доставки
Перевірте ім’я, телефон, відділення, платника, вагу, розміри та оголошену вартість.
3
Перевірте дані замовлення
Уточніть ім’я й телефон покупця, населений пункт, місце отримання та суму післяплати, якщо вона потрібна.
4
Перевірте результат оформлення
Для відправлення, яке ви плануєте оформити, переконайтеся, що Нова Пошта повернула номер ТТН. Окремо перевірте подальші дії з номером у вашому сценарії.
Вирішення проблем
Ключ не проходить перевірку
Ключ не проходить перевірку
Перевірте, чи правильно скопійовано API-ключ. Тимчасова недоступність Нової Пошти також може спричинити повідомлення про недійсний ключ. Повторіть спробу пізніше.
Не вдається додати акаунт
Не вдається додати акаунт
Переконайтеся, що назва не порожня й у компанії немає акаунта з повністю такою самою назвою.
Система не може вибрати акаунт
Система не може вибрати акаунт
Перевірте список доступних підключень. Якщо їх декілька, вкажіть точну назву потрібного акаунта в налаштуванні інструмента агента.
Створення ТТН заблоковано
Створення ТТН заблоковано
Перевірте дані відправника: ім’я, телефон і відділення обов’язкові для оформлення.
Населений пункт або відділення не знайдено
Населений пункт або відділення не знайдено
Уточніть дані покупця й перевірте назву населеного пункту та номер відділення або поштомата. За відсутності результатів пошуку система не може визначити місце отримання.
У відповіді немає номера ТТН
У відповіді немає номера ТТН
CostCare AI вважає це помилкою оформлення. Перевірте результат запиту перед повторною спробою: захист від повторного створення ТТН потрібно передбачити окремо.
ТТН створено, але покупець не отримав повідомлення
ТТН створено, але покупець не отримав повідомлення
Перевірте загальний сценарій AI-агента. Збереження ТТН, зміна статусу в CRM та повідомлення покупця потребують окремого налаштування.
Що потрібно передбачити для повного процесу доставки
Поточна інтеграція покриває оформлення відправлення та отримання ТТН. Для повного процесу потрібно окремо реалізувати або налаштувати:- Перевірку телефонів, ваги та сум перед оформленням.
- Уточнення неоднозначного населеного пункту або відділення.
- Перевірку відповідності відділення населеному пункту.
- Захист від повторного створення ТТН.
- Збереження ТТН у замовленні та повідомлення покупцю.
- Відстеження руху посилки й оновлення статусу замовлення.
- Обробку отримання, відмови та повернення.
- Скасування відправлення.
- Контроль післяплати.
FAQ
Чи можна підключити декілька акаунтів Нової Пошти?
Чи можна підключити декілька акаунтів Нової Пошти?
Так. Наприклад, для різних складів. Назви акаунтів мають відрізнятися, а в налаштуванні інструмента агента потрібно вказати, який акаунт використовувати.
Чи можна змінити вагу або оголошену вартість для замовлення?
Чи можна змінити вагу або оголошену вартість для замовлення?
Так. Передані значення замовлення замінюють стандартну вагу й оголошену вартість акаунта. Також можна передати опис вмісту.
Чи створюється кілька посилок в одному відправленні?
Чи створюється кілька посилок в одному відправленні?
Поточний сценарій формує одну посилку на відправлення.
Чи означає номер ТТН, що посилку вже відправлено?
Чи означає номер ТТН, що посилку вже відправлено?
Ні. Номер підтверджує оформлення відправлення, але не передачу посилки перевізнику.
Чи скасуються відправлення після видалення підключення?
Чи скасуються відправлення після видалення підключення?
Ні. Видалення прибирає підключення з CostCare AI й не скасовує вже створені відправлення.