Интеграция лендинга с 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.