К интеграциям
Meta AdsДокументация интеграции

Meta Ads

Facebook & Instagram Lead Ads

Поддерживаются оба формата: канонический webhook (entry/changes/value) и flat field_data от bridge-сервисов (Albato, Zapier). Подпись X-Hub-Signature-256 проверяется по HMAC-SHA256 секрета подписи workspace.

Webhook endpoint

POSThttps://closeflow.ru/api/v1/webhooks/leads/meta-ads

Аутентификация: заголовок X-Api-Key или query-параметр ?api_key=. Получить ключ - в Настройках.

Шаги настройки

01

Сгенерируйте секрет подписи

Откройте /dashboard/integrations → блок «Webhook signing secret» → нажмите «Reveal» → скопируйте.

02

Создайте Page Access Token

В Meta Business Manager создайте System User, выдайте права на страницу и скопируйте долгоживущий Page Access Token. Сохраните его в блоке «Meta Page Access Token» на /dashboard/integrations - он нужен, чтобы дотягивать field_data, если webhook прислал только leadgen_id.

03

Подключите webhook

В Meta App → Webhooks → Page → leadgen → введите Callback URL и Verify Token (любой). В качестве App Secret используйте сохранённый ранее Webhook signing secret.

POST https://your-app.com/api/v1/webhooks/leads/meta-ads?api_key=cf_live_...
X-Hub-Signature-256: sha256=<hex>

{
  "object": "page",
  "entry": [{
    "changes": [{
      "field": "leadgen",
      "value": { "leadgen_id": "...", "form_id": "...", "ad_id": "..." }
    }]
  }]
}

Если что-то не так

Запрос отклоняется как INVALID_SIGNATURE

Webhook signing secret в CloseFlow и App Secret в Meta должны полностью совпадать. После rotate в нашем UI обязательно обновите App Secret в Meta - старый секрет перестаёт работать сразу.

Документация провайдера

Другие интеграции

CloseFlow - Follow-up Autopilot