Частина 4 — Вебхук: відправка при кожній зміні статусу

Не почато

Що

На кожну зміну статусу замовлення — один POST з усім, що є в картці. Одна зміна, один запит.

Статус надсилаєте так, як він записаний у вас. Нічого не рахуєте, не мапите і не фільтруєте — що він означає, вирішуємо ми на своєму боці.

Так само на створення замовлення — навіть якщо міток немає зовсім і замовлення завели вручну в CRM. Ми спробуємо впізнати клієнта за телефоном чи поштою і все одно передати конверсію в рекламу.

Адреса

http
POST https://prod-observix-integrations.orangeplant-bcc99803.eastus.azurecontainerapps.io/api/crm/hooks/hk_douexAOZGIOBBOOFizc-VNebaqewxWiSOtk2quzljYA

Перевірити прямо зараз — вставте в термінал:

bash
curl -X POST 'https://prod-observix-integrations.orangeplant-bcc99803.eastus.azurecontainerapps.io/api/crm/hooks/hk_douexAOZGIOBBOOFizc-VNebaqewxWiSOtk2quzljYA' \
  -H 'Content-Type: application/json' \
  -d '{
  "entity_id":   "38018",
  "status":      "Підтверджено",
  "occurred_at": "2026-09-07T14:19:00Z",
  "value":    1890.00,
  "currency": "UAH",
  "email":       "olena@example.com",
  "phone":       "+380671234567",
  "external_id": "CUST-100500",
  "properties": {
    "obx_visitor_id": "01a06b10-6d1b-71a7-8848-ac64ff004c56",
    "first_name": "Олена",
    "last_name":  "",
    "address":    "м. Київ, Нова Пошта №42",
    "items": [
      { "id": "112", "name": "Вітамін C + Ехінацея 60 капсул", "quantity": 1, "price": 890.00 },
      { "id": "227", "name": "Магній B6 90 таблеток",          "quantity": 2, "price": 500.00 }
    ],
    "ga_client_id": "2058403263.1788768683",
    "gclid":        "TEST123",
    "gbraid":       "",
    "wbraid":       "",
    "fbclid":       "ABC456",
    "fbc":          "fb.1.1788779879.ABC456",
    "fbp":          "fb.2.1788768682122.1380784472",
    "ttclid": "",
    "ttp":    "",
    "utm_source":   "google",
    "utm_medium":   "cpc",
    "utm_campaign": "brand-ua",
    "utm_content":  "",
    "utm_term":     "",
    "landing_page": "https://lavka-molfara.com.ua/index.php?route=checkout/success",
    "referrer":     ""
  }
}'

Що надсилати

json
{
  // ── Обов'язкові ───────────────────────────────────────────────────────────
  "entity_id":   "38018",                  // номер угоди у вас — єдиний ID, по якому ми її впізнаємо
  "status":      "Підтверджено",           // статус як він є у вас, дослівно
  "occurred_at": "2026-09-07T14:19:00Z",   // ваша "Дата зміни", у UTC

  // ── Гроші ─────────────────────────────────────────────────────────────────
  "value":    1890.00,                     // сума на цей момент; 0 якщо ще нема
  "currency": "UAH",

  // ── Хто це ────────────────────────────────────────────────────────────────
  "email":       "olena@example.com",      // "" якщо нема
  "phone":       "+380671234567",          // "" якщо нема
  "external_id": "CUST-100500",            // ID КЛІЄНТА, не номер угоди

  // Сюди ж складайте БУДЬ-ЯКІ інші поля з вашої картки — зайвого не буває,
  // ми зберігаємо все як є.
  "properties": {
    // ── Найважливіше ────────────────────────────────────────────────────────
    "obx_visitor_id": "01a06b10-6d1b-71a7-8848-ac64ff004c56",  // з частини 1, БЕЗ НЬОГО НЕМА АТРИБУЦІЇ

    "first_name": "Олена",
    "last_name":  "",
    "address":    "м. Київ, Нова Пошта №42",   // у довільному вигляді, як у вас
    "items": [                                 // ваші "Товари", розбиті на позиції;
      // сума quantity × price по всіх позиціях = "value" вище (890 + 2×500 = 1890)
      { "id": "112", "name": "Вітамін C + Ехінацея 60 капсул", "quantity": 1, "price": 890.00 },
      { "id": "227", "name": "Магній B6 90 таблеток",          "quantity": 2, "price": 500.00 }
    ],

    // ── Мітки реклами: у вас уже є ──────────────────────────────────────────
    "ga_client_id": "2058403263.1788768683",   // ваше "ga client id"
    "gclid":        "TEST123",                 // ваше "gclid"
    "gbraid":       "",                        // порожнє — теж шліть
    "wbraid":       "",
    "fbclid":       "ABC456",
    "fbc":          "fb.1.1788779879.ABC456",
    "fbp":          "fb.2.1788768682122.1380784472",

    // ── Міток TikTok у вас ще нема — треба додати ───────────────────────────
    "ttclid": "",                              // з адреси
    "ttp":    "",                              // з cookie _ttp

    // ── utm: з адреси, якою прийшов клієнт ──────────────────────────────────
    "utm_source":   "google",
    "utm_medium":   "cpc",
    "utm_campaign": "brand-ua",
    "utm_content":  "",
    "utm_term":     "",

    // ── Звідки прийшов ──────────────────────────────────────────────────────
    "landing_page": "https://lavka-molfara.com.ua/index.php?route=checkout/success",
    "referrer":     ""
  }
}

Тест

Тут з’являються всі події, які ви до нас надсилаєте. Підключіть вебхук у своїй CRM, змінюйте статус замовлення — і дивіться, чи з’явився тут відповідний об’єкт і що саме в ньому прийшло.

Поки жодної події.

Надішліть запит — або натисніть кнопку вище. Перевіряємо через 5 с.