Allo
Інтеграція з маркетплейсом Allo виставляє ваші товари на Allo фідом: картки робить ШІ Алла з даних CRM, а Allo сам читає файл за постійною адресою — разом із цінами й залишками. Картка «Allo» в «Інтеграціях» зберігає логін і ключ API кабінету, перевіряє вхід і баланс і показує адресу фіду; кабінетів Allo може бути кілька.
На цій сторінці
Можливості
- Картки товарів для Allo — через ШІ Аллу: категорії, назви, описи, характеристики, фото, перевірка правилами, затвердження.
- Фід для кабінету Allo: адреса з «Копіювати», у фід ідуть лише затверджені картки; ціни й залишки — у тому самому фіді.
- «Перевірити» — безпечний вхід у Public API Allo і баланс партнера (лише читання).
- Канал «Allo» у «Прайс-листі» і рядок «Allo (фід Алли)» у «Публікаціях на площадки» — зміни було›стало«було → стало», розклад.
- Кілька кабінетів Allo: у кожного свої ключі, стан і журнал.
- API Allo дає лише замовлення й баланс. Приймання замовлень Allo в «Угоди» (статуси й ТТН назад) — наступний етап.
1Налаштування
Підключає адміністратор. Логін і ключ API видає підтримка Allo — у кабінеті продавця їх самому не створити.
- Напишіть у підтримку Allo для продавців: попросіть логін і ключ доступу до Public API (версія 2).
- Попросіть підтримку Allo внести адресу сервера Helomi в білий список — Allo пускає в API лише з дозволених адрес. Яку адресу назвати, підкаже адміністратор Helomi.
- Відкрийте Налаштування›Інтеграції й автоматизація›Маркетплейси›Allo«Налаштування → Інтеграції й автоматизація → Маркетплейси → Allo» → вкладка «Підключення».
- Рядок
ALLO_API_LOGIN→ «Ввести» → вставте логін → «Зберегти». Те саме дляALLO_API_KEY— ключ API. - Натисніть «Перевірити». Успіх — «Зв'язок є: баланс … грн, утримано … грн»; помилка — текст від Allo (див. «Можливі помилки»).
- Увімкніть інтеграцію перемикачем на картці.
Ключі зберігаються зашифрованими і більше не показуються: у рядку видно лише «задано» й останні знаки. Змінити — «Змінити» і ввести новий.
«Перевірити» лише входить і читає баланс — у кабінеті Allo нічого не змінюється.
2Адреса фіду в кабінеті Allo
Фід — файл з картками, цінами й залишками за постійною адресою; Allo читає його сам за своїм розкладом. Адресу вписують у кабінеті Allo один раз.
- Відкрийте вікно ШІ Алли → кнопка «Фід» у шапці (адресу видно й у картці «Allo» → «Підключення» → «Стан роботи»).
- Натисніть «Копіювати» біля адреси фіду. Адреса з'являється після першого збирання фіду.
- У кабінеті продавця Allo відкрийте розділ, де товари завантажуються файлом за посиланням (прайс-лист), і вставте адресу.
- Затверджуйте картки в Алли — вони потраплять у фід, Allo забере їх при наступному читанні й відправить на модерацію.
У «Стані роботи» картки видно, скільки товарів у фіді, коли його зібрано, скільки товарів уже на Allo і останню помилку Allo.
Фід порожній, доки нема жодної затвердженої картки з фото. Почніть з кількох карток — так видно, як Allo їх приймає.
3Другий кабінет (акаунти)
Кабінетів Allo може бути кілька: у кожного свої логін, ключ, стан і журнал, а фід — окремий.
- Картка «Allo» → кнопка «+» внизу («Додати ще один Allo») → «Назва» (як підписати кабінет).
- Відкриється картка нового акаунта — він створюється вимкненим. Введіть
ALLO_API_LOGINіALLO_API_KEYсаме цього кабінету, «Перевірити», увімкніть. - Щоб Алла робила фід для цього кабінету — у її Налаштування›Allo і публікація›Акаунт Allo«Налаштування → Allo і публікація → Акаунт Allo» впишіть ключ акаунта (allo-назва).
- Перейменувати — поле «Назва акаунта»; прибрати — «Прибрати» (зникають ключі, налаштування й журнал акаунта).
4Публікації → Allo
Окремого надсилання цін і залишків на Allo нема: у Public API таких методів не існує. «Публікації» для Allo перезбирають фід Алли і показують, що в ньому змінилось.
- Відкрийте Склад›Публікації на площадки«Склад → Публікації на площадки» → картка «Allo (фід Алли)».
- Натисніть «Оновити зараз», позначте «Allo» і «Показати, що зміниться» — список Було›Стане«Було → Стане» (ціна, залишок).
- «Підтвердити й оновити» — фід перезбирається. Allo читає фід сам — зміни з'являться після наступного його оновлення.
- Без кнопки — перемикач «автоматично» і «кожні N хв» на тій самій картці (типово вручну, 60 хв).
Якщо у фіді раптом набагато менше товарів, ніж було (менше за «Неповний склад» у налаштуваннях Алли, типово 150), зміни не застосовуються — це схоже на збій складу. Відправити попри це — галочка «Запобіжник».
5Прайс-лист: канал Allo
Затверджені картки Алла сама кладе в «Прайс-лист» як позиції каналу «Allo» — так Allo видно поруч з Prom і Rozetka.
- Відкрийте «Склад» → вкладка «Прайс-лист» → папка «Allo».
- У позиції — назва й ціна Allo, фото, характеристики і зв'язок з товаром складу за артикулом; залишок — вільний залишок складу.
- Ціну на Allo змінюйте в картці товару Алли («Ціна на Allo» → «Зберегти») — позиція оновиться при наступному затвердженні чи публікації.
API Allo не віддає список ваших товарів, тож «Оголошення з каналів» для Allo бере дані зі знімка Алли: опубліковане фідом і файл вивантаження з кабінету (Ще›Що зараз на Allo«Ще → Що зараз на Allo» у вікні Алли).
Можливі помилки
| Що бачите | Чому | Що робити |
|---|---|---|
| «Не задано логін і ключ API Allo — введіть їх у Інтеграції›Маркетплейси›Allo«Інтеграції → Маркетплейси → Allo»» | Ключі не введено | Розділ 1, кроки 3–4 |
| «Allo не впустив: …» | Allo не прийняв логін чи ключ (текст після двокрапки — від Allo) | Перевірте логін і ключ; спитайте підтримку Allo, чи адресу сервера Helomi внесено в білий список |
| «Allo не прийняв логін або ключ — перевірте їх і білий список IP» | Allo відмовив без пояснення | Те саме: ключі й білий список у підтримки Allo |
| «Allo не відповів: …», «Allo тимчасово недоступний (HTTP …)» | Мережа або Allo зайнятий | «Перевірити» ще раз за кілька хвилин |
| «Allo відповів не JSON (HTTP …)» | Allo віддав сторінку замість відповіді API (часто — адреса не в білому списку) | Звернутися в підтримку Allo |
| «Allo: сесія не відновилась — спробуйте ще раз» | Сесія API закінчилась і не відкрилась заново | «Перевірити» ще раз |
| «Allo приймає товари, ціни й залишки лише файлом — API таких методів не має» | Спроба надіслати товари через API | Картки — фідом Алли, ціни й залишки — Публікації›Allo«Публікації → Allo» |
| «ШІ Аллу ще не додано — Інтеграції›ШІ›Додати›Алла«Інтеграції → ШІ → Додати → Алла»» | Публікації›Allo«Публікації → Allo» без Алли | Додати й увімкнути Аллу |
| «Такого фіду Allo немає» за адресою фіду | Адреса з іншого кабінету або акаунт прибрано | Скопіюйте адресу заново у вікні Алли → «Фід» |
| Фід порожній | Нема затверджених карток з фото | У вікні Алли затвердити картки |
Для ШІ-співробітників
Підключає Allo і вводить ключі лише людина: інструментів для ключів інтеграцій ШІ не має. Картки, фід і партії ШІ веде інструментами Алли ai_alla_* (стаття help("ai-alla")): ai_alla_feed — адреса фіду й скільки товарів, ai_alla_feed_rebuild — перезібрати, ai_alla_batch_publish — через кошик підтверджень. Акаунт Allo в даних — allo (основна картка) або allo-<назва>; товар на Allo зіставляється за артикулом і id Allo, повтор не дублює. Статтю ШІ читає help("int-allo").
Чого не робити: не вигадувати методів API Allo для товарів, цін і залишків — їх нема; не вмикати «Дозволити запис в Allo» без прохання людини.
Додаткова інформація
- Пов'язані статті: ШІ Алла, Прайс-лист, Склад, Інтеграції, Rozetka, Prom.
Цю саму статтю читають ШІ-співробітники Helomi: help("int-allo")