Інтеграції робочих процесів електронної пошти та SDK

Завантажити спільний ZIP для WordPress та WooCommerce

1. Встановлення

Виконайте ці команди з каталогу WordPress за допомогою доступного WP-CLI або завантажте завантажений ZIP-архів через Плагіни > Додати новий > Завантажити плагін і активуйте його. Відкрийте Параметри > SendRepute. Налаштуйте та активуйте кожен сайт окремо в мережі multisite. Використовуйте підтримувану комбінацію WordPress/PHP; мінімальна версія не є рекомендацією для запуску програмного забезпечення, термін підтримки якого закінчився.

curl -fLO https://www.sendrepute.com/downloads/sendrepute-wp.zip
wp plugin install ./sendrepute-wp.zip --activate

Альтернатива: встановлення з публічного коду

Використовуйте цей шлях до вихідного коду замість інструкцій із завантаження на веб-сайті вище. README репозиторію пояснює решту кроків активації та налаштування; створення лише ZIP-архіву не встановлює плагін. Для Python друга команда додає опціональну підтримку Django. Зберігайте облікові дані в секретах сервера та ознайомтеся з нотатками про безпеку перед увімкненням платних функцій. Тільки Node є в npm; публічний репозиторій GitHub не означає публікацію на WordPress.org, n8n Cloud, Packagist або PyPI.

git clone https://github.com/sendrepute/sendrepute-wordpress.git
cd sendrepute-wordpress
python3 package.py

2. Безпечне налаштування

Створіть клієнтський токен на стороні сервера з дозволами classify, account:read та catalog:read, терміном дії та лімітами витрат. Введіть його в налаштуваннях або завантажте SENDREPUTE_API_TOKEN з вашого сховища секретів сервера, як показано. Збережені токени використовують автентифіковане шифрування з солями WordPress та OpenSSL; введіть їх повторно після ротації солей. Запустіть безкоштовну перевірку з'єднання, перегляньте ціни на класифікацію, а потім явно увімкніть автоматичний аналіз. Встановіть консультативний/блокуючий режим, поріг та незалежну політику fail-open/fail-closed.

// wp-config.php — optional server-secret alternative to settings storage.
$sendreputeToken = getenv('SENDREPUTE_API_TOKEN');
if (is_string($sendreputeToken) && $sendreputeToken !== '') {
    define('SENDREPUTE_API_TOKEN', $sendreputeToken);
}

3. Свідоме використання

Функція нижче використовує звичайний wp_mail і надсилає повідомлення лише тоді, коли ваш застосунок викликає її. Якщо увімкнено платний аналіз, плагін аналізує на етапі pre_wp_mail, а потім дозволяє або блокує існуючий транспорт. Вкажіть власного авторизованого одержувача; спочатку протестуйте на локальному поштовому приймачі без ретрансляції. Негативний результат означає, що сторона, яка викликає, повинна обробити відхилене надсилання — воно не ставиться в чергу.

// Call deliberately: this sends through your existing WordPress transport.
function sendrepute_reviewed_message($recipient) {
    return wp_mail(
        $recipient,
        'Your requested account summary',
        'Here is the account summary you requested.'
    );
}

Що ще він може робити?

Налаштування також надають доступ до ручних дій AI-перезапису та генерації шаблонів з окремим платним підтвердженням. Для відображення цін потрібен vip:read; для перезапису — rewrite; для генерації — ai:generate, а для VIP-генерації потрібне активне членство VIP. Результати є екранованим текстом тільки для копіювання: вони ніколи не застосовуються і не надсилаються автоматично. Існуючі токени не отримують дозволи автоматично.

Результати, помилки та ліміти

Рекомендаційний режим дозволяє доставку; режим блокування порівнює кінцеву ймовірність спаму з вашим порогом. Тайм-аути API та збої слідують окремій політиці відмов, а не мітці спаму. Непрозорі локальні блокування пригнічують повторний аналіз на 24 години; невідомі мережеві результати не повторюються автоматично. Самі відправлення не дедуплікуються. Перевірки встановлених оновлень охоплювали відстежуваний 0.1.0 ZIP, оновлений до 0.2.0, відхилення/збереження nonce адміністратора та обраний шлях WooCommerce. Окрема матриця з 40 сценаріїв охоплювала обидва порядки завантаження плагінів з WP Mail SMTP та FluentSMTP, включаючи To/Cc/Bcc, Reply-To, заголовки, вкладення, відхилення SMTP та результати політики. Ці точні кортежі не сертифікують інші версії CMS, SMTP-плагінів або провайдерів. Хуки, що обходять wp_mail, та подальші зміни транспорту залишаються поза зоною покриття. Деактивація зберігає налаштування; видалення стирає облікові дані, навіть якщо збережено вимкнені налаштування. Видаліть токен wp-config самостійно.

Адаптер електронної пошти WooCommerce

0.2.0

Включено в той самий ZIP-архів SendRepute 0.2.0, що і плагін WordPress; окремого доповнення або завантаження для WooCommerce немає. Потрібне дотримання базових вимог плагіна: WordPress 5.7+, PHP 7.4+ та OpenSSL. Адаптер пройшов перевірку вихідного коду на відповідність WooCommerce 10.4.3, але не сертифікований для кожної версії WooCommerce або розширень пошти.

Аналіз WooCommerce має власний перемикач адміністратора та точний вибір вбудованих типів електронної пошти, які за замовчуванням вимкнені. Глобальні елементи керування аналізом та згодою на оплату також мають бути увімкнені. Невибрані типи та типи, визначені розширеннями, обходять аналіз. Кожен вибраний вбудований тип customer_* захищений і має лише рекомендаційний характер: він може бути проаналізований, але ніколи не блокується. Вибрана пошта multipart не проходить класифікацію перед будь-яким платним запитом; консультативний режим або fail-open зберігає доставку, тоді як fail-closed блокує лише незахищену пошту.

Завантажити ZIP для Drupal

1. Встановлення

Це той самий інсталяційний ZIP-архів, який використовується в посібнику WordPress. Встановіть його один раз; не встановлюйте другий додаток WooCommerce. Активуйте SendRepute, потім відкрийте Settings > SendRepute. Підтримуйте WordPress, WooCommerce, PHP та реальний транспорт пошти оновленими.

curl -fLO https://www.sendrepute.com/downloads/sendrepute-wp.zip
wp plugin install ./sendrepute-wp.zip --activate

Альтернатива: встановлення з публічного коду

git clone https://github.com/sendrepute/sendrepute-wordpress.git
cd sendrepute-wordpress
python3 package.py

2. Безпечне налаштування

Використовуйте токен customer з обмеженою областю дії із секретів сервера або зашифрованих налаштувань WordPress. Спочатку налаштуйте спільну безкоштовну перевірку з'єднання, перегляд поточної ціни, глобальну згоду на платний аналіз, режим ризику, поріг та політику відмов. Потім окремо увімкніть аналіз WooCommerce та виберіть лише вбудовані типи електронної пошти, які ви перевірили. Типи, визначені розширеннями, ніколи не вибираються автоматично.

// wp-config.php — keep the shared WordPress/WooCommerce token server-side.
$sendreputeToken = getenv('SENDREPUTE_API_TOKEN');
if (is_string($sendreputeToken) && $sendreputeToken !== '') {
    define('SENDREPUTE_API_TOKEN', $sendreputeToken);
}

3. Свідоме використання

Продовжуйте надсилати через WooCommerce як зазвичай. Адаптер огортає зворотний виклик, уже обраний WooCommerce, і зберігає його оригінальні аргументи та транспорт; він не надає нового методу send. Якщо інший фільтр змінює аргументи зворотного виклику, звичайна пошта вкладена під час цього виклику, або кастомний зворотний виклик ніколи не викликає wp_mail, аналіз консервативно пропускається, а не потрапляє в загальний платний шлях. Протестуйте вибрані некритичні типи за допомогою поштової скриньки без ретрансляції.

Результати, помилки та ліміти

Вибрана однокомпонентна пошта слідує спільним для WordPress політиці рекомендаційного режиму, порогу та політиці відмов, за винятком того, що кожен тип customer_* є захищеним і працює лише в рекомендаційному режимі. Захищена пошта клієнтів завжди продовжує надсилання після результату з високим ризиком, збою API або виявлення непідтримуваного вмісту. WooCommerce створює багатокомпонентні альтернативи після pre_wp_mail, тому вибрана багатокомпонентна пошта видає помилку перед будь-яким платним запитом замість того, щоб бути частково класифікованою; тільки вибрана незахищена пошта може бути відхилена політикою fail-closed. Контекст зворотного виклику видаляється після успіху, відмови та вкладених відправлень.

Поштовий бекенд Drupal

0.1.0

Потрібна версія Drupal 10.3+ або 11.x та PHP 8.1+. Встановіть ZIP-архів як модуль, надайте дозвіл administer sendrepute лише довіреним адміністраторам, налаштуйте обмежене неадресне відображуване ім'я відправника та виберіть точні маршрути пошти для модуля/ключа. Версія 0.1.0 підтримує лише Drupal core php_mail; це Mail бекенд, а не провайдер чи транспорт на заміну. Підтверджена працездатність охоплює точні релізи Drupal 10.6.17 та 11.4.7 з PHP 8.4.10.

Згода на оплату та кожен маршрут вимкнені за замовчуванням. Кожен точний маршрут використовує фіксований делегат php_mail ядра, консультативний режим або режим блокування, незалежну політику відмови збереження (preserve) або блокування (block), поріг та усвідомлений вибір критичної пошти. Пошта облікових записів та безпеки залишається доставленою, якщо цей точний маршрут явно не дозволяє критичне блокування. Той самий екземпляр php_mail форматує та надсилає одне скалярне фінальне тіло; multipart та вивід з вкладеннями не підтримуються.

Завантажити ZIP для PrestaShop

1. Встановлення

Запустіть із кореневого каталогу проекту Drupal або завантажте ZIP-архів за допомогою інсталятора модулів Drupal. Архів містить корінь модуля sendrepute, придатний для modules/contrib. Увімкніть його, надайте дозвіл administer sendrepute лише довіреним адміністраторам і відкрийте Configuration > System > SendRepute.

curl -fLO https://www.sendrepute.com/downloads/sendrepute-drupal.zip
unzip sendrepute-drupal.zip -d modules/contrib
drush en sendrepute -y

Альтернатива: встановлення з публічного коду

git clone https://github.com/sendrepute/sendrepute-drupal.git
cd sendrepute-drupal

2. Безпечне налаштування

Зберігайте SENDREPUTE_API_TOKEN з областю дії classify лише в середовищі процесу web/PHP. Він ніколи не приймається формою і не експортується в конфігурацію Drupal. У формі введіть обов'язкове відображуване ім'я відправника розміром не більше 320 байтів без адреси, кутових дужок або керуючих символів. Додайте один семиполівний рядок на кожен точний маршрут, як показано; делегатом має бути php_mail. Виберіть режим advisory/block, політику відмов preserve/block, поріг та критичність yes/no. Почніть з advisory, preserve та no.

export SENDREPUTE_API_TOKEN="replace-with-a-scoped-server-token"
# Enter a non-address sender display name in Configuration > System > SendRepute.
# One exact route in Configuration > System > SendRepute:
# contact|page_mail|php_mail|advisory|preserve|0.90|no

3. Свідоме використання

Продовжуйте використовувати звичайний менеджер пошти Drupal. Для обраного маршруту sendrepute_mail викликає format() ядра php_mail, аналізує це фінальне скалярне тіло, застосовує політику, а потім викликає mail() того самого кешованого екземпляра php_mail. Інші ідентифікатори делегатів відхиляються. Він не використовує hook_mail_alter і не переписує повідомлення.

Результати, помилки та ліміти

Підтверджений успіх блокує лише на рівні або вище налаштованого порогу в режимі блокування. Повний вкладений результат класифікації та відповідь білінгу перевіряються до того, як spamProbability зможе вплинути на доставку. Помилки API, автентифікації, балансу, обмеження швидкості, некоректні формати, багатокомпонентні дані, індикатори вкладень та розміру слідують незалежній політиці відмов маршруту, за винятком захищеної критичної пошти, яка продовжує відправку. Матриця встановлених 10.6.17/11.4.7 охоплювала встановлення та заміну ZIP на місці під час роботи, реальний вхід адміністратора, відхилення/збереження Form API CSRF, виявлення плагінів, підключення маршрутів, синтетичну класифікацію, збереження критичної пошти та ядро php_mail через локальний стік. Базові перевірки вихідного коду також охоплюють незмінні архіви 10.3.0 та 11.0.0; жоден результат не сертифікує кожне наступне виправлення або сторонній мейлер. Надсилаються налаштоване відображуване ім'я, непорожня тема та обмежене за довжиною тіло; адреси, одержувачі, заголовки, параметри та вкладення виключаються. Тема обмежена 998 байтами, а тіло — 256 KiB. Виконується одна спроба з перевіркою HTTPS, без перенаправлень, повторів або черг.

Поштовий модуль PrestaShop

0.1.1

Версія 0.1.1 підтримує виключно PrestaShop 9.0.0, 9.0.1, 9.0.2 та 9.0.3 з PHP 8.1–8.4. Завантажте ZIP-архів у Модулі > Менеджер модулів, після чого налаштуйте класифікацію пошти SendRepute. Усі чотири офіційні попередньо зібрані classic релізи пройшли перевірку ізольованого встановлення, автентифікованого налаштування адміністратором та оновлення через ZIP; їх незмінені реалізації Mail::send() також пройшли офлайн-матрицю реальної пошти. PrestaShop 8, 9.1+ та пізніші неперелічені патчі 9.0 не підтримуються.

Модуль, згода на оплату/вміст та точний вибір шаблону вимкнені за замовчуванням. Він аналізує остаточно згенеровану тему та кожен підтримуваний відображуваний текст без повторного збирання повідомлення Symfony. Повідомлення, що містить як text/plain, так і text/html, надсилається в одному обмеженому запиті на класифікацію: текстова альтернатива стає інертною, оригінальний HTML зберігається, а сервіс аналізує кожну типізовану альтернативу незалежно без об'єднання. Результат використовує найвищий ризик із повними аудитами вмісту, створює одну платну класифікацію та ніколи не повертає частковий бал безпеки. Консультативний режим ніколи не перериває відправлення. Блокування за порогом та fail-closed генерують виняток, що реалізує як ExceptionInterface від Symfony Mailer, так і ModuleErrorInterface від PrestaShop; на кожному підтримуваному релізі під час тестування спостерігалося, що Mail::send() повертає false без доставки через SMTP. Політика відмов не залежить від порогу ризику.

Завантажити ZIP з вихідним кодом Symfony

1. Встановлення

Завантажте ZIP-архів версії 0.1.1, потім скористайтеся розділом Modules > Module Manager > Upload a module і виберіть його. Відкрийте Configure для класифікації пошти SendRepute. Не примушуйте до встановлення поза межами точних версій PrestaShop 9.0.0–9.0.3: поведінка скасування та підпису залежить від проаудитованих шляхів Mail::send().

curl -fLO https://www.sendrepute.com/downloads/sendrepute-prestashop.zip

Альтернатива: встановлення з публічного коду

git clone https://github.com/sendrepute/sendrepute-prestashop.git
cd sendrepute-prestashop

2. Безпечне налаштування

Встановіть SENDREPUTE_API_BASE на канонічний продакшн-хост SendRepute HTTPS, наданий для цього модуля, а SENDREPUTE_API_TOKEN — на серверний токен з обмеженою областю дії в середовищі PHP-FPM/сервера. База повинна бути публічним DNS HTTPS хостом без шляху; літерали, облікові дані, перенаправлення та приватні DNS-відповіді відхиляються. Запустіть безкоштовну перевірку з'єднання облікового запису/ціни, потім явно увімкніть модуль, згоду на платний аналіз/контент та точні назви шаблонів. Виберіть режими advisory/block, поріг та політику відмов open/closed незалежно.

export SENDREPUTE_API_BASE="replace-with-the-canonical-sendrepute-https-origin"
export SENDREPUTE_API_TOKEN="replace-with-a-scoped-server-token"

3. Свідоме використання

Продовжуйте використовувати звичайний потік Mail::send у PrestaShop. Початковий хук лише запам'ятовує обраний точний шаблон. Фінальний хук зчитує вже згенеровану тему Symfony Email, текстове тіло та тіло HTML, не змінюючи отримувачів, заголовки, вкладення або транспорт. Для подвійних тіл він надсилає інертний звичайний текст і оригінальний HTML як типізовані альтернативи в одному запиті; незалежна нормалізація сервісу запобігає поглинанню одного фрагмента іншим, зберігаючи видимі посилання HTML та адреси зображень для аудиту. Одне текстове тіло залишається на вузькому шляху інертного тексту, а одне тіло HTML — на вузькому шляху вилучення DOM. Класифікація завершується до того, як PrestaShop створить окреме повідомлення з підписом DKIM. Матриця підтримуваних релізів перевірила випромінювану багатокомпонентну структуру, а також хеш тіла DKIM і підпис RSA після класифікації. Закріплений шлях підпису PrestaShop пропускає Bcc з підготовлених підписаних заголовків і втрачає цього прихованого одержувача SMTP; тому докази валідності підпису не підтверджують сумісність доставки Bcc. Не поєднуйте DKIM та Bcc на цьому підтримуваному шляху. Непідтримувані джерела відображення, активна семантика, неоднозначний quoted-printable або base64 HTML, а також надмірний сукупний вміст підпорядковуються налаштованій політиці відмов перед оплатою. Залишайте критичні шаблони невибраними, якщо вони не схвалені навмисно.

Результати, помилки та ліміти

Класифікатор приймає одне тіло text/plain, одне тіло text/html або обидва як незалежно проаналізовані альтернативи відображення. Буквальний текст, сутності, прихований контент та стилі в прийнятій альтернативі не можуть поглинути або приховати наступну альтернативу; неоднозначний quoted-printable або base64 HTML відхиляється перед оплатою. Будь-яка прийнята альтернатива може визначити результат з найвищим ризиком, тоді як аудит вмісту охоплює кожну альтернативу; класифікація оплачується лише один раз після прийняття повного обмеженого вводу. Необхідне застаріле тіло точно дублює інертну текстову альтернативу для подвійного повідомлення, і цей дублікат разом з обома типізованими альтернативами поділяють точний бюджет запиту у 524288 байт. Отримувачі, вкладення та вбудовані ресурси виключаються, а оригінальне транспортне повідомлення перед підписом зберігається. Фікстура реальної пошти окремо перевіряє цілісність MIME/підпису та фактичних отримувачів SMTP: підписи DKIM залишаються валідними після класифікації, але проаудитований висхідний підписаний шлях не зберігає отримувачів Bcc. Валідована класифікація зберігає обмежене останнє консультативне резюме. Режим блокування спрацьовує лише на рівні порогу або вище; виняток подвійного інтерфейсу виживає після диспетчеризації хука і повертає false перед транспортуванням на всіх чотирьох встановлених релізах. Непідтримуваний вміст, помилки API та валідації дотримуються політики відкрито/закрито незалежно. Одна спроба HTTPS використовує закріплений публічний DNS, перевірений TLS, скінченні таймаути, ліміт відповіді 256 KiB, відсутність редіректів та повторів. Блокування покладається на проаудитоване перехоплення винятків PrestaShop Mail::send(), а не на значення, що повертається фінальним хуком.

Адаптер Symfony Mailer

0.1.1

Потребує PHP 8.1+ і орієнтований лише на Symfony Mailer 6.4 або 7.4; точними перевіреними версіями є 6.4.46 та 7.4.19. Сумісність із Symfony 8.1 або неперевіреними лінійками не гарантується. Встановіть локальний ZIP-архів через репозиторій Composer path; цей пакет не опубліковано в Packagist.

Бандл та згода на оплату вимкнені за замовчуванням, і обробляються лише повідомлення з точно налаштованим заголовком згоди. Політика оцінювання (консультативна або блокуюча) не залежить від політики відмов (allow або block). Класифікація виконується під час офіційного MessageEvent перед відправкою; для відхилення використовується MessageEvent::reject(). Події клонування в черзі ігноруються, тому подія транспорту воркера є єдиною точкою платної класифікації.

Завантажити вихідний код Rails у ZIP

1. Встановлення

Розпакуйте завантажений ZIP у папку для збережених пакетів, зареєструйте цю директорію як репозиторій Composer path, здійсніть require версії 0.1.1 та зареєструйте SendRepute\Symfony\SendReputeBundle, якщо Flex не зробить цього автоматично. Вихідний архів є локальним та непублічним.

mkdir -p packages
curl -fL https://www.sendrepute.com/downloads/sendrepute-symfony.zip -o packages/sendrepute-symfony.zip
unzip packages/sendrepute-symfony.zip -d packages
composer config repositories.sendrepute path ./packages/sendrepute-symfony
composer require sendrepute/symfony:0.1.1

Альтернатива: встановлення з публічного коду

git clone https://github.com/sendrepute/sendrepute-symfony.git
cd sendrepute-symfony

2. Безпечне налаштування

Отримайте SENDREPUTE_API_TOKEN із секретів сервера. Залиште параметри enabled та paid_analysis_consent зі значенням false, поки переглядаєте поточні тарифи. Режим, поріг та політика відмов є незалежними. Ендпоінт жорстко обмежений перевіреним HTTPS із визначеними термінами очікування, без перенаправлень чи повторних спроб, а також лімітом відповіді у 1 MiB.

send_repute:
  enabled: false
  paid_analysis_consent: false
  api_token: '%env(SENDREPUTE_API_TOKEN)%'
  mode: advisory
  failure_policy: allow
  spam_probability_threshold: 0.8

3. Свідоме використання

Додайте точний заголовок opt-in лише до перевірених некритичних об'єктів Email, а потім продовжуйте через звичайний Mailer. Повідомлення, конверт, транспорт та заголовок не перезаписуються. Для доставки через Messenger налаштуйте бандл у workers: події клонування producer навмисно не класифікуються.

$email->getHeaders()->addTextHeader('X-SendRepute-Classify', 'yes');
$mailer->send($email);

Результати, помилки та ліміти

Підтримується рівно одне тіло text/plain або text/html у пам'яті. Змішані альтернативи, текстові DataParts, потоки або шляхи, фігурні дужки CSS, розмітка, синтаксис quoted-printable, заголовки base64 або Content-Transfer-Encoding: base64 для всього тіла завершуються помилкою до оплати та слідують політиці відмов; звичайний контент без фігурних дужок не змінюється. Кожне обов'язкове вкладене поле відповіді та необов'язкова гілка contentAudit перевіряються, а невідомі властивості відхиляються. Дорадчий режим ніколи не блокує за оцінкою; блокування відхиляє на рівні порогу через реальну подію транспорту.

Адаптер Rails Action Mailer

0.1.0

Потрібна версія Ruby 3.2+; адаптер пройшов вузьку перевірку з реальною Action Mailer 7.1.6 та Mail 2.9.1; шлях зворотного виклику (callback) також спостерігався в Action Mailer 7.2.3.2. Це не є сертифікацією кожного дозволеного релізу Rails 7.x. Встановіть локальний ZIP з кодом через Bundler; публікація в RubyGems не заявляється.

Обидва глобальні платні шлюзи вимкнені за замовчуванням, і кожна дія контролера mailer повинна явно викликати sendrepute_paid_preflight!. Поведінка рекомендаційного/блокуючого бала та поведінка при збої (збереження або блокування) є незалежними. Маршрути для скидання пароля, MFA, входу, верифікації, виставлення рахунків та безпеки повинні залишатися невибраними. Кожне повідомлення з частин (multipart) та неоднозначний вміст CSS, quoted-printable або такий, що схожий на base64, відхиляються до оплати; один прийнятий декодований текстовий або HTML-текст аналізується без зміни вихідного повідомлення чи транспорту.

Завантажити ZIP з вихідним кодом Spring Java

1. Встановлення

Розархівуйте ZIP саме у vendor/sendrepute-rails, додайте запис локального шляху до Gemfile, запустіть Bundler у вашому контрольованому середовищі та включіть SendRepute::Rails::Mailer в ApplicationMailer. Це не є інсталяцією через RubyGems.

# Download sendrepute-rails.zip, then extract it into vendor/sendrepute-rails.
gem "sendrepute-rails", path: "vendor/sendrepute-rails"

Альтернатива: встановлення з публічного коду

git clone https://github.com/sendrepute/sendrepute-rails.git
cd sendrepute-rails

2. Безпечне налаштування

Залишайте enabled та paid_consent зі значенням false, доки не будуть переглянуті поточні ціни та маршрути. Читайте токен із Rails credentials або іншого секрету сервера. Налаштовуйте консультативний/блокуючий режими, збереження/блокування та поріг незалежно; зворотні виклики on_result та on_error не повинні реєструвати вміст повідомлень, дані авторизації або повні відповіді.

SendRepute::Rails.configure do |config|
  config.enabled = false
  config.paid_consent = false
  config.token = Rails.application.credentials.dig(:sendrepute, :api_token)
  config.mode = :advisory
  config.failure_policy = :preserve
  config.score_threshold = 0.8
end

3. Свідоме використання

Викликайте sendrepute_paid_preflight! лише всередині кожної свідомо обраної некритичної дії мейлера. Звичайні дії оминають класифікацію. Платний хук використовує маршрут Action Mailer before_deliver; автоматичне глобальне підключення не надається, і адаптер не переписує Mail::Message.

class ApplicationMailer < ActionMailer::Base
  include SendRepute::Rails::Mailer
end

def newsletter
  sendrepute_paid_preflight!
  mail(to: params[:to], subject: "News")
end

Результати, помилки та ліміти

Підтримується одне декодоване відображуване тіло text/plain або text/html. Будь-які multipart або неоднозначні вхідні дані нормалізатора зазнають невдачі перед оплатою та дотримуються політики відмов. Повна типізована вкладена відповідь може блокувати лише в режимі блокування при досягненні або перевищенні порогового значення; консультативний режим зберігає кожен показник. Зворотні виклики результату та помилки отримують незмінні безпечні дані, а винятки зворотних викликів або throw(:abort) перехоплюються локально, тому вони не можуть перервати консультативний режим або зберегти доставку. Фіксована кінцева точка відмовляє в перенаправленнях і повторних спробах та використовує обмежений загальний дедлайн. Тести на реальному Action Mailer 7.1.6 пройдено: 19 запусків і 59 перевірок; жодного платного запиту або реальної доставки не відбулося.

Адаптер Spring JavaMailSender

0.1.1

Потребує Java 17+ і орієнтований на Spring Framework 6.2.x JavaMailSender; для точної перевірки залежностей використовувався Spring Framework 6.2.19. Претензії щодо Spring Boot 4 або ширшої підтримки версій фреймворку відсутні. Зберіть ZIP-архів з локальним вихідним кодом за допомогою Maven; він не опублікований у Maven Central або інших регістрах.

Декоратор, платна згода, консультативний режим та параметри allow-on-failure за замовчуванням є явними. Лише sendWithSendRepute(...) виконує платний аналіз перед відправкою; кожне звичайне перевантаження send(...) оминає класифікацію та делегує виклик без змін. Використовуйте звичайний send для критично важливої пошти, якщо тільки це окреме відправлення не вибрано навмисно. Підтримувані відображувані MIME-альтернативи інертно скомпоновані разом; непідтримуваний, вкладений, підписаний, зашифрований або неоднозначний контент викличе помилку до здійснення оплати.

Завантажити вихідний ZIP-архів для Magento

1. Встановлення

Розпакуйте ZIP-архів з вихідним кодом версії 0.1.1, виконайте mvn verify та встановіть його виключно у ваш контрольований локальний репозиторій Maven. Клієнтський застосунок надає власний JavaMailSender та поточну реалізацію пошти. Точна перевірка залежностей використовувала байт-код Java 17, Spring Framework 6.2.19 та версії, документовані у доданому файлі README.

curl -fLO https://www.sendrepute.com/downloads/sendrepute-spring-mail.zip
unzip sendrepute-spring-mail.zip
cd sendrepute-spring-mail-0.1.1
mvn verify
mvn install

Альтернатива: встановлення з публічного коду

git clone https://github.com/sendrepute/sendrepute-java.git
cd sendrepute-java

2. Безпечне налаштування

Створіть SendReputeConfiguration на основі серверного токена та явних перемикачів. Залиште параметри enabled та paidAnalysisConsent у значенні false, доки не будуть переглянуті ціни та обрані виклики. Дорадчий/блокуючий режими, поріг та політика відмов дозволити/блокувати є незалежними. Кінцева точка зафіксована на перевіреному HTTPS без перенаправлень або повторних спроб.

var settings = new SendReputeConfiguration(
    token, false, false,
    SendReputeConfiguration.Mode.ADVISORY,
    SendReputeConfiguration.FailurePolicy.ALLOW,
    0.80, Duration.ofSeconds(3), Duration.ofSeconds(10));
var reviewedSender = new SendReputeJavaMailSender(existingSender, settings);

3. Свідоме використання

Викликайте sendWithSendRepute(...) лише для окремих SimpleMailMessage, MimeMessage або MimeMessagePreparator, які мають підлягати аналізу. Підтримуються перевантаження для поодиноких аргументів та varargs. Будь-яке звичайне перевантаження send(...) обходить класифікацію. Preparators виконують рендеринг один раз, і оригінальний підготовлений MIME делегується після дозволу політики.

// Paid classification is possible only on this explicit method.
reviewedSender.sendWithSendRepute(reviewedMessage);

// Every ordinary JavaMailSender send overload bypasses classification.
reviewedSender.send(criticalMessage);

Результати, помилки та ліміти

Аналізуються всі підтримувані відображувані частини plain та HTML; отримувачі та вкладення виключені. Обхід обмежений 16 рівнями, 256 частинами та 524,288 відображуваними байтами UTF-8. Ігноровані вбудовані бінарні дані ніколи не матеріалізуються; невідомі або необмежені ліниві відображувані джерела зазнають невдачі до відкриття потоку або здійснення платного запиту, а читання підтримуваних джерел є обмеженим. Обрамлення числовими сутностями зберігає фрагменти інертними через перевірений порядок нормалізатора сервера. Усі пакети varargs готуються та нормалізуються перед першим платним запитом, а інспекція не генерує заголовки Jakarta Mail. Потрібна рекурсивно точна вкладена відповідь.

Адаптер пошти для Magento Open Source

0.1.1

Підтримує лише Magento Open Source 2.4.7-p5 та 2.4.7-p6 з перевіреними точними незмінними сирцями інтерфейсу пошти. Офлайн типізовані фікстури пройшли перевірку, проте повне встановлення Magento не проводилося; жоден інший реліз Magento або Adobe Commerce не сертифіковано. Встановлюйте локальний ZIP через репозиторій шляху Composer; це не пакет Adobe Marketplace.

Модуль, платна згода та списки маршрутів за замовчуванням вимкнені. Кожен ідентифікатор шаблону вимагає двох незалежних точних погоджень; критичність ніколи не виводиться з його назви. Плагін aroundSendMessage аналізує на межі кінцевого транспорту без перебудови повідомлення. Політики порогових значень advisory/block та політики дій у разі помилки preserve/block є незалежними; блокування викликає видиму Magento MailException. Наявність декількох відображених MIME-частин або неоднозначного вмісту призводить до помилки до здійснення оплати.

Завантажити вихідний ZIP для .NET MailKit

1. Встановлення

Розпакуйте ZIP у збережену директорію пакунків, зареєструйте його корінь SendRepute_MailAdapter як шлях репозиторію Composer, вимагайте версію 0.1.1, потім скористайтеся звичайним процесом увімкнення модуля та оновлення налаштувань Magento. Не представляйте цей локальний архів як пакунок Adobe Marketplace.

mkdir -p packages/sendrepute-magento
curl -fLO https://www.sendrepute.com/downloads/sendrepute-magento.zip
unzip sendrepute-magento.zip -d packages/sendrepute-magento
composer config repositories.sendrepute path ./packages/sendrepute-magento/SendRepute_MailAdapter
composer require sendrepute/magento-mail-adapter:0.1.1
bin/magento module:enable SendRepute_MailAdapter
bin/magento setup:upgrade

Альтернатива: встановлення з публічного коду

git clone https://github.com/sendrepute/sendrepute-magento.git
cd sendrepute-magento

2. Безпечне налаштування

Встановіть SENDREPUTE_API_TOKEN лише в середовищі серверів PHP-FPM та CLI. У Stores > Configuration > Services > SendRepute спочатку тримайте модуль та згоду на платний аналіз вимкненими. Додайте кожен точний ідентифікатор шаблону до обох незалежних списків схвалення маршрутів; імена, включаючи числові імена, ніколи не вказують на критичність. Налаштуйте поведінку рекомендації/блокування, поріг та поведінку збереження/блокування у разі помилки окремо.

export SENDREPUTE_API_TOKEN="replace-with-a-scoped-server-token"
# Then configure Stores > Configuration > Services > SendRepute.

3. Свідоме використання

Продовжуйте використовувати звичайний потік шаблонів та транспорту Magento. Кореляція маршрутів записує точний ідентифікатор та обраний магазин через TransportBuilder, тоді як фінальний плагін aroundSendMessage зчитує офіційні типізовані інтерфейси email та MIME перед викликом того самого транспорту. Стан Builder очищується у блоці finally, а кореляції builder/message використовують записи WeakMap з об'єктними ключами, тому покинутий побудований транспорт не може залишити багаторазову авторизацію за числовим ID об'єкта. Адаптер не надає нового методу send та не змінює повідомлення.

Результати, помилки та ліміти

Приймається лише одна підтримувана відображувана частина MIME; вкладення зберігаються, але виключаються з аналізу. Кілька відображуваних частин, непідтримувані кодування передачі або набори символів, потоки, вкладені MIME та неоднозначний текст нормалізатора призводять до помилки до моменту оплати. Один верифікований HTTPS-запит має обмежені часові межі та розмір відповіді без повторів чи перенаправлень. Валідний вкладений результат може заблокувати повідомлення при досягненні порогу; налаштований fail-block викликає Magento MailException.

Адаптер .NET MailKit

0.1.0

Потребує .NET 8 та точного підтвердження залежностей для MailKit/MimeKit 4.18.0. Це явна обгортка навколо IMailTransport, що належить застосунку, а не глобальний хук, SMTP-клієнт чи заміна транспорту. Зберіть або посилайтеся на локальний вихідний ZIP; публікація NuGet не заявляється.

Адаптер та платна згода вимкнені за замовчуванням; advisory та preserve-send є незалежними параметрами за замовчуванням. Виклики AnalyzeAsync, AnalyzeThenSend або AnalyzeThenSendAsync є явними. Критично важливі листи безпеки/акаунта потребують окремої категорії та згоди для кожного виклику. Кожна підтримувана відображувана plain/HTML альтернатива інертно компонується в один обмежений запит; непідтримуваний, вкладений, підписаний або зашифрований вміст викликає помилку до моменту оплати. Оригінальний MimeMessage та токен скасування надходять до існуючого транспорту лише після дозволу політики.

Завантажити Zapier та Make recipe ZIP

1. Встановлення

Розпакуйте вихідний ZIP-архів і додайте посилання на src/SendRepute.MailKit/SendRepute.MailKit.csproj із вашого проєкту .NET 8. Restore отримує MailKit/MimeKit 4.18.0. Цей пакет вихідного коду є локальним і неопублікованим; це не інсталяція NuGet.

curl -fLO https://www.sendrepute.com/downloads/sendrepute-mailkit.zip
unzip sendrepute-mailkit.zip
dotnet add reference ./sendrepute-mailkit-0.1.0/src/SendRepute.MailKit/SendRepute.MailKit.csproj

Альтернатива: встановлення з публічного коду

git clone https://github.com/sendrepute/sendrepute-dotnet.git
cd sendrepute-dotnet

2. Безпечне налаштування

Огорніть існуючий IMailTransport, що належить застосунку, за допомогою SendReputeMailAdapter. Прочитайте API токен із конфігурації сервера та залиште Enabled і PaidAnalysisConsent false до моменту перегляду. Поріг рекомендації/блокування та налаштування збереження/блокування у разі помилки є незалежними. Ендпоінт, нижня межа TLS, поведінка з однією спробою, дедлайни та межа в 1 MiB є фіксованими.

var options = new SendReputeOptions {
    Enabled = false,
    PaidAnalysisConsent = false,
    ApiToken = configuration["SENDREPUTE_API_KEY"]!,
    Enforcement = EnforcementPolicy.Advisory,
    OnFailure = FailurePolicy.PreserveSend,
    SpamProbabilityThreshold = 0.80
};
var adapter = new SendReputeMailAdapter(existingTransport, new SendReputeClient(options), options);

3. Свідоме використання

Викликайте AnalyzeAsync лише для аналізу, або AnalyzeThenSend та AnalyzeThenSendAsync для явної поведінки перед надсиланням. Звичайні або глобальні шляхи пошти не перехоплюються. Передавайте paidConsent та категорію повідомлення для кожної обраної операції; критично важлива пошта безпеки/акаунтів вимагає окремого налаштування critical-consent.

await adapter.AnalyzeThenSendAsync(message, new AnalysisConsent {
    PaidAnalysisConsent = true,
    Category = MessageCategory.Ordinary
}, cancellationToken);

Результати, помилки та ліміти

Фактичне декодування MimeKit збирає кожну підтримувану відображувану альтернативу plain та HTML в інертне обрамлення, виключаючи одержувачів та вкладення. Обрамлення не у форматі base64 та сутності, що декодуються пізніше, нейтралізують фігурні дужки CSS, quoted-printable текст, base64 заголовки, base64 всього тіла та розмітку перед нормалізацією сервісом. Непідтримуваний, вкладений, підписаний або зашифрований відображуваний контент видає помилку до оплати. Кожне обов'язкове поле відповіді типізоване; необов'язкове flaggedTermCount має бути невід'ємним цілим числом, а необов'язкове contentAudit повністю та рекурсивно перевіряється на відповідність публічному контракту. Точна оригінальна MimeMessage та токен скасування доходять до наданого транспорту лише тоді, коли дозволяють незалежні політики оцінки та помилок.

Ручний аналіз чернетки Zapier

0.2.0

Мануальний рецепт Zapier для відображення paid analysis рівно трьох вибраних власником рядків чернетки. Це не застосунок SendRepute для Zapier, позиція в маркетплейсі, артефакт імпорту, pre-send adapter, відправник, allow/block route або whole-message classifier. Zapier Webhooks використовує обмежений HTTPS проксі, керований власником, оскільки токен SENDREPUTE_API_TOKEN не повинен потрапляти в Zap.

Дві константи часу компіляції за замовчуванням false перед HTTP. Zap відображає лише ім'я відправника, тему та тіло листа, надсилає JSON до включеного дизайну owner-proxy, повністю валідує вкладену відповідь, а потім відображає консультативні та білінгові поля на етапі приватного перегляду. Він не повинен додавати відправника, Paths enforcement, Autoreplay або failure-preserve route; невдалі кроки Code або Webhook зупиняються.

Завантажити ZIP-архів з рецептами Zapier та Make

1. Встановлення

Завантажте та розпакуйте спільний вихідний код рецепта 0.2.0. Прочитайте доданий посібник Zapier та розгорніть доданий проксі-сервер loopback Node лише за керованим власником HTTPS reverse proxy. Цей пакет не розгортає його. Не існує застосунку SendRepute Zapier або артефакту Zap для імпорту.

curl -fLO https://www.sendrepute.com/downloads/sendrepute-automation-recipes.zip
unzip sendrepute-automation-recipes.zip
cd sendrepute-automation-recipes

Альтернатива: встановлення з публічного коду

git clone https://github.com/sendrepute/sendrepute-automation.git
cd sendrepute-automation

2. Безпечне налаштування

Тримайте Zap вимкненим. У точному вихідному коді preflight ENABLED та PAID_CONSENT залишаються false до моменту перегляду платного використання. Власний проксі зберігає SENDREPUTE_API_TOKEN; Zap отримує лише один окремо відкличний обліковий запис із SENDREPUTE_PROXY_CREDENTIALS. Редактори та історія завдань можуть розкрити його, тому обмежуйте, змінюйте та відкликайте його. Налаштуйте ліміти токенів (token-bucket) та паралелізму для кожного облікового запису, глобальні обмеження з'єднань/паралелізму, встановлений власником постійний денний бюджет платних викликів, обмежувальні ліміти витрат на рівні upstream, а також відповідні елементи керування розміром/швидкістю/термінами на термінаторі TLS. Не вмикайте Autoreplay.

// In zapier/preflight.js; review charges before changing either literal.
const ENABLED = false;
const PAID_CONSENT = false;

3. Свідоме використання

Створіть кроки вручну: чернетка тригера; зіставлення у Code для preflight лише відправника, теми та тіла; Webhooks POST із JSON-рядками до проксі власника; Code для валідації відповіді; приватне відображення для перегляду. Ніколи не вставляйте сирий JSON вручну. Відображайте лише requestId, model, label, spamProbability та білінг; не додавайте дію mail або рішення Paths.

{
  "sender": "Mapped draft sender display name",
  "subject": "Mapped draft subject",
  "body": "Mapped draft body"
}

Результати, помилки та ліміти

Рецепт аналізує лише три зіставлені рядки; незіставлені MIME, альтернативи HTML, вкладення та кінцевий вихідний контент залишаються неаналізованими. Консервативний preflight відхиляє відомі тригери нормалізатора, але не гарантує охоплення всього повідомлення. Ліміти швидкості, паралелізму та денного бюджету проксі відхиляють запити до рівня upstream, а резервування бюджету зберігається до платної спроби; запускайте один процес проксі на один файл бюджету. Проксі виконує одну обмежену спробу через фіксований HTTPS. Будь-яка не-200 або неповна точна відповідь викликає виняток і зупинку; результати не зберігаються, Resume або заміна результату відсутні.

Створити ручний аналіз чернетки

0.2.0

Інструкції для ручного сценарію Make для відображення paid analysis рівно трьох вибраних рядків чернетки. Це не blueprint, не схвалений застосунок SendRepute, не відправник пошти, не маршрут примусового виконання та не твердження про невідповідні MIME, HTML, вкладення або кінцевий вихідний вміст. Bearer token належить виключно до безпечного keychain Make HTTP.

Збережені логічні значення ENABLED та paidConsent мають значення за замовчуванням false, а фільтр AND зупиняє роботу перед HTTP. JSON створюється модулем JSON Make і надсилається один раз модулем HTTP з вимкненими перенаправленнями та повторними спробами. Фільтр відповіді є лише захистом для відображення, а не повною валідацією чи дозволом на надсилання. Помилки HTTP використовують Break, ніколи Resume або заміну результату.

Завантажити Node.js tarball

1. Встановлення

Завантажте та розпакуйте спільний вихідний код рецепта 0.2.0, потім дотримуйтесь вкладеного посібника Make, щоб вручну зібрати поточні нативні модулі. Жодних blueprint, додатків із маркетплейса чи форматів імпорту не пропонується. Тримайте планування сценаріїв вимкненим під час тестування на mock-ендпоінті.

curl -fLO https://www.sendrepute.com/downloads/sendrepute-automation-recipes.zip
unzip sendrepute-automation-recipes.zip
cat sendrepute-automation-recipes/make/README.md

Альтернатива: встановлення з публічного коду

git clone https://github.com/sendrepute/sendrepute-automation.git
cd sendrepute-automation

2. Безпечне налаштування

Створіть постійні булеві змінні Tools enabled=false та paidConsent=false, після чого додайте фільтр AND, який вимагає значення true для обох. Використовуйте JSON > Create JSON саме для sender, subject та body. Зберігайте токен доступу SendRepute виключно в захищеному сховищі ключів HTTP-додатка; експортовані сценарії не повинні містити жодних облікових даних.

Tools variables: enabled = false; paidConsent = false
Filter: enabled = true AND paidConsent = true
HTTP credential: secure keychain; Authorization header
Body type: Raw; Content type: application/json; map serialized JSON
Follow redirect: No; Timeout: 10 seconds; no retry
Response filter: Minimal display guard

3. Свідоме використання

Налаштуйте один HTTP POST запит на фіксовану URL-адресу classify. Виберіть тип Body як Raw та елемент керування content-type application/json, не додаючи конфліктного заголовка вільного тексту, потім зіставте серіалізований вивід з JSON > Create JSON. Увімкніть розбір відповіді (parsed response), вимкніть перенаправлення, встановіть 10-секундний timeout і не додавайте жодних повторювачів або автоматичних повторів. Вимагайте ліміт відповіді модуля в 1 MiB; якщо він недоступний, використовуйте натомість контрольований власником обмежений проксі. Додайте лише приватне відображення для перегляду після Minimal display guard — ніколи не додавайте маршрутизатор відправника або дозволу/блокування.

{
  "sender": "Mapped draft sender display name",
  "subject": "Mapped draft subject",
  "body": "Mapped draft body"
}

Результати, помилки та ліміти

Аналізуються лише відображені рядки; нормалізація не є ідентичною до оригіналу або вихідного електронного листа. Фільтр відповідей перевіряє лише статус та наявність основного результату/білінгу та явно не є повною валідацією чи примусовим виконанням схеми. Помилки HTTP використовують Break, щоб наступні дії не виконувалися; ніколи не використовуйте Resume, сфабрикований вивід або маршрут збереження помилок.

Node.js SDK

0.1.1

SDK лише для серверів на Node.js 18.17+. Встановіть @sendrepute/node з npm або використовуйте завантажуваний tarball. Додатковий адаптер Nodemailer зберігає ваш існуючий транспорт. Встановіть обмежений API-ключ та явну базову API URL у вашому серверному середовищі, ніколи не в коді браузера.

Зареєструйте createSendReputePlugin на етапі потоку лише після перегляду ціноутворення та навмисного увімкнення згоди на платний аналіз. Консультативний режим повідомляє про результати без блокування доставки. Режим блокування застосовує spamProbabilityThreshold; onApiFailure вибирає allow або block, тоді як відмова через зміну ціни завжди блокує доставку. Класифікація є платною операцією API.