Перейти до змісту

Підключіть WordPress до JaDel

Плагін Lynbro Social Auto Post публікує запис із WordPress у ваші соцмережі через JaDel. Плагін користується лише ключем API, який ви створюєте самі й можете будь-коли відкликати.

Що робить плагін

  • Коли ви публікуєте або плануєте запис, плагін надсилає в JaDel заголовок, уривок, посилання й обрані вами зображення.
  • JaDel створює допис для кожного обраного каналу, перевіряє його за правилами мережі й публікує в запланований час.
  • Статус (опубліковано, не вийшло, посилання на допис) повертається у WordPress і видно поруч із записом.

Крок 1 — Створіть акаунт JaDel

Створіть безкоштовний акаунт і підключіть соцмережі, куди хочете публікувати (напр. Telegram, Bluesky чи Mastodon).

Створити безкоштовний акаунт

Крок 2 — Створіть ключ API

Кнопка в плагіні відкриває JaDel із полями, заповненими для вашого сайту. Можна відкрити й самостійно:

Створити ключ для WordPress
/app/keys/new/?name=your-site.dk&scopes=posts:write,channels:read,media:write&source=wordpress

Дозволи, потрібні плагіну

  • posts:write — створювати й планувати дописи з ваших записів
  • channels:read — показувати ваші канали в редакторі, щоб ви могли обрати
  • media:write — надсилати обрані зображення разом із дописом

Адреси сайту: вкажіть адресу сайту, напр. https://my-site.dk, і за потреби тестовий сайт (не більше 5). Ключ працює лише з цих адрес.

Адреса вебхука: https://my-site.dk/wp-json/lynbro-jadel/v1/webhook — сюди JaDel надсилає статус плагіну. Заповнюється автоматично.

Крок 3 — Вставте ключ у WordPress

  1. Скопіюйте ключ (jd_sk_…). Його показано лише один раз.
  2. Відкрийте WordPress → Налаштування → Lynbro Social Auto Post → З'єднання й вставте ключ.
  3. Натисніть «Test». Плагін покаже ваш план, використаний ліміт і канали.

Крок 4 — Опублікуйте запис

  1. Відкрийте запис. У панелі «Lynbro Social Auto Post» оберіть канали й за бажання змініть текст.
  2. Опублікуйте або заплануйте запис як завжди. JaDel запланує дописи.
  3. Статус повертається підписаним вебхуком і видно поруч із записом.

Що надсилається в JaDel

Лише для записів, якими ви вирішили поділитися:

  • заголовок, уривок і адреса запису
  • зображення й тексти, які ви обрали в панелі
  • час публікації

Чого JaDel ніколи не отримує

  • Ні логіна WordPress, ні користувачів, паролів, доступу до бази чи FTP.
  • JaDel звертається до сайту лише підписаними вебхуками на власний маршрут плагіна — і більше нікуди.

Як відключити

  • У JaDel: API & WordPress → Відкликати. Ключ одразу перестає працювати.
  • У WordPress: Налаштування → Lynbro Social Auto Post → Disconnect. Плагін видаляє ключ із сайту.

Ліміти за планами

Плагін WordPress працює на всіх планах. Ліміти ті самі, що й у застосунку:

ПланКаналиДописиAPI
Безкоштовний360 постів за 30 днівПлагін WordPress і API (дописи, канали, медіа)
Start8Без ліміту постів (розумне використання)Плагін WordPress і API (дописи, канали, медіа)
Pro25Без ліміту постів (розумне використання)Повний API: усі дозволи, зокрема статистика й AI
Агенція75Без ліміту постів (розумне використання)Повний API: усі дозволи, зокрема статистика й AI

Для розробників

Плагін користується звичайним API JaDel за адресою https://jadel.dk/api/v1. Той самий API можна викликати з власної системи.

Ендпоінти, доступні ключу

  • GET/api/v1/me
  • GET/api/v1/channels
  • POST/api/v1/ideas
  • POST/api/v1/ideas/{id}/variants
  • POST/api/v1/ideas/preflight
  • POST/api/v1/ideas/{id}/preflight
  • POST/api/v1/ideas/{id}/schedule
  • POST/api/v1/assets
  • GET/api/v1/openapi.json

Заголовки

Authorization: Bearer jd_sk_…
Ключ API. Обов'язковий.
X-Lynbro-Origin: https://your-site.dk
Обов'язковий, якщо в ключа є адреси. Має бути однією з них.
Idempotency-Key: <uuid>
На кожен запис. Той самий ключ + те саме тіло протягом 24 год = та сама відповідь.
X-Dry-Run: 1 або ?dry_run=true
Перевіряє все, нічого не записує.
Accept-Language: da | en | uk
Мова повідомлень про помилки.
curl -X POST "https://jadel.dk/api/v1/ideas?dry_run=true" \
  -H "Authorization: Bearer jd_sk_…" \
  -H "X-Lynbro-Origin: https://your-site.dk" \
  -H "Idempotency-Key: wp-post-123-rev-4" \
  -H "Content-Type: application/json" \
  -d '{"text": "New on the blog", "link": "https://your-site.dk/post"}'

Коди помилок

КодHTTPЗначення
invalid_key401Ключ неправильний, прострочений або відкликаний.
scope_missing403Ключу бракує дозволу (details.scope).
origin_mismatch403X-Lynbro-Origin відсутній або не з адрес ключа.
quota_exceeded402Ліміт плану вичерпано (details.resets_at, details.upgrade_url).
rate_limited429Понад 120 запитів на хвилину на ключ. Зачекайте Retry-After секунд.
idempotency_key_reused422Той самий Idempotency-Key з іншим тілом.
idempotency_in_progress409Перший запит із цим ключем ще виконується.

Idempotency-Key

Надсилайте новий UUID на кожну дію і той самий — під час повтору. Якщо сервер бачить ключ удруге, ви отримаєте першу відповідь із заголовком Idempotent-Replayed: true — дубль допису не створюється.

Dry run і sandbox

З ?dry_run=true або X-Dry-Run: 1 запит перевіряється, але нічого не записується. Ключ, створений як sandbox, завжди працює в режимі dry run.

Вебхуки

  • Події: post.published, post.failed і ping (з кнопки «Перевірити вебхук»).
  • JaDel надсилає POST із JSON на адресу вебхука ключа із заголовками X-Lynbro-Timestamp, X-Lynbro-Event-Id, X-Lynbro-Event і X-Lynbro-Signature.
  • Якщо доставка не вдалася, JaDel повторює зі зростаючою паузою до ~20 годин.
  • Отримувач має перевірити підпис і час (±300 с), відкинути дублі за event id, а потім перечитати допис через API, перш ніж щось робити.
{
  "id": "3f6c…-uuid", "type": "post.published", "created_at": "2026-11-17T10:00:00Z",
  "data": { "idea_id": "…", "variant_id": "…", "channel_id": "…", "provider": "bluesky",
            "status": "published", "external_url": "https://…", "published_at": "…", "error": null,
            "idea_status": "published" }
}

Підпис

X-Lynbro-Signature: v1=<hex>
<hex> = HMAC-SHA256(webhook_secret, timestamp + "." + "POST" + " " + path + "." + raw_body)

path — шлях адреси вебхука (разом із query, якщо є), напр. /wp-json/lynbro-jadel/v1/webhook. raw_body — сире тіло до розбору.

Перевірка на PHP

function lynbro_verify(string $secret, string $path, string $raw_body, array $h): bool {
    $ts  = $h['x-lynbro-timestamp'] ?? '';
    $sig = $h['x-lynbro-signature'] ?? '';
    if (!ctype_digit($ts) || abs(time() - (int) $ts) > 300) {
        return false;                                   // too old or from the future
    }
    $base = $ts . '.' . 'POST' . ' ' . $path . '.' . $raw_body;
    $want = 'v1=' . hash_hmac('sha256', $base, $secret);
    return hash_equals($want, $sig);                    // constant-time compare
}
// Then: skip if X-Lynbro-Event-Id was seen before; re-read the post via the API.