Универсальные обработчики

Универсальный обработчик форм

Описание

Универсальный обработчик форм для импорта данных в amoCRM. Мы ожидаем POST запрос. Параметры запроса указаны ниже.

Требования для работы

Необходимо получить параметр {{pushkaKey}}

URL

https://octane.pushka.biz/api/handler-form/{{pushkaKey}}/general

Логика работы с дублями

Проверка на дубли происходит по contactPhone и contactEmail.
Поиск данных происходит в компаниях, в контактах и в неразобранном указанной воронки.

Логика обработки:
  • Если нет совпадений - создается неразобранное
  • Если нашли контакт или компанию - смотрим активные сделки
    • Если активных сделок нет - создаем сделку в первом этапе указанной воронки на того же ответственного и ставим задачу
    • Если активные сделки есть - в самую свежую добавляем примечание и ставим задачу "Клиент оставил заявку повторно"

Обязательные параметры!

Если не передан ни contactPhone, ни contactEmail - заявка не попадет в amoCRM
contactPhone
string
Телефон контакта
contactEmail
string
Email контакта

Создание неразобранного или сделки

По умолчанию обработчик создает неразобранное.

unsorted
boolean
Установите false для создания сделки вместо неразобранного
searchDuplicate
boolean
Установите false чтобы создавать контакт в любом случае без поиска дубликатов
unsortedDuplicate
boolean
Установите true для создания неразобранного при нахождении дубликата
Обязательные параметры при unsorted=false:
  • statusId - ID этапа в нужной воронке
  • responsibleId - ID пользователя, ответственного за сделку

Дополнительные параметры

ПараметрОписаниеЗначение по умолчанию
leadNameНазвание сделкиЗаявка с сайта
tagsТеги к сделке, контакту, компании (через запятую)-
leadPriceБюджет сделки-
leadNoteПримечание к сделке-
contactNameИмя контактаИмя не указано
companyNameНазвание компании-
lead_cfМассив доп. полей сделки: lead_cf1111=test-
lead_cf_1111Доп. поле сделки (1111 - id поля)-
contact_cfМассив доп. полей контакта: contact_cf2222=test-
contact_cf_2222Доп. поле контакта (2222 - id поля)-
company_cfМассив доп. полей компании: company_cf2222=test-
company_cf_2222Доп. поле компании (2222 - id поля)-
pageСтраница откуда отправлена формаhttps://amocrm.ru
pipelineIdВоронка для создания неразобранногоглавная
ipIP адрес клиента127.0.0.1
formNameНазвание формыФорма сайта

Метки систем статистики

  • roistat
  • utm_source
  • utm_medium
  • utm_campaign
  • utm_term
  • utm_content
  • utm_referrer
  • _ym_uid
  • _ym_counter
  • openstat_campaign
  • openstat_ad
  • openstat_source
  • from
  • gclientid
  • gclid
  • yclid
  • fbclid
  • openstat_service
  • referrer

Примеры запросов

Во всех запросах в качестве примера используется pushkaKey = 12345. Вы должны использовать свой.
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://octane.pushka.biz/api/handler-form/12345/general',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => array(
    'contactPhone' => '375296117699',
    'contactName' => 'Василий Иванович',
    'leadName' => 'Супер сделка',
    'lead_cf_33333' => 'ВИП',
    'contact_cf_22222' => 'Согласен',
    'tags' => 'ВАЖНАЯ,СРОЧНО'
  ),
));

$response = curl_exec($curl);
curl_close($curl);
echo $response;
Copyright © 2026