1. Wiki
  2. API
  3. Создать заявку (подбор) в CRM

Создать заявку (подбор) в CRM

Создать заявку (подбор) в CRM

Для отправки заявок в CRM необходимо получить уникальный apikey
(Для этого необходимо обратиться в тех.поддержку и сообщить название партнера или системы из которой будут отправляться заявки). support: dfomin@forsto.ru

Обработка формы идет во внешней системе относительно CRM. После валидации формы, делается POST-запрос в API CRM.

Для синхронизации данных, предлагается на стороне формы предварительно запрашивать список городов, доступных в CRM и отправлять заявку уже с правильным ID города. Нужно для корректной привязки нового клиента к его городу.

Список городов получается тут:

https://rcrm.ваш_домен.ru/api/v1/external/available_cities

POST-запрос с VIN-формы идет сюда:

https://rcrm.ваш_домен.ru/api/v1/external/vin_request

 

Ответ содержит структуру:

  • CODE — все что не 200, ошибка
  • MESSAGE — в случае ошибки, тут будет подробный текст ошибки
  • RESPONSE — данные ответа на запрос. В случае успеха содержит OFFER_ID — ID нового подбора

      

Обязательные поля в запросе:

  • PHONE

Пример POST-запроса на php:

<?
//в случае неправильного ключа, придет форма логина
$apikey = ’67_7ffe623c0518431010da90e53721eb3a’;
$api_url = ‘https://rcrm.ваш_домен.ru/api/v1/external/vin_request’;
// Этот request формируется при обработке $_REQUEST из формы
//Если есть обязательные поля, то их надо обработать
$request = [
   ‘FIO’=>’VIN Иван Иваныч’,
‘CITY’=>’Нижний Новгород’, //выбирается из списка городов, из метода https://rcrm.ваш_домен.ru/api/v1/external/available_cities
‘CITY_ID’=>2, //выбирается из списка городов, из метода https://rcrm.ваш_домен.ru.ru/api/v1/external/available_cities
‘PHONE’=>’89998887700’,
‘EMAIL’=>’test@ya.ru’,
‘VIN’=>’WVWZZZ3BZXP082500’,
‘CAR_BRAND’=>’Volkswagen’,
‘CAR_MODEL’=>’Passat’,
‘CAR_ENGINE_TYPE’=>’бензин’,
‘CAR_YEAR’=>’2005’,
‘PARTS’=>’Колодки тормозные задние, щетки, масло и руль’,

];

//apikey просто добавляется в request
$request[‘APIKEY’] = $apikey;
$post_data = http_build_query($request);

$ch = curl_init($api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADER, false);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);

$raw_response = curl_exec($ch);
curl_close($ch);

$raw_response = json_decode($raw_response,true);
var_dump($raw_response);

 

Обновлено Август 7, 2018