Устранение неполадок

Возникли проблемы? Не переживайте — большинство решаются просто. Найдите свою ниже и следуйте инструкциям.

Сбой верификации Webhook

Ошибка: «The callback URL or verify token couldn't be validated.»

Возможные причины и решения:

#	Cause	Fix
1	URL не HTTPS	Установите SSL-сертификат на сервере
2	Опечатка в callback URL	Скопируйте прямо из настроек модуля
3	Опечатка в verify token	Скопируйте прямо из настроек модуля
4	Сервер блокирует запросы	Проверьте firewall / плагины безопасности
5	Проблемы с .htaccess	Убедитесь, что URL не редиректит (без www ↔ non-www)
6	Выбрано «User» вместо «Page»	В webhook Facebook выберите «Page»

Как отладить:

1. Откройте в браузере URL webhook:

   https://yourcrm.com/facebookleadsintegration/webhook?hub.mode=subscribe&hub.verify_token=YOUR_TOKEN&hub.challenge=test123

2. При корректной работе на странице должен отображаться test123
3. Если видите страницу ошибки — проблема на стороне сервера

подсказка

Всё ещё не работает? Проверьте логи сервера: /path/to/your/crm/application/logs/

Ошибка «Invalid Scopes» при входе через Facebook

Ошибка: «Invalid Scopes: pages_manage_metadata»

Решение:

Модуль запрашивает устаревшее разрешение. Убедитесь, что установлена последняя версия (v2.0.0+), которая использует корректные разрешения:

• pages_show_list
• pages_read_engagement
• leads_retrieval
• pages_manage_ads
• ads_management

Обновите модуль до последней версии.

«Error Accessing App» / «App Not Active»

Ошибка: «Error Accessing App» или «The app is not active.» при подключении к Facebook

Возможные причины и решения:

#	Cause	Fix
1	Неверный App ID в настройках	Сверьте App ID с Meta App
2	Приложение удалено или отключено	Проверьте в developers.facebook.com/apps
3	Вы не администратор/разработчик	Добавьте себя в App Roles → Roles
4	Ограничения приложения	Проверьте App Settings → Basic → App Restrictions

Тестовый лид работает, но реальные лиды не приходят

Кнопка «Send Test Lead» работает, но реальные лиды из Facebook не появляются.

Проверьте:

#	Check	How
1	Страница подписана?	Settings → Connected Pages → должно быть «Monitoring»
2	Webhook верифицирован?	Settings → Connection Status → Webhook должен быть зелёным
3	Подписан «leadgen»?	Meta App → Webhooks → Page → «leadgen» должен быть отмечен
4	Реклама использует нужную страницу?	Ads Manager → Ad Set → проверьте, что используется подписанная страница
5	Реклама запущена?	Ads Manager → статус кампании «Active»

Тест с инструментом Facebook:

Используйте Lead Ads Testing Tool для отправки тестового лида. Если он приходит, а реальные — нет, проблема скорее в настройке кампании.

Ошибка 500 на страницах модуля

Симптом: Пустая страница или «500 Internal Server Error»

Решения:

1. Проверьте логи PHP:

   /path/to/your/crm/application/logs/log-YYYY-MM-DD.php

2. Частые причины:

   • Слишком старая версия PHP (нужна 7.4+)
   • Отсутствуют расширения (cURL, JSON)
   • Неверные права на файлы
   • Повреждённые файлы при загрузке

3. Права на файлы:

   find /path/to/modules/facebookleadsintegration -type f -exec chmod 644 {} \;
   find /path/to/modules/facebookleadsintegration -type d -exec chmod 755 {} \;

4. Перезагрузите модуль, если файлы могли повредиться

Кнопка Copy не работает

Симптом: При клике на «Copy» рядом с webhook URL или verify token ничего не происходит.

Решение:

• Убедитесь, что CRM доступен по HTTPS — Clipboard API требует безопасный контекст
• Выделите текст вручную и нажмите Ctrl+C
• Проверьте консоль браузера (F12 → Console)

Лиды застряли в «Pending Retry»

Симптом: В Sync History лиды со статусом «Pending» не обрабатываются.

Решения:

1. Обработка вручную: Sync History → «Process Retry Queue»
2. Проверьте cron: очередь обрабатывается через cron Perfex CRM
   • Setup → Settings → Cron Job
   • cron URL должен вызываться каждые 5 минут
3. Проверьте сообщение об ошибке в Sync History

Истёк Access Token

Симптом: При проверке подключения «Token expired» или лиды перестали приходить.

Решение:

Модуль обменивает короткоживущие токены на долгоживущие (≈60 дней). Для обновления:

1. Meta Leads → Settings
2. Прокрутите до Connected Pages
3. Снова нажмите «Connect with Facebook»
4. Войдите и предоставьте разрешения
5. Токен обновится автоматически

подсказка

Установите напоминание для повторного подключения каждые 50 дней.

Неверный маппинг полей

Симптом: Данные лида в неправильных полях или отсутствуют.

Шаги отладки:

1. Sync History → нажмите на запись лида
2. Посмотрите, какие имена полей отправляет Facebook
3. Field Mapping → убедитесь, что имя поля совпадает
4. Стандартные поля (email, full_name, phone_number) сопоставляются автоматически

Типичные проблемы:

What You Expect	What Facebook Sends	Solution
name	full_name	Уже сопоставляется автоматически
phone	phone_number	Уже сопоставляется автоматически
company	company_name	Уже сопоставляется автоматически
budget	custom_question_1	Создайте пользовательский маппинг

Модуль не появляется после установки

Решения:

1. Расположение: папка должна быть modules/facebookleadsintegration/
2. Имя файла: основной файл facebookleadsintegration.php (строчными буквами)
3. Активация: Setup → Modules → Activate
4. Права: файлы должны быть доступны веб-серверу (644 для файлов, 755 для каталогов)

Проблемы на конкретных серверах

Cloudflare

Добавьте IP webhook Facebook в whitelist:

1. Cloudflare → WAF
2. Создайте правило Allow для запросов от Facebook
3. Или добавьте в whitelist firewall:
   • IP-адреса: https://developers.facebook.com/docs/sharing/webmasters/getting-started/webhooks/

Nginx

Убедитесь, что конфигурация разрешает POST и не блокирует User-Agent Facebook.

Shared hosting

Обычно работает. При проблемах:

• Проверьте allow_url_fopen в PHP
• Проверьте расширение cURL
• Убедитесь, что хост не блокирует входящие webhook

Всё ещё нужна помощь?

Если ничего не помогло:

1. Проверьте логи Perfex CRM
2. Проверьте Sync History модуля
3. Сделайте скриншот ошибки
4. Напишите на [email protected] с:
   • Версией Perfex CRM
   • Версией PHP
   • Текстом ошибки
   • Шагами для воспроизведения

Дополнительные ответы в FAQ FAQ