> Усі статті WIKI Helomi: /wiki/llms.txt

# Allo

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

## Можливості
- Картки товарів для Allo — через [ШІ Аллу](ai-alla.md): категорії, назви, описи, характеристики, фото, перевірка правилами, затвердження.
- Фід для кабінету 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» → вкладка «Підключення».
4. Рядок `ALLO_API_LOGIN` → «Ввести» → вставте логін → «Зберегти». Те саме для `ALLO_API_KEY` — ключ API.
5. Натисніть «Перевірити». Успіх — «Зв'язок є: баланс … грн, утримано … грн»; помилка — текст від Allo (див. «Можливі помилки»).
6. Увімкніть інтеграцію перемикачем на картці.

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

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

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

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

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

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

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

1. Картка «Allo» → кнопка «+» внизу («Додати ще один Allo») → «Назва» (як підписати кабінет).
2. Відкриється картка нового акаунта — він створюється вимкненим. Введіть `ALLO_API_LOGIN` і `ALLO_API_KEY` саме цього кабінету, «Перевірити», увімкніть.
3. Щоб Алла робила фід для цього кабінету — у її «Налаштування → 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» у вікні Алли).

## Можливі помилки
| Що бачите | Чому | Що робити |
| --- | --- | --- |
| «Не задано логін і ключ API 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 і вводить ключі лише людина: інструментів для ключів інтеграцій ШІ не має. Картки, фід і партії ШІ веде інструментами Алли `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» без прохання людини.

## Додаткова інформація
- Пов'язані статті: [ШІ Алла](ai-alla.md), [Прайс-лист](pricelist.md), [Склад](products.md), [Інтеграції](integrations.md), [Rozetka](int-rozetka.md), [Prom](int-prom.md).