Навіщо це потрібно: Традиційний моніторинг бачить лише HTTP 200 на лендінгу. FunnelReceipt перевіряє повне проходження воронки: від заповнення форми до моменту, коли CRM підтверджує прийом заявки. Підключіть відправку CRM-квитанцій за 5 хвилин за інструкцією нижче.
1. Отримання API-ключа
Усі запити до Event API повинні містити заголовок автентифікації Authorization: Bearer <API_KEY>.
- Перейдіть у Налаштування кабінету (Settings) під обліковим записом із роллю Власника або Адміністратора.
- У розділі «Ключі API» натисніть «Створити ключ».
- Введіть назву (наприклад,
HubSpot Webhook) та скопіюйте згенерований ключfnr_live_.... Ключ відображається лише один раз!
2. Як розпізнати тестовий лід у вашій системі
Браузерні монітори FunnelReceipt заповнюють форми виключно синтетичними тестовими даними. Кожен запит супроводжується спеціальними HTTP-заголовками:
| Заголовок / Поле | Значення | Опис |
|---|---|---|
X-FunnelReceipt-Test | true | Явний маркер, що запит створено автоматизованим монітором. |
X-FunnelReceipt-Lead-Email | qa-lead-[hash]@funnelreceipt.test | Тестова пошта ліда (відповідає значенню, введеному в інпут форми). |
Порада: У вашій CRM або обробнику вебхуків налаштуйте правило: якщо email закінчується на @funnelreceipt.test, позначайте контакт тегом [QA Test] або не передавайте його до реальних менеджерів з продажу.
3. Ендпоінт CRM-квитанцій (Рекомендований)
Викликайте цей ендпоінт, коли лід успішно створено або відхилено вашою CRM. Це автоматично оновлює статус перевірки в реальному часі на дашборді FunnelReceipt.
Метод та URL: POST https://api.funnelreceipt.com/v1/crm-receipts
Параметри запиту (Query Parameters):
monitorId(UUID, обов'язковий) — ідентифікатор монітора в FunnelReceipt.checkRunId(UUID, обов'язковий) — ідентифікатор конкретного запуску перевірки (можна передавати у прихованому полі форми або через state).
Приклади відправки CRM-квитанції:
curl -X POST "https://api.funnelreceipt.com/v1/crm-receipts?monitorId=YOUR_MONITOR_ID&checkRunId=YOUR_CHECK_RUN_ID" \
-H "Authorization: Bearer fnr_live_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"crmApiUrl": "https://api.hubspot.com/crm/v3/objects/contacts",
"externalLeadId": "lead_98412",
"status": "delivered",
"occurredAt": "'$(date -u +"%Y-%m-%dT%H:%M:%SZ")'",
"payloadSnapshot": {
"contactId": "123456",
"lifecycleStage": "lead",
"accepted": true
}
}'4. Загальний ендпоінт подій доставки (Event API)
Якщо ви хочете фіксувати кроки доставки для аналітики або відстеження партнерських мереж (наприклад, «лід прийнято покупцем», «дублікат у CRM»), використовуйте ендпоінт POST /v1/events:
externalEventId(string, обов'язковий) — унікальний ID події у вашій системі.eventType(enum) —lead_accepted,lead_rejected,lead_delivered,lead_failed,crm_receipt.source(string, обов'язковий) — джерело (напр.,hubspot,pipedrive,custom_api).occurredAt(ISO datetime, обов'язковий) — час настання події у форматі UTC.metadata(object, опціонально) — до 50 пар ключ-значення для контексту.
Приклади відправки події:
curl -X POST "https://api.funnelreceipt.com/v1/events" \
-H "Authorization: Bearer fnr_live_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"externalEventId": "evt_order_84920",
"eventType": "lead_delivered",
"source": "pipedrive",
"occurredAt": "'$(date -u +"%Y-%m-%dT%H:%M:%SZ")'",
"monitorId": "YOUR_MONITOR_ID",
"metadata": {
"campaign": "google_search_ua",
"buyer": "partner_agency",
"dealValue": 1200
}
}'5. No-Code інтеграція (Make.com, Zapier, n8n)
Якщо ваші ліди обробляються через No-Code сценарії, відправка квитанції налаштовується всього одним модулем HTTP Request:
- Додайте модуль HTTP / Webhook після блоку створення контакту в CRM.
- Встановіть метод POST і URL
https://api.funnelreceipt.com/v1/events. - Додайте Headers:
Authorization: Bearer fnr_live_...таContent-Type: application/json. - У тілі запиту оберіть RAW (JSON) та підставте змінні: ID контакту з CRM та статус.
6. Коди відповідей та ліміти
| Код | Значення | Дія |
|---|---|---|
202 Accepted | Подію успішно збережено | Квитанцію додано до таймлайну перевірки. |
401 Unauthorized | Невірний або відсутній API-ключ | Перевірте заголовок Authorization: Bearer .... |
404 Not Found | Монітор не знайдено | Перевірте коректність monitorId. |
413 Payload Too Large | Тіло запиту більше 64 КБ | Зменшіть розмір payloadSnapshot. |
422 Unprocessable | Помилка валідації полів | Перевірте валідність дати ISO 8601 та обов'язкові поля. |