01
Получите код подтверждения
В сообществе VK откройте Управление → Работа с API → Callback API → «Строка для подтверждения». Скопируйте её.
VK РекламаДокументация интеграции
VK Реклама
Лид-формы VK Реклама через Callback API
Подключите Callback API сообщества для приёма заявок из лид-форм VK Рекламы. Подтверждение сообщества выполняется автоматически - нужно лишь сохранить «строку подтверждения» в настройках интеграции.
Webhook endpoint
POST
https://closeflow.ru/api/v1/webhooks/leads/vk-adsАутентификация: заголовок X-Api-Key или query-параметр ?api_key=. Получить ключ - в Настройках.
Шаги настройки
02
Сохраните код в CloseFlow
На /dashboard/integrations найдите блок «VK Callback API» и вставьте строку. Без этого VK не активирует webhook.
03
Укажите URL и проверьте
В тех же настройках VK укажите наш endpoint, нажмите «Подтвердить». CloseFlow автоматически ответит сохранённой строкой, и VK начнёт слать события lead_forms_new.
POST https://your-app.com/api/v1/webhooks/leads/vk-ads?api_key=cf_live_...
{
"type": "lead_forms_new",
"object": {
"lead_id": "9876",
"ad_id": "1234",
"form_id": "55",
"answers": [
{ "key": "name", "answer": "Маша" },
{ "key": "email", "answer": "masha@example.com" },
{ "key": "phone_number", "answer": "+79991234567" }
]
}
}Если что-то не так
VK пишет «Не удалось подтвердить»
Проверьте код в /dashboard/integrations - он должен совпадать символ-в-символ. Также убедитесь, что endpoint доступен извне (не localhost).
Документация провайдера
Другие интеграции