Головна Інтеграція

Інтеграція AI SEO Blog

Матеріали для інтеграції SEO Blog через WordPress‑плагін або універсальний вебхук. Оберіть сценарій, завантажте плагін або протестуйте свій endpoint.

Протестувати вебхук

Оберіть інтеграцію

HTML-теги, для яких потрібні стилі

h1, h2, h3, h4

p, ul, ol, li, a, strong, img

table, thead, tbody, tr, th, td

details, summary

Для <a> переконайтеся, що підтримуються атрибути rel і target.

.tldr - для першого p (можна виділяти більшим шрифтом)

.faq-section - обгортка для <details> для FAQ

WordPress‑плагін

Готовий плагін підключає автопублікацію та бере інтеграцію на себе. Встановіть його з WordPress.org, активуйте й додайте вебхук із дашборда.

Відкрити на WordPress.org

Налаштування плагіна

Встановіть і активуйте плагін у WordPress dashboard.
Settings → Blogent SeoBlog: відкрийте сторінку налаштувань.
Map languages, якщо коди нестандартні (наприклад, uk=ua).
Set blog categories для кожної мови (slugs категорій).
Copy the webhook URL з плагіна і вставте у дашборд Blogent.
Custom images: у Rubric Image IDs додайте ключі категорій у форматі key=id1,id2. Ключ має відповідати image_category з вебхука.

Як плагін обирає зображення

Якщо вебхук надсилає image (пряме посилання) — воно використовується.
Якщо надсилає image_category (кастомні зображення) — плагін шукає цей ключ у Rubric Image IDs і бере випадковий ID зі списку.
Якщо image_category немає, але є рубрика — бере ID за ключем рубрики.
Якщо жоден варіант не підійшов — бере зображення з папки Blogent_blog_photo.

Універсальна інтеграція: Blogent надсилає POST із JSON на ваш endpoint. Ви приймаєте дані та публікуєте статті.

Що потрібно

HTTPS endpoint, що приймає POST з Content-Type: application/json.
Підтримується опційний кастомний заголовок авторизації: наприклад Authorization: c0ef7fe65b75676c6d8a5807b.
Зберігайте зображення локально (поле image — тимчасовий URL).
Поверніть {"posted": true} після успішної публікації.
Якщо публікація не вдалася, повертайте {"posted": false, "message": "..."}, де message коротко пояснює причину помилки. Це спрощує діагностику.

JSON‑навантаження

{
   "image": "https://.../article.webp",
   "image_category": "desert-tours",
   "alias": "string-for-url",
   "date": "0000-00-00 00:00:00",
   "rubric": "category-slug",
   "params": "key:value|value;key2:value;",
   "article": {
     "en": {
       "title": "text",
       "alias": "string-for-url-en",
       "preview": "html",
       "meta_title": "text",
       "meta_description": "text",
       "reading_time_minutes": 7,
       "toc": [
         {
           "title": "Main section",
           "id": "main-section",
           "children": [
             {
               "title": "Nested point",
               "id": "nested-point",
               "children": []
             }
           ]
         }
       ],
       "text": "html"
     }
   }
}

Поля

rubric — slug категорії/рубрики у вашій CMS.
params — довільні атрибути товарів у форматі key=value1|value2; (опційно).
alias — основний alias (slug) для зворотної сумісності.
image — тимчасовий URL на обкладинку, збережіть файл локально/на CDN перед публікацією.
image_category — ключ для кастомних зображень; зіставте його зі своїми ID (якщо функція увімкнена).
article — обʼєкт з мовами (наприклад en, uk). Кожна мова містить title, alias, preview (HTML), text (HTML), meta_title, meta_description, reading_time_minutes, toc (вкладені якорі H2/H3/H4).

Параметри товарів

Якщо потрібно підбирати товари, передайте атрибути в полі params (формат key=value1|value2;). Збережіть значення у CMS, щоб фільтрувати каталог або відображати рекомендації.

Заголовок авторизації

У налаштуваннях webhook у дашборді можна опційно додати будь-яку пару заголовка. Приклад: Authorization + c0ef7fe65b75676c6d8a5807b. Blogent додасть її в заголовки webhook-запиту.

Шорткоди

Blogent може автоматично вставляти шорткод у тіло статті, щоб показувати маркетингові або інтерактивні блоки прямо всередині контенту.

Як це працює

У дашборді SEO Blog ви вказуєте один шорткод для блогу, наприклад [contact-form] або [products_slider category="chairs"].
Під час генерації статті Blogent вставляє цей шорткод у середині матеріалу в природному місці, не ламаючи структуру тексту.
Ваш сайт або CMS мають вміти обробити цей шорткод і замінити його на готовий блок: форму, CTA, промокод, слайдер товарів, банер тощо.
Якщо шорткод потребує параметрів, передавайте їх у тому форматі, який очікує ваш сайт або плагін.

Приклади використання

Маркетинговий призив до дії: [cta]
Промокод зі знижкою: [promo_code]
Форма зворотного звʼязку: [contact-form]
Слайдер товарів: [products_slider]
Добірка рекомендованих товарів: [featured_products]
Банер або інформаційний віджет: [info_banner]

Назви та параметри шорткодів залежать від вашого сайту. Якщо на сайті немає підтримки шорткодів, розробнику потрібно додати відповідну обробку або плагін.

PHP приклад

$data = json_decode(file_get_contents('php://input'), true);

if (json_last_error() === JSON_ERROR_NONE) {
    $primaryAlias = $data['alias'] ?? '';
    $date = $data['date'] ?? '';
    $rubric = $data['rubric'] ?? '';
    $params = $data['params'] ?? '';
    $imageCategory = $data['image_category'] ?? '';

    foreach ($data['article'] as $lang => $article) {
        $title = $article['title'] ?? '';
        $languageAlias = $article['alias'] ?? '';
        $preview = $article['preview'] ?? '';
        $text = $article['text'] ?? '';
        $metaTitle = $article['meta_title'] ?? '';
        $metaDescription = $article['meta_description'] ?? '';
        $readingTimeMinutes = (int) ($article['reading_time_minutes'] ?? 0);
        $toc = is_array($article['toc'] ?? null) ? $article['toc'] : [];
    }

    $imageUrl = $data['image'] ?? '';
    if ($imageUrl) {
        $imagePath = 'images/' . basename($imageUrl);
        if ($image = @file_get_contents($imageUrl)) {
            file_put_contents($imagePath, $image);
        }
    }

    header('Content-Type: application/json');
    echo json_encode(['posted' => true]);
}

Webhook tester

Надішліть тестову статтю на свій endpoint і перевірте, як CMS обробляє дані. За потреби змініть JSON.