Как создать автоматический отчет о проблемах в тикет-системе WordPress

Автоматизация отчетности — важный элемент эффективного управления тикет-системой на WordPress. В этой статье разбираем, как реализовать функционал автоматической генерации и отправки отчетов о проблемах, зарегистрированных в вашей системе поддержки, с помощью собственного кода и популярных плагинов.

Почему важен автоматический отчет о проблемах в тикет-системе WordPress

Ручное создание отчетов занимает много времени и часто приводит к ошибкам. Автоматизация позволяет регулярно получать актуальную статистику, своевременно выявлять узкие места в поддержке и улучшать качество обслуживания клиентов.

Особенно это актуально, если у вас большой поток заявок и несколько ответственных сотрудников. Такие отчеты можно отправлять менеджерам и техническим специалистам автоматически по расписанию.

Основные задачи автоматического отчета

• Сбор данных о количестве новых, открытых и закрытых тикетов за период;
• Выделение тикетов с высокой приоритетностью или долгим временем ожидания ответа;
• Анализ распределения тикетов по категориям и ответственным;
• Формирование удобочитаемого отчета в формате HTML или PDF;
• Автоматическая отправка отчета на email или интеграция с внешними системами.

Рассмотрим, как реализовать эти задачи на практике.

Используем кастомный код для сбора и отправки отчета

Для начала создадим функцию, которая будет собирать статистику по тикетам. Предположим, что тикеты хранятся в кастомном типе записей ticket с метаполями status и priority.

function wpticket_collect_ticket_report_data($days = 7) {
  $date_after = date('Y-m-d H:i:s', strtotime("-{$days} days"));
  
  $args = [
    'post_type' => 'ticket',
    'posts_per_page' => -1,
    'date_query' => [
      [
        'after' => $date_after,
      ],
    ],
  ];
  $query = new WP_Query($args);

  $report = [
    'total_tickets' => $query->found_posts,
    'status_counts' => [],
    'priority_counts' => [],
  ];

  if ($query->have_posts()) {
    while ($query->have_posts()) {
      $query->the_post();
      $status = get_post_meta(get_the_ID(), 'status', true) ?: 'unknown';
      $priority = get_post_meta(get_the_ID(), 'priority', true) ?: 'normal';

      if (!isset($report['status_counts'][$status])) {
        $report['status_counts'][$status] = 0;
      }
      $report['status_counts'][$status]++;

      if (!isset($report['priority_counts'][$priority])) {
        $report['priority_counts'][$priority] = 0;
      }
      $report['priority_counts'][$priority]++;
    }
    wp_reset_postdata();
  }

  return $report;
}

Эта функция возвращает массив с общей статистикой за последние N дней (по умолчанию 7). Теперь создадим функцию для формирования HTML-отчета:

function wpticket_generate_html_report($report) {
  $html = '<h2>Отчет по тикетам за последнюю неделю</h2>';
  $html .= '<p>Общее количество тикетов: ' . intval($report['total_tickets']) . '</p>';
  
  $html .= '<h3>По статусам</h3><ul>';
  foreach ($report['status_counts'] as $status => $count) {
    $html .= '<li>' . esc_html($status) . ': ' . intval($count) . '</li>';
  }
  $html .= '</ul>';

  $html .= '<h3>По приоритетам</h3><ul>';
  foreach ($report['priority_counts'] as $priority => $count) {
    $html .= '<li>' . esc_html($priority) . ': ' . intval($count) . '</li>';
  }
  $html .= '</ul>';

  return $html;
}

Теперь нам нужна функция, которая будет отправлять этот отчет по email автоматически. Используем wp_mail:

function wpticket_send_ticket_report_email() {
  $report = wpticket_collect_ticket_report_data();
  $html = wpticket_generate_html_report($report);

  $to = 'manager@example.com'; // Замените на адрес получателя
  $subject = 'Автоматический отчет о тикетах WordPress';
  $headers = array('Content-Type: text/html; charset=UTF-8');

  wp_mail($to, $subject, $html, $headers);
}

Для автоматизации запуска этой функции настроим крон-задачу WordPress. Добавим расписание и хук:

add_filter('cron_schedules', function($schedules) {
  if (!isset($schedules['weekly'])) {
    $schedules['weekly'] = [
      'interval' => 604800,
      'display' => 'Еженедельно',
    ];
  }
  return $schedules;
});

if (!wp_next_scheduled('wpticket_weekly_report_event')) {
  wp_schedule_event(time(), 'weekly', 'wpticket_weekly_report_event');
}

add_action('wpticket_weekly_report_event', 'wpticket_send_ticket_report_email');

Использование плагинов для расширенной отчетности

Если вы не хотите писать код, можно использовать готовые решения из репозитория WordPress или из магазина WPShop.

Например, плагин WP Expert Review позволяет создавать комплексные отчеты и аналитику по пользовательским данным, включая тикеты. Его можно настроить на автоматическую отправку отчетов руководству.

Также пригодится ABC Pagination для удобного отображения длинных списков тикетов в отчетах, а My Popup поможет выводить важные уведомления о критических проблемах прямо на сайте.

Настройка интеграции с внешними системами

Для крупных проектов полезно интегрировать тикет-систему с внешними сервисами аналитики и CRM. Можно расширить код выше, добавив отправку данных через REST API, webhook или интеграцию с Zapier.

Например, для отправки JSON-отчета можно использовать функцию:

function wpticket_send_report_to_api($report) {
  $url = 'https://external-api.example.com/receive-report';
  $args = [
    'body' => json_encode($report),
    'headers' => [
      'Content-Type' => 'application/json',
    ],
    'method' => 'POST',
    'data_format' => 'body',
  ];

  $response = wp_remote_post($url, $args);
  return is_wp_error($response) ? false : true;
}

Вызывать эту функцию можно внутри wpticket_send_ticket_report_email(), чтобы обеспечить комплексную автоматизацию.

Оптимизация и безопасность автоматических отчетов

При настройке автоматических отчетов важно учитывать нагрузку на сервер. Запросы к базе лучше оптимизировать, используя WP_Query с правильными параметрами и кеширование результатов.

Обязательно проверяйте права доступа к функциям, чтобы отчеты не могли получить неавторизованные пользователи. Для этого можно добавлять проверку capability текущего пользователя или использовать секретные ключи в URL, если отчеты доступны по ссылке.

Также убедитесь, что в письмах не раскрываются чувствительные данные, а форматирование отчета удобно читается на всех устройствах.

Кэширование данных отчета

Для уменьшения нагрузки стоит кешировать результаты сбора статистики с помощью Transients API:

function wpticket_get_cached_report_data() {
  $cached = get_transient('wpticket_report_data');
  if ($cached !== false) {
    return $cached;
  }

  $data = wpticket_collect_ticket_report_data();
  set_transient('wpticket_report_data', $data, 3600); // кеш на 1 час
  return $data;
}

Используйте эту функцию вместо прямого вызова сбора данных в генерации и отправке отчетов.