Перейти к основному содержимому

Настройка Webhook

Теперь мы укажем Facebook, куда отправлять данные лидов. Это называется «webhook» — как если бы вы дали Facebook почтовый адрес вашей CRM.

Что такое Webhook?​

Простыми словами:

Кто-то заполняет вашу форму для лидов на Facebook/Instagram
         ↓
Facebook говорит: "Эй, у меня новый лид!"
         ↓
Facebook отправляет данные лида на ВАШ URL webhook
         ↓
Ваш модуль получает их и создаёт лид в Perfex CRM

Webhook — это просто URL на вашем сервере, на который Facebook отправляет данные. Модуль создаёт этот URL автоматически — вам нужно лишь сообщить о нём Facebook.

Получите данные Webhook из Perfex​

Перед переходом в Facebook давайте получим данные из модуля:

  1. Войдите в Perfex CRM
  2. Перейдите в Meta Leads → Настройки в боковой панели
  3. Сначала введите ваш App ID и App Secret (из Шага 1) и нажмите Сохранить настройки
  4. Прокрутите вниз до раздела Настройки Webhook
  5. Вы увидите два значения:
ПолеПримерЧто это
Webhook Callback URLhttps://yourcrm.com/facebookleadsintegration/webhookКуда Facebook отправляет данные
Verify Tokena1b2c3d4e5f6g7h8i9j0Секретный код для верификации соединения
  1. Нажмите кнопку Копировать рядом с каждым значением
warning

Callback URL ДОЛЖЕН начинаться с https:// — Facebook требует SSL! Если ваш URL начинается с http://, сначала необходимо установить SSL-сертификат.

Добавление Webhook в ваше Meta-приложение​

1. Откройте панель вашего Meta-приложения​

Перейдите к вашему приложению по адресу:

👉 https://developers.facebook.com/apps/

Нажмите на ваше приложение, чтобы открыть его.

2. Добавьте продукт Webhooks​

  1. В левой боковой панели найдите «Add Product» или прокрутите вниз на панели
  2. Найдите «Webhooks» в списке продуктов
  3. Нажмите «Set Up» или «Configure»
подсказка

Если вы уже видите «Webhooks» в левой боковой панели, нажмите прямо на него — добавлять повторно не нужно.

3. Выберите «Page» как тип объекта​

  1. На странице Webhooks вы увидите выпадающий список, по умолчанию стоит «User»
  2. Измените этот список на «Page»
warning

Это критически важно! Вы ДОЛЖНЫ выбрать «Page» — не «User», не «Application», ничего другого. Данные лидов приходят через подписки на Page.

4. Подпишитесь на Webhook​

  1. Нажмите кнопку «Subscribe to this object» (или «Edit Subscription», если уже настроено)
  2. Появится диалоговое окно с запросом двух значений:
ПолеЧто вводить
Callback URLВставьте URL Webhook из модуля (например, https://yourcrm.com/facebookleadsintegration/webhook)
Verify TokenВставьте Verify Token из модуля
  1. Нажмите «Verify and Save»

5. Что происходит при нажатии «Verify and Save»​

Facebook немедленно отправит запрос верификации на ваш URL webhook:

Facebook: "Эй, это действительно ваш сервер?"
Ваш модуль: "Да! Вот verify token в подтверждение!"
Facebook: "Отлично, верифицировано!"

Если всё работает: Вы увидите сообщение об успехе, и диалог закроется.

Если не работает: См. раздел Устранение неполадок для типичных решений.

6. Подпишитесь на события «leadgen»​

После верификации нужно указать Facebook, какие события отправлять:

  1. Вы увидите список типов событий в подписках «Page»
  2. Найдите «leadgen» в списке (возможно, потребуется прокрутка)
  3. Нажмите переключатель/флажок «Subscribe» рядом с «leadgen»
подсказка

«leadgen» — это ЕДИНСТВЕННОЕ событие, которое вам нужно. Не нужно подписываться на другие события (вроде «messages» или «feed»). Только «leadgen».

Верификация успешна!​

Ваша конфигурация webhook теперь должна выглядеть так:

Webhooks
├── Object: Page
├── Callback URL: https://yourcrm.com/facebookleadsintegration/webhook ✅
├── Verify Token: ✅ Verified
└── Subscriptions:
    └── ✅ leadgen (subscribed)

В вашем модуле Perfex CRM индикатор статуса webhook теперь должен показывать зелёный/Верифицирован!

Как протестировать Webhook​

Хотите убедиться, что webhook работает?

  1. Перейдите в Perfex CRM → Meta Leads → Настройки
  2. Нажмите кнопку «Тест соединения»
  3. Вы должны увидеть все зелёные галочки

Более тщательное тестирование мы проведём позже в разделе Тестирование лидов.

Типичные ошибки, которых следует избегать​

ОшибкаИсправление
Выбран «User» вместо «Page»Измените выпадающий список на «Page»
Забыли подписаться на «leadgen»Найдите «leadgen» в списке и подпишитесь
Использование HTTP вместо HTTPSУстановите SSL-сертификат на сервер
Опечатка в Callback URLСкопируйте URL напрямую из настроек модуля
«Callback URL couldn't be validated»См. Устранение неполадок

Webhook настроен? Подключите ваши страницы