ClubIS принимает заявки из лид-форм Facebook (Lead Ads): по заполнению формы создаётся или находится анкета клиента, а во вкладке Лиды модуля Менеджер появляется сделка с названием Facebook lead.
Настройка делится на две части: подготовка ClubIS и настройка приложения Meta (webhook, права, форма). Обычно подключение делают вместе со специалистом, у которого есть доступ к рекламному кабинету Facebook, и при необходимости — с поддержкой ClubIS.
¶ Что должно быть на площадке
- Запущенная служба web-service с доступом из интернета.
- Адрес web-service по протоколу HTTPS и действительный SSL-сертификат. Самоподписанный сертификат Facebook не принимает — webhook не подтвердится.
- Служебный пользователь для авторизации API — см. Авторизация в API.
¶ Шаг 1. Токен Facebook в ClubIS
В ClubIS в поле API Key нужен токен доступа страницы (Page Access Token) с правом читать лиды этой страницы — не путать с Verify Token в настройках Webhooks (это другое поле, только для проверки URL).
- Создайте (или используйте существующее) приложение Meta и пройдите проверку приложения, если Meta её требует.
- Для приложения включите право
leads_retrievalи доступ к нужной Facebook-странице (актуальные права Pages / Lead Ads в кабинете разработчика). Описание: Retrieving Leads. - Получите токен доступа страницы в Graph API Explorer: выберите приложение → получите пользовательский токен с нужными правами → обменяйте на токен страницы, с которой идут лид-формы.
- В ClubIS откройте Администратор → Интеграции → Лиды (блок Facebook) и укажите этот токен в поле API Key.
- Сохраните параметры. После смены токена при необходимости перезапустите службу web-service, чтобы значение подхватилось сразу.
Токен нужен ClubIS, чтобы по уведомлению от Facebook запросить данные заполненной формы через Graph API (версия v26.0).
¶ Шаг 2. Webhook в приложении Meta
В кабинете Meta for Developers откройте приложение → сценарий получения рекламных лидов → Webhooks.
- В Select product выберите Page.
- Укажите URL обратного вызова службы ClubIS и нажмите Подтвердить и сохранить:
https://<ваш-домен-или-ip>:<порт>/api/facebook?USER_ID=<id_пользователя>&USER_HASH=<хэш_пользователя>
<ваш-домен-или-ip>:<порт>— внешний адрес web-service;USER_IDиUSER_HASH— данные служебного пользователя (как у других входящих API).
Вместо пары USER_ID / USER_HASH можно передать параметр token, если на площадке настроен токен доступа к API.
Пример формата URL:
https://club.example:8182/api/facebook?USER_ID=30&USER_HASH=…
-
Поле Подтверждение маркера (Verify Token) можно задать любым: ClubIS его не сверяет, важно успешное подтверждение URL. При проверке Facebook присылает запрос — ClubIS отвечает кодом подтверждения.
-
Ниже в списке полей подпишитесь на
leadgenдля объекта Page (версия поля — v26.0, как у остальных полей этой подписки). Переключатель уleadgenдолжен быть во включённом состоянии (Есть подписка).
- Убедитесь, что приложение установлено на ту Facebook-страницу, с которой идут рекламные формы (страница получает уведомления
leadgen).
Кнопка Тестировать у поля leadgen проверяет только доставку webhook на ваш URL (в данных будет условный идентификатор вроде 444…). Такой тест не создаёт лид в ClubIS — для проверки появления сделки нужна реальная (или тестовая из Lead Center) заявка с именем и телефоном.
¶ Шаг 3. Поля лид-формы
Чтобы заявка создалась в ClubIS, в форме должны быть ответы, которые Facebook отдаёт в данных лида. ClubIS понимает как английские системные имена, так и типичные русские:
| Поле в форме | Как обычно приходит от Facebook | Назначение |
|---|---|---|
| Полное имя | full_name или полное_имя |
Имя в анкете и в лиде. |
| Телефон | phone_number, phone или номер_телефона |
Поиск существующей анкеты и запись телефона в новую. |
email |
Поиск анкеты, если телефон не найден; запись в анкету. |
Для создания лида нужно хотя бы имя или телефон. Рекомендуется передавать телефон (и при возможности e-mail) — так проще сопоставить заявку с уже существующим клиентом.
Остальные ответы формы ClubIS сохраняет в описании лида (вместе с идентификаторами формы и объявления).
¶ Как это выглядит в ClubIS
После заполнения формы Facebook:
- ClubIS ищет анкету по телефону, затем по e-mail.
- Если анкета не найдена — создаётся новая (ФИО из имени, контакты из формы).
- Во вкладке Менеджер → Лиды появляется сделка Facebook lead с текстом ответов формы.
Работа с лидами: Lead API: работа в Менеджере.
¶ Частые причины, если не работает
| Симптом | Что проверить |
|---|---|
| Webhook не подтверждается | HTTPS и валидный SSL; URL доступен из интернета; в URL есть USER_ID/USER_HASH или token |
| Ответ «Not Authorized!» | Неверные или устаревшие данные авторизации в URL webhook |
| Уведомление есть, лида нет | В Интеграции → Лиды (блок Facebook) указан актуальный API Key (токен страницы с leads_retrieval); у токена есть доступ к нужной странице; в форме есть имя или телефон |
| Webhook не приходит на площадку | Подписка на поле leadgen включена; приложение привязано к странице; в истории доставок Webhooks нет ошибок |
| Тест из кабинета Meta без лида в ClubIS | Ожидаемо для кнопки «Отправить на мой сервер» с фиктивными id — проверьте реальную заявку |
¶ См. также
- Прочие интеграции
- Lead API — приём заявок с сайта и других форм
- Lead API: подготовка ClubIS
- Служба web-service
- Авторизация в API