Автопублікація SEO-блогу через Albato

Реалізуйте чотири дії Blogent та повертайте кінцеві результати. Zapier, Albato й ApiX-Drive потребують захищеного callback; приймання webhook не підтверджує публікацію.

1. Створіть Webhook connection і сценарій Incoming webhook. Вкажіть URL отримання у Blogent та оберіть Albato.
2. Розгалужуйте сценарій за action: inventory повертає наявні статті й next_cursor; read — повний snapshot; create/update — відповідну дію CMS.
3. Для запису потрібен транзакційний адаптер CMS із журналом operation_id та атомарною перевіркою expected_revision. При оновленні зберігайте ID, URL, дати, авторів і ресурси; не виконуйте сліпий upsert за alias.
4. Додайте HTTP Request → Send API Request останнім кроком callback. Збережіть request_id, callback_url і callback_token. Останній HTTP POST надсилає на callback_url заголовок Authorization: Bearer callback_token і JSON {contract_version:"2.0",request_id,action,result}. У разі помилки надішліть явний невдалий результат.
5. Запустіть тест: inventory, створення, захищене читання й оновлення тієї самої статті. Стандартне підтвердження приймання або частковий результат не завершують тест.

Документація HTTP-дії для callback

Callback завершення для асинхронних сценаріїв

1. Оберіть Zapier, Albato або ApiX-Drive у Blogent. Кожна дія містить request_id, точний callback_url і окремий callback_token. Передавайте ці значення через усі кроки сценарію.
2. Розгалужуйте сценарій за action. Inventory/read читають CMS; create/update використовують постійний журнал операцій, транзакції та перевірку ревізії.
3. Після завершення надішліть POST JSON на отриманий callback URL із заголовком Authorization: Bearer <callback_token>. Тіло: {contract_version:"2.0",request_id,action,result}. Result має формат синхронної відповіді відповідної дії.
4. У разі помилки передайте result:{posted:false,message:"причина",status:409} із відповідним кодом 4xx/5xx. Часткова публікація не може повертати posted:true.
5. Callback прив’язаний до запиту, дії та конфігурації. Ідентичний повтор приймається; змінений результат повертає 409, хибний токен — 401, прострочений запит — 410. Запит діє годину; Blogent може повторити його до п’яти разів із проміжком щонайменше дві хвилини. Дедуплікуйте request_id та operation_id.
6. Тест відновлюється після callback: inventory → create → read → update тієї самої реальної статті. Приймання в чергу залишає стан очікування. Перевірка відбувається через захищену інтеграцію без обходу публічних сторінок.

Дії та сталі ідентифікатори

• Shopify, HubSpot, Webflow і Framer використовують підключений нативний адаптер. WordPress, OpenCart, Strapi та Lovable — встановлений конектор Blogent; v0 і Replit адаптують його до наявного застосунку. Wix, Make, n8n та власні endpoint реалізують синхронний контракт; Zapier, Albato й ApiX-Drive — callback завершення.
• inventory: передайте cursor: null і limit; відповідь — {articles: [snapshot], next_cursor: string|null}. Продовжуйте з отриманим курсором до null.
• read: передайте target та/або content_id; відповідь — {article_snapshot: snapshot}. Явний нативний target є визначальним; логічний content_id Blogent може відрізнятися від ID у CMS.
• Snapshot містить identity, title, alias, date, article, target, revision, urls і необов’язкові дані зображення/автора. article містить повний текст та SEO-поля кожної мови. Невідома первинна дата може бути null, недоступні URL — порожньою мапою.
• create: передайте статтю, унікальний operation_id, логічний content_id, порожній target та null expected_revision. Після повної публікації поверніть {posted:true,target,revision,urls}.
• update: передайте наявні target ID та актуальну expected_revision. Збережіть ID, URL/alias, первинну дату, автора й ресурси. Перевірте ревізію атомарно перед записом.

Що ви отримуєте після підключення Albato

• Читайте наявний архів і повні snapshot перед плануванням нових статей.
• Оновлюйте статті зі збереженням ID, URL, первинних дат, авторів і ресурсів.
• Безпечно повторюйте ідентичні операції та відхиляйте застарілі ревізії чи змінені повтори.

Вимоги та сумісність

Дії

Реалізуйте inventory, read, create та update для наявної CMS із явними мовними мапінгами.

Конкурентність

Транзакційний адаптер із постійним журналом operation_id та атомарною перевіркою expected_revision. Окремих no-code upsert недостатньо.

Завершення

POST кінцевого результату на callback_url із заголовком Authorization: Bearer callback_token. Збережіть request_id та action.

Часті запитання про інтеграцію з Albato