Підключіть 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
- Скопіюйте ключ (jd_sk_…). Його показано лише один раз.
- Відкрийте WordPress → Налаштування → Lynbro Social Auto Post → З'єднання й вставте ключ.
- Натисніть «Test». Плагін покаже ваш план, використаний ліміт і канали.
Крок 4 — Опублікуйте запис
- Відкрийте запис. У панелі «Lynbro Social Auto Post» оберіть канали й за бажання змініть текст.
- Опублікуйте або заплануйте запис як завжди. JaDel запланує дописи.
- Статус повертається підписаним вебхуком і видно поруч із записом.
Що надсилається в JaDel
Лише для записів, якими ви вирішили поділитися:
- заголовок, уривок і адреса запису
- зображення й тексти, які ви обрали в панелі
- час публікації
Чого JaDel ніколи не отримує
- Ні логіна WordPress, ні користувачів, паролів, доступу до бази чи FTP.
- JaDel звертається до сайту лише підписаними вебхуками на власний маршрут плагіна — і більше нікуди.
Як відключити
- У JaDel: API & WordPress → Відкликати. Ключ одразу перестає працювати.
- У WordPress: Налаштування → Lynbro Social Auto Post → Disconnect. Плагін видаляє ключ із сайту.
Ліміти за планами
Плагін WordPress працює на всіх планах. Ліміти ті самі, що й у застосунку:
| План | Канали | Дописи | API |
|---|---|---|---|
| Безкоштовний | 3 | 60 постів за 30 днів | Плагін WordPress і API (дописи, канали, медіа) |
| Start | 8 | Без ліміту постів (розумне використання) | Плагін WordPress і API (дописи, канали, медіа) |
| Pro | 25 | Без ліміту постів (розумне використання) | Повний 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_key | 401 | Ключ неправильний, прострочений або відкликаний. |
scope_missing | 403 | Ключу бракує дозволу (details.scope). |
origin_mismatch | 403 | X-Lynbro-Origin відсутній або не з адрес ключа. |
quota_exceeded | 402 | Ліміт плану вичерпано (details.resets_at, details.upgrade_url). |
rate_limited | 429 | Понад 120 запитів на хвилину на ключ. Зачекайте Retry-After секунд. |
idempotency_key_reused | 422 | Той самий Idempotency-Key з іншим тілом. |
idempotency_in_progress | 409 | Перший запит із цим ключем ще виконується. |
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.