Герб Укріїни
Віримо в Україну та ЗСУ. Слава Україні!

Claude API WordPress інтеграція: чат-бот і описи товарів

Підключити Claude API до WordPress можна за один вечір: ключ із Anthropic Console, короткий плагін, який через wp_remote_post() надсилає запит на api.anthropic.com, і два сценарії зверху — чат-бот та чернетки описів товарів. Складніше інше: не віддати ключ у браузер, не вийти за бюджет і не опублікувати вигадані характеристики. Нижче — порядок дій, робочий код і що перевіряти після кожного кроку.

Інструкція розрахована на WordPress із PHP 8+ і, за потреби, WooCommerce. Моделі, ціни й ліміти змінюються, тому перед запуском звіряйте їх з офіційною документацією.

Коротко

  • Ключ Claude API зберігайте лише на сервері (wp-config.php), а чат звертайтеся до власного REST-маршруту, не до api.anthropic.com з браузера.
  • Викликає API функція wp_remote_post() з трьома заголовками: x-api-key, anthropic-version і content-type; помилки 429 і 529 обробляйте повторами із затримкою.
  • Витрати тримають п'ять запобіжників: ліміт у Console, денний лічильник, ліміт на IP, max_tokens і кеш відповідей.
  • Описи товарів записуйте в чернетку, а не в опис товару: перед публікацією потрібні автоперевірка й вибірковий огляд людиною.
Зміст
  1. Плагін чи власний код: що обрати і що врахувати в Україні
  2. Claude API WordPress інтеграція: 7 кроків і що перевірити
  3. Код плагіна: виклик API, ключ, кеш і ліміт витрат
  4. Чат-бот на сайті: REST-маршрут, історія діалогу й захист від зловживань
  5. Описи товарів WooCommerce: генерація й перевірка перед публікацією
  6. Скільки це коштує і як не вийти за бюджет
  7. З чого почати цього тижня

Плагін чи власний код: що обрати і що врахувати в Україні

Для чат-бота й описів є два шляхи: готовий плагін (наприклад, AI Engine) або мінімальний власний плагін на кількох десятках рядків. Готовий плагін швидший на старті, власний код дає контроль над ключем, лімітами, форматом промпта та кешем. Перед вибором перевірте, чи актуальна версія плагіна підтримує саме Claude.

Порівняння власного плагіна з готовим плагіном для інтеграції Claude
Власний код проти готового плагіна
Критерій Готовий плагін Власний мінімальний плагін
Час запуску Година-дві без коду Вечір-два з розробником
Контроль над промптом і кешем Обмежений налаштуваннями плагіна Повний
Ліміти витрат Залежать від плагіна Ваші правила в коді
Супровід Оновлення від автора плагіна Ваша відповідальність

Модель обирайте під завдання. Малі моделі серії Haiku дешевші й підходять для масової генерації описів та простих відповідей у чаті. Sonnet беріть, коли потрібні складніші міркування чи довші тексти, а Opus — рідко й точково. Точні ідентифікатори моделей беріть із документації Messages API, а не з пам’яті чи старих статей.

Claude працює з українською мовою, але якість залежить від теми: терміни, відмінки та назви брендів перевіряйте на своїх прикладах. Окремо перевірте, чи Україна є в списку підтримуваних країн Anthropic, і які способи оплати доступні для вашого акаунта. Умови змінюються, тому не покладайтеся на чужі скриншоти. Якщо вагаєтеся між Claude та іншими моделями, порівняйте їх у матеріалі Claude чи ChatGPT: що краще для бізнесу.

Claude API WordPress інтеграція: 7 кроків і що перевірити

Це короткий маршрут. Код до кроків 4–6 наведено в наступних розділах.

Сім кроків інтеграції Claude API з WordPress
Маршрут інтеграції від акаунта до запуску
  1. Акаунт в Anthropic Console. Зареєструйтеся, підключіть оплату та переконайтеся, що акаунт активний. Перевірте: у Console видно баланс або платіжний метод. Типова помилка: плутати підписку на Claude.ai з доступом до API — це окремі продукти з окремою оплатою.
  2. Ключ API і ліміт витрат. Створіть ключ у Console, дайте йому назву на кшталт «wp-site-prod» і задайте доступні в акаунті ліміти витрат. Перевірте: ключ скопійований один раз і ніде не лежить у чатах чи документах. Типова помилка: один ключ на всі проєкти — при витоку відкликати доведеться все одразу.
  3. Ключ у wp-config.php. Додайте константи DG_CLAUDE_KEY і DG_CLAUDE_MODEL (приклад нижче). Перевірте: ключа немає в базі, темі, JS-файлах і репозиторії. Типова помилка: зберегти ключ в опціях WordPress у відкритому вигляді або вставити у скрипт віджета.
  4. Плагін із функцією виклику API. Створіть файл плагіна з функцією dg_claude_request(). Перевірте: тестовий виклик через WP-CLI (wp eval) повертає текст, а не помилку. Типова помилка: не вказати anthropic-version чи max_tokens — API поверне помилку 400.
  5. REST-маршрут для чату. Фронтенд звертається до вашого /wp-json/dg/v1/chat, а не до Anthropic. Перевірте: запит без nonce відхиляється, а 21-й запит за годину з одного IP отримує 429. Типова помилка: забути, що API не зберігає історію, і чат «забуває» контекст.
  6. Генерація описів товарів. Функція бере характеристики з WooCommerce і пише результат у чернетку. Перевірте: на 10 різних товарах немає вигаданих параметрів. Типова помилка: писати відповідь одразу в опис товару на живому сайті.
  7. Передзапускова перевірка. Зробіть резервну копію, протестуйте помилки API (вимкніть ключ на хвилину) і додайте в політику конфіденційності пункт про AI-чат. Перевірте: при збої користувач бачить зрозуміле повідомлення, а не білий екран. Типова помилка: запускатися без копії та без плану відкату; про це — у матеріалі про резервне копіювання WordPress.
Читайте також:  Claude Code: як користуватися і не зламати проєкт

Ніколи не вставляйте ключ у клієнтський JavaScript чи шаблон теми. Будь-хто побачить його в коді сторінки й витратить ваш баланс. Ключ має жити лише на сервері.

Код плагіна: виклик API, ключ, кеш і ліміт витрат

Спочатку додайте у wp-config.php (до рядка «That’s all, stop editing») такі константи. Ключ краще брати зі змінної середовища хостингу, якщо така опція є.

define( 'DG_CLAUDE_KEY', 'sk-ant-ваш-ключ' );
define( 'DG_CLAUDE_MODEL', 'ідентифікатор-моделі-з-документації' );

Тепер основна функція плагіна. Вона надсилає POST на https://api.anthropic.com/v1/messages з обов’язковими заголовками x-api-key, anthropic-version і content-type, а в тілі передає model, max_tokens, system та масив messages. Для читабельності відступи опущено.

<?php
/* Plugin Name: DiGrand Claude Bridge */
defined( 'ABSPATH' ) || exit;
define( 'DG_SYSTEM', 'Ти помічник інтернет-магазину. Відповідай українською, коротко й лише за наданими даними. Якщо відповіді немає, запропонуй написати менеджеру.' );
function dg_claude_request( $messages, $system, $max_tokens = 500, $cache = false ) {
if ( ! defined( 'DG_CLAUDE_KEY' ) ) { return new WP_Error( 'no_key', 'Ключ не задано' ); }
$ck = 'dg_cl_' . md5( wp_json_encode( array( $messages, $system ) ) );
if ( $cache && ( $hit = get_transient( $ck ) ) ) { return $hit; }
$day = 'dg_calls_' . gmdate( 'Ymd' );
$calls = (int) get_option( $day, 0 );
if ( $calls >= 300 ) { return new WP_Error( 'limit', 'Денний ліміт запитів вичерпано' ); }
$body = array( 'model' => DG_CLAUDE_MODEL, 'max_tokens' => $max_tokens, 'system' => $system, 'messages' => $messages );
for ( $i = 0; $i < 3; $i++ ) {
$r = wp_remote_post( 'https://api.anthropic.com/v1/messages', array(
'timeout' => 45,
'headers' => array( 'x-api-key' => DG_CLAUDE_KEY, 'anthropic-version' => '2023-06-01', 'content-type' => 'application/json' ),
'body' => wp_json_encode( $body ),
) );
if ( is_wp_error( $r ) ) { return $r; }
$code = wp_remote_retrieve_response_code( $r );
if ( in_array( $code, array( 429, 529 ), true ) ) { sleep( 2 ** $i ); continue; }
break;
}
if ( 200 !== $code ) { return new WP_Error( 'api_error', 'Код відповіді: ' . $code ); }
$data = json_decode( wp_remote_retrieve_body( $r ), true );
$text = $data['content'][0]['text'] ?? '';
update_option( $day, $calls + 1, false );
if ( $cache && $text ) { set_transient( $ck, $text, 7 * DAY_IN_SECONDS ); }
return $text;
}

Що тут важливо. Помилки 429 (перевищено ліміт запитів або токенів) і 529 (сервіс перевантажений) обробляються повтором із паузою 1, 2 і 4 секунди. Це базова експоненційна затримка, яку рекомендує й документація про rate limits. Таймаут 45 секунд потрібен, бо відповідь довгого тексту може генеруватися кілька секунд, а стандартні 5 секунд wp_remote_post() для цього замало.

Кеш працює через transient: однаковий запит з однаковою інструкцією не йде в API вдруге. Для описів товарів це корисно при повторному запуску, для чату кеш вимкнений, бо там кожна розмова унікальна. Денний лічильник у 300 запитів — це аварійний запобіжник: якщо щось зациклилося, рахунок не виросте безкінечно. Значення підберіть під свій трафік.

Перевірте після цього кроку: викличте функцію через WP-CLI та отримайте текст. Потім повторіть той самий виклик із $cache = true і переконайтеся, що друга відповідь приходить миттєво й лічильник не збільшився.

Паузи sleep() блокують PHP-процес. Для масової генерації не викликайте функцію в циклі під час відкриття сторінки: ставте завдання в чергу (WP-Cron чи Action Scheduler) і обробляйте по кілька штук за раз.

Чат-бот на сайті: REST-маршрут, історія діалогу й захист від зловживань

Браузер не має знати про Anthropic. Він звертається до вашого REST-маршруту, а сервер додає ключ і викликає Claude. Маршрут реєструють через register_rest_route() із перевіркою nonce, а кількість запитів обмежують за IP.

Claude API не зберігає історію розмови, тому її тримаємо самі: у transient за ідентифікатором сесії (для прототипу цього досить, для продакшена краще окрема таблиця). У кожному запиті передаємо всю недавню історію. Зберігаємо лише останні 7 повідомлень, щоб не платити за зайві токени й щоб масив починався з ролі user.

add_action( 'rest_api_init', function () {
register_rest_route( 'dg/v1', '/chat', array(
'methods' => 'POST',
'callback' => 'dg_chat_handler',
'permission_callback' => function ( $req ) { return (bool) wp_verify_nonce( $req->get_header( 'X-WP-Nonce' ), 'wp_rest' ); },
) );
} );
function dg_chat_handler( $req ) {
$rk = 'dg_rl_' . md5( $_SERVER['REMOTE_ADDR'] ?? '' );
$n = (int) get_transient( $rk );
if ( $n >= 20 ) { return new WP_REST_Response( array( 'error' => 'Забагато запитів, спробуйте пізніше' ), 429 ); }
set_transient( $rk, $n + 1, HOUR_IN_SECONDS );
$text = sanitize_text_field( mb_substr( (string) $req->get_param( 'message' ), 0, 500 ) );
$sid = sanitize_key( (string) $req->get_param( 'sid' ) );
if ( '' === $text || '' === $sid ) { return new WP_REST_Response( array( 'error' => 'Порожній запит' ), 400 ); }
$h = get_transient( 'dg_h_' . $sid );
if ( ! is_array( $h ) ) { $h = array(); }
$h[] = array( 'role' => 'user', 'content' => $text );
$h = array_slice( $h, -7 );
$out = dg_claude_request( $h, DG_SYSTEM, 400 );
if ( is_wp_error( $out ) || '' === $out ) { return new WP_REST_Response( array( 'error' => 'Сервіс тимчасово недоступний' ), 503 ); }
$h[] = array( 'role' => 'assistant', 'content' => $out );
set_transient( 'dg_h_' . $sid, $h, 2 * HOUR_IN_SECONDS );
return array( 'reply' => $out );
}

На фронтенді підключіть невеликий скрипт і передайте йому адресу та nonce через wp_localize_script(). Сам запит виглядає так:

fetch( dgChat.url, { method: 'POST', headers: { 'Content-Type': 'application/json', 'X-WP-Nonce': dgChat.nonce }, body: JSON.stringify( { message: text, sid: sid } ) } ).then( r => r.json() ).then( d => show( d.reply || d.error ) );

Тут sid — випадковий рядок, який скрипт генерує при першому відкритті чату. Якщо сайт стоїть за повним кешем сторінок, nonce може застаріти: тоді віддавайте його окремим некешованим запитом.

Читайте також:  Claude Code: як користуватися і не зламати проєкт

Як зробити, щоб бот відповідав за даними вашого сайту

Повноцінний RAG потребує пошуку по базі знань, але для більшості малих сайтів вистачає простішого підходу. Короткі правила доставки, оплати, повернення та контакти вставляють у system-інструкцію. Для великої бази перед викликом знаходять 3–5 релевантних фрагментів (пошуком WordPress або векторним індексом) і додають їх у запит. У system-промпті завжди пропишіть: «Якщо в наданих даних немає відповіді, скажи про це й запропонуй зв’язатися з менеджером». Це головний захист від вигаданих умов доставки чи гарантії.

Приватність і чесність із користувачем

Усе, що відвідувач пише в чат, потрапляє до API. Тому над полем введення напишіть, що відповідає AI, і попросіть не вводити паспортні дані, номери карток та інші персональні дані. У політику конфіденційності додайте пункт про обробку повідомлень сторонньою AI-службою. Захист самого сайту від злому — окрема тема, яку розбирає чекліст із 12 пунктів.

Описи товарів WooCommerce: генерація й перевірка перед публікацією

Принцип простий: Claude не вигадує товар, він оформлює дані, які ви йому дали. Беріть назву, атрибути WooCommerce і, за наявності, ваші нотатки. Результат кладіть у службове поле чернетки, а менеджер переносить його в опис після перегляду. WooCommerce дає для цього CRUD-клас WC_Product, а записати готовий текст можна й через REST API магазину.

Чекліст перевірки AI-опису товару перед публікацією
Що перевірити в описі перед публікацією
function dg_product_draft( $id ) {
$p = wc_get_product( $id );
if ( ! $p ) { return false; }
$facts = array( 'Назва: ' . $p->get_name() );
foreach ( $p->get_attributes() as $name => $attr ) {
$facts[] = wc_attribute_label( $name ) . ': ' . $p->get_attribute( $name );
}
$system = 'Ти копірайтер інтернет-магазину. Пиши українською, 100–140 слів, без HTML. Використовуй лише надані характеристики. Якщо даних бракує, нічого не вигадуй і не обіцяй гарантій.';
$msg = array( array( 'role' => 'user', 'content' => implode( PHP_EOL, $facts ) ) );
$out = dg_claude_request( $msg, $system, 600, true );
if ( is_wp_error( $out ) || '' === $out ) { return false; }
update_post_meta( $id, '_dg_ai_draft', wp_kses_post( $out ) );
return true;
}

Запускайте функцію з адмінки кнопкою «Згенерувати чернетку» або чергою. На сторінці редагування товару виведіть чернетку поруч із полем опису й кнопку «Затвердити», яка копіює текст у post_content. Приклади гарного промпта й структури тексту є в матеріалі про описи для картки товару, а підхід до промпта для Claude той самий.

Спершу протестуйте промпт на 10–20 товарах із різних категорій на найдешевшій моделі. Якщо якість влаштовує, переходьте до всього каталогу. Дорожчу модель беріть лише для категорій, де Haiku помиляється.

Автоперевірка перед показом менеджеру

Частину помилок ловить код ще до перегляду людиною. Відхиляйте чернетку, якщо:

  • у тексті є числа (розміри, вага, об’єм, потужність), яких немає у вхідних характеристиках;
  • довжина виходить за діапазон 80–180 слів;
  • є слова-обіцянки на кшталт «найкращий», «гарантовано», «№1», якщо їх немає у ваших даних;
  • текст містить HTML, посилання або англійські фрагменти, яких не було у вхідних даних.

Після автоперевірки текст читає людина: вибірково, 10–20% чернеток, а для нових категорій — усі. Дивіться на галюцинації (вигадані матеріали, сумісність, сертифікати), мовні помилки та однакові початки в сусідніх товарів. Для SEO ключове те саме, що й завжди: опис має бути корисним, точним і не повторювати сотню разів один шаблон. Не обіцяйте собі позицій в Google від самого факту генерації: якість визначає перевірка.

Читайте також:  Claude Code: як користуватися і не зламати проєкт

Не публікуйте AI-описи автоматично. Одна вигадана характеристика («водонепроникний», «сумісний з iPhone 15») може обернутися поверненнями й суперечкою із клієнтом, а відповідальність лежить на магазині.

Для великих каталогів дивіться на Message Batches API: він обробляє запити асинхронно приблизно за половину звичайної вартості, що підходить, коли описи не потрібні за секунду. А prompt caching здешевлює довгі повторювані частини промпта, як-от інструкцію зі стилем бренду. Обидва механізми описані в документації Anthropic, і вони доповнюють, а не замінюють transient-кеш із коду вище.

Скільки це коштує і як не вийти за бюджет

API тарифікується за токенами, окремо за вхідні й вихідні, і ціна залежить від моделі. Актуальні ставки дивіться на сторінці цін Anthropic. Українська мова зазвичай «важить» більше токенів, ніж англійська, тому закладайте запас.

Формула для оцінки: вартість = (вхідні токени ÷ 1 000 000 × ціна за вхід) + (вихідні токени ÷ 1 000 000 × ціна за вихід). Приклад обсягів: каталог із 1 000 товарів, на кожен близько 300 вхідних токенів (інструкція та характеристики) і близько 250 вихідних. Разом це приблизно 300 тисяч вхідних і 250 тисяч вихідних токенів. Підставте ціни обраної моделі з офіційної сторінки й отримаєте реальну суму, а не здогадку. Це оцінка порядку величин, точні токени покаже поле usage у відповіді API.

Запобіжник Де налаштовується Від чого захищає
Ліміт витрат Anthropic Console Неконтрольований рахунок
Денний лічильник запитів Код плагіна Зациклення й помилки в логіці
Ліміт запитів за IP REST-маршрут Спам і зловмисне використання чату
max_tokens і обмеження довжини повідомлення Код плагіна Надто довгі й дорогі відповіді
Кеш і batches transient, Batches API, prompt caching Повторна оплата однакових запитів

Окремо стежте за лімітами рівня (tier) акаунта: при перевищенні API відповідає 429. Для чату це означає зрозуміле повідомлення користувачу, для масової генерації — чергу й повільніший темп. Нагружений чат також навантажує сервер, тож перегляньте швидкодію сайту до запуску.

З чого почати цього тижня

Зробіть мінімум: резервна копія, ключ у wp-config.php, плагін із функцією dg_claude_request() і тестовий виклик. Потім увімкніть чат лише для себе й команди на кілька днів, перегляньте реальні діалоги та доповніть system-інструкцію. Описи товарів запускайте партіями по 20–50 штук із ручною перевіркою. Якщо хочете прискорити запуск, команда DiGrand може впровадити AI-чат чи генерацію контенту на вашому WordPress або WooCommerce, а також допомогти з безпекою, лімітами та перевіркою якості. Для розробників, які працюють із кодом за допомогою AI, корисним буде й матеріал про Claude Code.

Поширені запитання

Чи можна підключити Claude API до WordPress без плагіна?

Так. Достатньо додати ключ у wp-config.php і викликати https://api.anthropic.com/v1/messages через вбудовану функцію wp_remote_post(). Свій мінімальний плагін або код у mu-plugins — найчистіший спосіб, бо не залежить від сторонніх розширень.

Чи можна викликати Claude API прямо з JavaScript на сторінці?

Ні. Ключ у клієнтському коді бачить кожен відвідувач, і ним можуть скористатися за ваш рахунок. Зробіть власний REST-маршрут у WordPress, перевіряйте nonce, обмежуйте запити за IP і викликайте Claude лише з сервера.

Чому чат-бот забуває, що було раніше в розмові?

Claude API не зберігає історію: кожен запит незалежний. Історію діалогу зберігайте самі (transient, сесія або база даних) і передавайте в масиві messages у кожному запиті, обмеживши довжину, щоб не платити за зайві токени.

Як згенерувати описи для всього каталогу WooCommerce і не розоритися?

Беріть малу модель (серія Haiku), пишіть результат у чернетку, а не одразу в опис, і запускайте чергою. Для великих обсягів, де терміновість не потрібна, використовуйте Message Batches API: він дешевший приблизно вдвічі. Заздалегідь пораховайте токени за формулою зі статті.

Чи працює Claude API в Україні і як платити?

Доступність залежить від списку підтримуваних країн і умов оплати Anthropic, які змінюються. Перевірте актуальний список на офіційній сторінці й перегляньте, які способи оплати приймає Console для вашого акаунта, перш ніж будувати на цьому проєкт.

Залишити відповідь

Ваша e-mail адреса не оприлюднюватиметься. Обов’язкові поля позначені *