HelomiWIKI

Allo

Інтеграція з маркетплейсом Allo виставляє ваші товари на Allo фідом: картки робить ШІ Алла з даних CRM, а Allo сам читає файл за постійною адресою — разом із цінами й залишками. Картка «Allo» в «Інтеграціях» зберігає логін і ключ API кабінету, перевіряє вхід і баланс і показує адресу фіду; кабінетів Allo може бути кілька.

7 хвОновлено 05.11.2026
Markdown для ШІ
На цій сторінці

Можливості

  • Картки товарів для Allo — через ШІ Аллу: категорії, назви, описи, характеристики, фото, перевірка правилами, затвердження.
  • Фід для кабінету Allo: адреса з «Копіювати», у фід ідуть лише затверджені картки; ціни й залишки — у тому самому фіді.
  • «Перевірити» — безпечний вхід у Public API Allo і баланс партнера (лише читання).
  • Канал «Allo» у «Прайс-листі» і рядок «Allo (фід Алли)» у «Публікаціях на площадки» — зміни булостало«було → стало», розклад.
  • Кілька кабінетів Allo: у кожного свої ключі, стан і журнал.
  • API Allo дає лише замовлення й баланс. Приймання замовлень Allo в «Угоди» (статуси й ТТН назад) — наступний етап.

1Налаштування

Підключає адміністратор. Логін і ключ API видає підтримка Allo — у кабінеті продавця їх самому не створити.

  1. Напишіть у підтримку Allo для продавців: попросіть логін і ключ доступу до Public API (версія 2).
  2. Попросіть підтримку Allo внести адресу сервера Helomi в білий список — Allo пускає в API лише з дозволених адрес. Яку адресу назвати, підкаже адміністратор Helomi.
  3. Відкрийте НалаштуванняІнтеграції й автоматизаціяМаркетплейсиAllo«Налаштування → Інтеграції й автоматизація → Маркетплейси → Allo» → вкладка «Підключення».
  4. Рядок ALLO_API_LOGIN → «Ввести» → вставте логін → «Зберегти». Те саме для ALLO_API_KEY — ключ API.
  5. Натисніть «Перевірити». Успіх — «Зв'язок є: баланс … грн, утримано … грн»; помилка — текст від Allo (див. «Можливі помилки»).
  6. Увімкніть інтеграцію перемикачем на картці.

Ключі зберігаються зашифрованими і більше не показуються: у рядку видно лише «задано» й останні знаки. Змінити — «Змінити» і ввести новий.

Примітка

«Перевірити» лише входить і читає баланс — у кабінеті Allo нічого не змінюється.

2Адреса фіду в кабінеті Allo

Фід — файл з картками, цінами й залишками за постійною адресою; Allo читає його сам за своїм розкладом. Адресу вписують у кабінеті Allo один раз.

  1. Відкрийте вікно ШІ Алли → кнопка «Фід» у шапці (адресу видно й у картці «Allo» → «Підключення» → «Стан роботи»).
  2. Натисніть «Копіювати» біля адреси фіду. Адреса з'являється після першого збирання фіду.
  3. У кабінеті продавця Allo відкрийте розділ, де товари завантажуються файлом за посиланням (прайс-лист), і вставте адресу.
  4. Затверджуйте картки в Алли — вони потраплять у фід, Allo забере їх при наступному читанні й відправить на модерацію.

У «Стані роботи» картки видно, скільки товарів у фіді, коли його зібрано, скільки товарів уже на Allo і останню помилку Allo.

Порада

Фід порожній, доки нема жодної затвердженої картки з фото. Почніть з кількох карток — так видно, як Allo їх приймає.

3Другий кабінет (акаунти)

Кабінетів Allo може бути кілька: у кожного свої логін, ключ, стан і журнал, а фід — окремий.

  1. Картка «Allo» → кнопка «+» внизу («Додати ще один Allo») → «Назва» (як підписати кабінет).
  2. Відкриється картка нового акаунта — він створюється вимкненим. Введіть ALLO_API_LOGIN і ALLO_API_KEY саме цього кабінету, «Перевірити», увімкніть.
  3. Щоб Алла робила фід для цього кабінету — у її НалаштуванняAllo і публікаціяАкаунт Allo«Налаштування → Allo і публікація → Акаунт Allo» впишіть ключ акаунта (allo-назва).
  4. Перейменувати — поле «Назва акаунта»; прибрати — «Прибрати» (зникають ключі, налаштування й журнал акаунта).

4Публікації → Allo

Окремого надсилання цін і залишків на Allo нема: у Public API таких методів не існує. «Публікації» для Allo перезбирають фід Алли і показують, що в ньому змінилось.

  1. Відкрийте СкладПублікації на площадки«Склад → Публікації на площадки» → картка «Allo (фід Алли)».
  2. Натисніть «Оновити зараз», позначте «Allo» і «Показати, що зміниться» — список БулоСтане«Було → Стане» (ціна, залишок).
  3. «Підтвердити й оновити» — фід перезбирається. Allo читає фід сам — зміни з'являться після наступного його оновлення.
  4. Без кнопки — перемикач «автоматично» і «кожні N хв» на тій самій картці (типово вручну, 60 хв).

Якщо у фіді раптом набагато менше товарів, ніж було (менше за «Неповний склад» у налаштуваннях Алли, типово 150), зміни не застосовуються — це схоже на збій складу. Відправити попри це — галочка «Запобіжник».

5Прайс-лист: канал Allo

Затверджені картки Алла сама кладе в «Прайс-лист» як позиції каналу «Allo» — так Allo видно поруч з Prom і Rozetka.

  1. Відкрийте «Склад» → вкладка «Прайс-лист» → папка «Allo».
  2. У позиції — назва й ціна Allo, фото, характеристики і зв'язок з товаром складу за артикулом; залишок — вільний залишок складу.
  3. Ціну на 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» без прохання людини.

Додаткова інформація

Цю саму статтю читають ШІ-співробітники Helomi: help("int-allo")