Логи WhatsApp
Раздел логов WhatsApp предоставляет полную запись всех автоматизированных взаимодействий, обработанных модулем WhatsApp Cloud API Chat & Marketing. Сюда входят доставки кампаний, ответы ботов и сообщения на основе шаблонов. Используйте этот раздел для мониторинга активности, устранения проблем с доставкой и ведения полного аудиторского следа ваших коммуникаций в WhatsApp.
Доступ к логам WhatsApp
Перейдите в WhatsApp Module > WhatsApp Logs из боковой панели Perfex CRM. Логи отображаются в сортируемой таблице с возможностью поиска, показывающей всю активность автоматизированных сообщений.
Столбцы таблицы логов
Каждая запись лога содержит следующую информацию:
| Столбец | Описание |
|---|---|
| # | Уникальный автоинкрементный ID для каждой записи лога |
| Category | Тип автоматизированного взаимодействия — например, Marketing Campaign, Template Bot |
| Name | Название кампании, бота или автоматизации, создавшей запись |
| Template Name | Шаблон сообщения WhatsApp, использованный для взаимодействия |
| Response Code | HTTP-код ответа от WhatsApp Cloud API (например, 200 для успеха, 400 для неверного запроса) |
| Type | Тип получателя — например, Leads, Customers, Contacts |
| Recorded On | Дата и время записи взаимодействия |
| Actions | Доступные действия для каждой записи: View деталей или Delete записи |
Понимание кодов ответов
Столбец кода ответа помогает быстро определить, были ли сообщения успешно доставлены или возникли ошибки.
| Код ответа | Значение | Необходимое действие |
|---|---|---|
| 200 | Успех — сообщение принято WhatsApp API | Действия не требуются |
| 400 | Неверный запрос — некорректные параметры или проблема с шаблоном | Проверьте шаблон и параметры |
| 401 | Не авторизован — недействительный или истёкший токен доступа | Перегенерируйте токен доступа в настройках Meta Business |
| 403 | Запрещено — недостаточно разрешений | Проверьте разрешения System User |
| 404 | Не найдено — неверный Phone Number ID или эндпоинт | Проверьте Phone Number ID в настройках модуля |
| 429 | Превышение лимита запросов — слишком много запросов | Снизьте частоту отправки; повторите после паузы |
| 500 | Внутренняя ошибка сервера — проблема WhatsApp API | Повторите позже; проверьте страницу статуса Meta при постоянной проблеме |
Успешный код ответа (200) подтверждает, что WhatsApp Cloud API принял сообщение к доставке. Это не гарантирует окончательную доставку на устройство получателя — подтверждение доставки приходит через обновления статуса webhook, видимые в интерфейсе чата.
Фильтрация логов
Используйте встроенные фильтры для сужения записей логов и быстрого поиска конкретных записей:
- Category — фильтр по типу взаимодействия (Marketing Campaign, Template Bot и т.д.)
- Response Code — фильтр по успешным (
200) или конкретным кодам ошибок - Type — фильтр по типу получателя (Leads, Customers, Contacts)
- Date Range — выберите начальную и конечную дату для просмотра логов за определённый период
- Search — полнотекстовый поиск по названиям кампаний, шаблонов и другим полям
Просмотр деталей лога
Нажмите действие View для любой записи лога, чтобы увидеть полные детали взаимодействия, включая:
- Полное тело запроса, отправленного в WhatsApp API
- Полное тело ответа API
- Номер телефона получателя и ссылка на контакт
- Параметры шаблона и использованные значения переменных
- Временная метка с информацией о часовом поясе
Этот детальный просмотр незаменим для устранения проблем с доставкой или аудита конкретного содержимого сообщений.
Удаление записей логов
Для удаления отдельных записей:
- Нажмите действие Delete в строке целевого лога.
- Подтвердите удаление при запросе.
Для массового удаления логов используйте чекбоксы для выбора нескольких записей и нажмите Delete Selected.
Удалённые записи логов невозможно восстановить. Если вам необходимо сохранить записи для соответствия требованиям или аудита, рассмотрите экспорт данных перед удалением.
Лучшие практики
- Регулярно проверяйте логи — проверяйте наличие неудачных доставок (коды ответов, отличные от 200) и оперативно устраняйте проблемы для поддержания эффективности кампаний
- Мониторьте лимиты запросов — при частых ответах
429снизьте ско рость отправки кампаний или распределите доставку на более длительный период - Поддерживайте актуальность токенов — ошибки
401указывают на истечение или отзыв токена доступа; обновите его немедленно для восстановления функциональности - Архивируйте перед очисткой — перед удалением старых логов экспортируйте или задокументируйте записи, необходимые для соответствия требованиям, отчётности или разрешения споров
- Используйте фильтры для аудита — при расследовании конкретной кампании или бота используйте фильтры Category и Name для быстрого выделения нужных записей
Логи WhatsApp фиксируют только автоматизированные взаимодействия (кампании, боты, отправка шаблонов). Ручные сообщения чата между сотрудниками и клиентами хранятся в истории чата и не дублируются в этом разделе л огов.