betool betool

Документация

Meta Lead Ads

Мгновенный приём лидов Facebook / Instagram в pipeline betool.

Meta Lead Ads

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

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

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

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

Предварительные требования

  • Приложение Meta (Facebook for Developers) с разрешением leads_retrieval.
  • Страница Facebook, одобренная для Lead Ads.
  • Хотя бы одна активная форма Lead Ad.

Настройка

  1. Администрирование → Meta → Приложения — подключите ваше приложение Meta с его App ID и App Secret.
  2. На стороне Meta Developers добавьте webhook, предоставленный betool, на объекте page с полем leadgen.
  3. Выберите соответствующие страницы и авторизуйте приложение.
  4. На стороне betool сопоставьте каждую форму с целевым pipeline.

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

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

  • lead.full_name, lead.email, lead.phone — стандартные поля (нормализованные)
  • lead.form_fields — все вопросы формы с их ответами
  • lead.form_id, lead.ad_id, lead.campaign_id — для атрибуции
  • lead.created_time — временна́я метка Meta (UTC)

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

[facebook_leads]──▶[agent: enrich]──▶[condition: quality]
                                        ├─▶[operator: create CRM]
                                        └─▶[agent: immediate follow-up]

Агент обогащения вызывает инструмент проверки email + HTTP-оператор для запроса к вашей базе данных истории. Условие направляет квалифицированные лиды в CRM, а «горячие» лиды — на немедленный ответ через WhatsApp / email.

Ограничения

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