Meta Lead Ads — Docs betool

Мгновенный приём лидов Facebook / Instagram в pipeline betool — через управляемое приложение Meta от betool или через своё собственное.

Канал Meta Lead Ads подключает ваши страницы Facebook к betool, обеспечивая обработку в реальном времени лидов, отправленных через ваши формы Lead Ads (Facebook, Instagram).

Зачем этот канал

Лиды Meta традиционно обрабатываются пакетами — экспортируются в CSV, импортируются в CRM, затем вручную квалифицируются. Результат: задержка от 30 минут до нескольких часов между отправкой формы и первым контактом.

Подключив Meta Lead Ads напрямую к pipeline betool, вы сокращаете эту задержку до нескольких секунд — и первый контакт (email, WhatsApp, телефонный звонок) может быть автоматизирован.

Два режима подключения

Управляемый режим (рекомендуется) — вы подключаете свою страницу Facebook через приложение Meta от betool, уже настроенное на стороне платформы. betool хранит токен страницы и автоматически подписывает её на лиды (leadgen): больше ничего настраивать не нужно.
Режим собственного приложения (продвинутый) — вы используете собственное приложение Meta: указываете в приёмнике свой verify_token, свой app_secret (проверка подписи X-Hub-Signature-256) и долгосрочный page_access_token, затем регистрируете URL обратного вызова, предоставленный betool, в разделе Webhooks вашего приложения Meta (объект page, поле leadgen).

Настройка (управляемый режим)

Параметры → Сервисы → Facebook, вкладка Accounts — нажмите Подключить страницу Facebook, авторизуйте приложение в окне Facebook, затем выберите страницу, с которой хотите получать лиды.
В редакторе модели настройте узел Start с приёмником Facebook Lead Ads и выберите подключённую страницу.
Каждый лид, отправленный через форму этой страницы, запускает pipeline.

Что получает pipeline

Для каждого отправленного лида betool получает полный лид через Graph API, затем создаёт exchange со следующими данными:

lead.fields — нормализованные стандартные поля: full_name, first_name, last_name, email, phone, company, job_title, city, country, state, zip_code
lead.custom — остальные вопросы формы с их ответами
lead.metadata — leadgen_id, form_id, page_id, created_time (временна́я метка Meta)
lead.raw — необработанный ответ Graph API

Meta сразу получает подтверждение приёма; затем pipeline выполняется из надёжной очереди (с повторными попытками), что позволяет не превышать время ответа, установленное Meta.

Типовой сценарий использования

[Start · Facebook Lead Ads]──▶[agent: qualifier]──▶[filter: lead chaud ?]
                                                 ├─▶[connecteur CRM: créer la fiche]
                                                 └─▶[envoi: relance immédiate]

Агент квалифицирует лид на основе lead.fields и lead.custom; затем детерминированные фильтры направляют квалифицированные лиды в CRM, а «горячие» лиды — на немедленное напоминание по email / WhatsApp.

Ограничения

Лимиты частоты Meta — у Graph API есть ограничения частоты запросов. Для больших объёмов предусмотрите буфер.
Разрешения (режим собственного приложения) — ваше приложение должно иметь разрешение leads_retrieval, которое Meta может отозвать, если приложение не прошло валидацию. Следуйте процессу App Review от Meta.
Нет ретроактивной выборки — betool не извлекает лиды, отправленные до настройки webhook. Для этого экспортируйте и загрузите их с помощью разового скрипта.