DeadTools Integration
Версия: 1.0.0
Автор: DeadTools
Сайт: https://deadtools.ru/tools/deadtools-integration.php
НАЗНАЧЕНИЕ
Единый административный центр для настроек внешних интеграций ZipTrading. После активации в меню WordPress появляется отдельный раздел «Интеграции» с четырьмя подразделами: Bitrix24 CRM, E-mail, WhatsApp и Telegram.

1. BITRIX24 CRM
Плагин хранит параметры подключения к Bitrix24 и показывает пошаговые инструкции по их получению.
Поддерживаются настройки входящего webhook и служебные параметры CRM, необходимые для дальнейшей маршрутизации заявок/заказов.
Есть проверка подключения к Bitrix24.
Предоставляется функция-помощник deadtools_integration_bitrix24_request(), через которую другой код сайта может вызывать REST-методы Bitrix24 с уже сохранённым webhook.

2. E-MAIL / SMTP
Настройки включают данные отправителя, адрес менеджера и параметры SMTP:
- SMTP-сервер;
- порт;
- тип шифрования;
- SMTP-авторизация;
- логин;
- пароль или пароль приложения.
Плагин реально подключает эти параметры к PHPMailer через хук phpmailer_init, а также настраивает wp_mail_from и wp_mail_from_name.
Есть отправка тестового письма для проверки конфигурации.
В интерфейсе приведена инструкция, где найти SMTP-параметры у почтового провайдера.

3. WHATSAPP
Поддерживаются два режима.
Режим «Только ссылка/кнопка»: хранится номер менеджера и текст сообщения по умолчанию; функция deadtools_integration_whatsapp_url() формирует ссылку wa.me.
Режим WhatsApp Business Cloud API: сохраняются версия Graph API, Phone Number ID, WhatsApp Business Account ID, Access Token и номер получателя уведомлений.
Есть проверка учётных данных Cloud API без отправки сообщения.
Для внешнего кода предоставлена функция deadtools_integration_whatsapp_send() для отправки обычного текстового сообщения через Cloud API.

4. TELEGRAM
Настройки включают:
- Bot Token;
- Chat ID пользователя/группы/канала;
- username бота;
- при необходимости ID темы форума.
Интерфейс содержит инструкцию по созданию бота через @BotFather и получению Chat ID через getUpdates.
Проверка выполняется методом Telegram getChat и не требует отправки тестового сообщения.
Для внешнего кода доступны deadtools_integration_telegram_request(), deadtools_integration_telegram_check() и deadtools_integration_telegram_send().

БЕЗОПАСНОСТЬ И ПРАВА
- Настройки доступны администраторам с правом manage_options.
- Секретные значения проходят отдельную обработку и выводятся в password-полях.
- Тестовые действия защищены стандартными проверками прав и nonce WordPress.

ВАЖНОЕ ОГРАНИЧЕНИЕ
Версия 1.0.0 намеренно НЕ привязывает конкретные формы сайта, заказы или другие события к Bitrix24, WhatsApp и Telegram автоматически. Плагин создаёт настройки, проверку соединений и программные функции-помощники. Какую форму куда отправлять и какие события дублировать в мессенджеры, должен определять отдельный код маршрутизации.
Исключение — SMTP: сохранённые настройки E-mail непосредственно применяются к wp_mail()/PHPMailer.

ХРАНЕНИЕ НАСТРОЕК
Используются отдельные WordPress options:
- deadtools_integration_bitrix24;
- deadtools_integration_email;
- deadtools_integration_whatsapp;
- deadtools_integration_telegram.

ТЕХНИЧЕСКИЕ ТРЕБОВАНИЯ
- WordPress 6.0+.
- PHP 7.4+.
- Для Bitrix24, Telegram и WhatsApp Cloud API сервер должен иметь исходящий HTTPS-доступ.
