Інтеграція лендінгу з KeyCRM: PHP‑скрипт, що формує замовлення

Клієнт продає товари через лендінг і до цього отримував заявки на email/таблиці.
Завдання: зробити так, щоб кожна заявка з форми на сайті автоматично створювала угоду в KeyCRM з повним набором даних:
- контакт (ім’я, email, телефон);
- товар(и) і сума;
- платіж і його статус;
- UTM‑мітки з реклами;
- додаткові поля під бізнес‑логіку.

Рішення
На боці сайту був доданий PHP‑обробник форми, який збирає всі дані з $_POST і формує структурований масив data під формат API KeyCRM:

Основні реквізити угоди:
- title — назва заявки;
- source_id — джерело ліда;
- manager_comment — коментар з форми;
- manager_id та pipeline_id — відповідальний менеджер і воронка.

Контакт:
- блок contact із full_name, email, phone створює/оновлює картку покупця, прив’язану до угоди.

Маркетинг‑дані:
- utm_source, utm_medium, utm_campaign, utm_term, utm_content — усі UTM із посилання автоматично передаються в CRM, щоб маркетинг міг бачити, з якої кампанії/оголошення прийшов лід.

Товари:
- масив products з полями name, sku, quantity, price, picture дозволяє одразу фіксувати, що саме купує клієнт, у якій кількості та за якою ціною.

Оплати:
- масив payments з payment_method_id, amount, payment_date, status («paid», «not_paid», «canceled», «refund») дає змогу прив’язати до угоди факт/статус платежу.

Кастомні поля:
- блок custom_fields з uuid і value заповнює специфічні для бізнесу поля (наприклад, тип ліда, джерело звернення, внутрішні теги).
- Після формування масиву $data він відправляється в KeyCRM через HTTP‑запит до їх API‑ендпоінту створення угод/замовлень (опис як «server‑side інтеграція форми з CRM»).

Що отримав клієнт
- Автоматичні угоди: кожне заповнення форми на сайті створює повну картку в KeyCRM без ручного внесення.
- Прозора аналітика: маркетинг бачить UTM‑мітки по кожній угоді й може рахувати конверсії по кампаніях.
- Коректний облік продажів: у картці одразу є товари, сума та статус оплати — зручно для фінансів і повторних продажів.
- Готовність до масштабування: при розширенні сайту/реклами не потрібно змінювати процес у відділі продажів — усе вже централізовано в CRM.