WooCommerce: как настроить отправку уведомлений в Telegram о новых заказах

Зачем отправлять уведомления о заказах в Telegram

Для интернет-магазина на WooCommerce важно быстро реагировать на новые заказы. Отправка уведомлений в Telegram позволяет мгновенно получать информацию о новых заказах на мобильное устройство или компьютер без необходимости постоянно проверять панель администратора WordPress или почту.

Диагностика проблемы: нет уведомлений о заказах или задержка

Если вы не получаете уведомления о новых заказах в Telegram, проверьте следующие моменты:

• Правильно ли создан и подключен Telegram-бот.
• Верно ли указан chat_id для получения сообщений.
• Активированы ли хуки WooCommerce, которые запускают отправку уведомления.
• Не блокирует ли сервер исходящие запросы к API Telegram.
• Отслеживайте логи ошибок PHP и WooCommerce.

Пошаговое решение: настройка отправки уведомлений

1. Создание Telegram-бота и получение токена

В Telegram найдите бот @BotFather, создайте нового бота и получите API токен.

2. Получение chat_id

Отправьте любое сообщение вашему боту и используйте https://api.telegram.org/botYOUR_TOKEN/getUpdates в браузере, чтобы узнать chat_id – идентификатор чата, куда бот будет отправлять сообщения.

3. Добавление кода в functions.php или свой плагин

Вставьте следующий код:

function send_telegram_notification_on_new_order( $order_id ) {
    $token = 'ВАШ_ТОКЕН_БОТА';
    $chat_id = 'ВАШ_CHAT_ID';

    if ( ! $order_id ) return;

    $order = wc_get_order( $order_id );
    if ( ! $order ) return;

    $message = "Новый заказ №" . $order->get_order_number() . "%0A";
    $message .= "Статус: " . $order->get_status() . "%0A";
    $message .= "Сумма: " . $order->get_formatted_order_total() . "%0A";
    $message .= "Покупатель: " . $order->get_billing_first_name() . " " . $order->get_billing_last_name() . "%0A";

    $url = "https://api.telegram.org/bot" . $token . "/sendMessage?chat_id=" . $chat_id . "&text=" . $message;

    wp_remote_get( $url );
}
add_action( 'woocommerce_thankyou', 'send_telegram_notification_on_new_order', 10, 1 );

Этот код отправляет базовую информацию о заказе сразу после его оформления (хук woocommerce_thankyou).

4. Размещение кода и тестирование

Добавьте код в файл functions.php активной темы или создайте небольшой плагин. Затем сделайте тестовый заказ.

Проверка результата после внедрения

• Оформите тестовый заказ в WooCommerce.
• Проверьте, что в Telegram в нужном чате появилось уведомление с данными заказа.
• При отсутствии уведомлений проверьте ошибки PHP и доступность API Telegram с сервера.

Частые ошибки и как их исправить

• Неверный токен бота или chat_id: Проверьте их точность через @BotFather и API Telegram.
• Отсутствие прав у бота: Убедитесь, что бот добавлен в нужный чат и имеет разрешения на отправку сообщений.
• Блокировка исходящих запросов сервером: Проверьте настройки брандмауэра и хостинга.
• Использование неподходящего хука: Хук woocommerce_thankyou срабатывает после оформления заказа, но можно заменить на woocommerce_order_status_changed для разных статусов.

Практические советы по безопасности и производительности

• Для повышения безопасности не храните токен и chat_id в открытом виде в коде, используйте константы в wp-config.php или настройки плагина.
• Обрабатывайте ошибки ответа API Telegram, чтобы избежать потери уведомлений.
• Используйте асинхронные запросы или очередь заданий, если магазин большой, чтобы не замедлять оформление заказа.
• Ограничьте количество отправляемых уведомлений, например, только для новых заказов с определённым статусом.

Сравнение способов реализации уведомлений