Подключение сайта по API

Вы можете настроить интеграцию с лендингом, который лежит на стороннем сервисе. Для этого нужно написать скрипт обработчик, на котором будут собираться заказы с лендинга. Со скрипта будут по API уходить запросы в систему на добавление заказов в проекте.

API (Application Programming Interface) - описание способов, которыми одна компьютерная программа может взаимодействовать с другой программой. Простыми словами в рамках нашего сервиса, это способ или инструмент, через который можно настроить интеграцию (связь) между нашей системой и другими сервисами.

Для передачи заказов в проект можно использовать любое API, как расширенное, так и для вебмастеров.


API для вебмастеров

Документация — https://demo-1.leadvertex.ru/webmaster/api.html

Плюсы этого способа:
- API для вебмастеров есть на всех базовых тарифах;
- такой метод подходит вебмастерам для подключения собственных лендингов к вашему проекту.

Минусы способа:
- При работе с несколькими вебмастерами нужна доработка сайта и более сложная версия скрипта для закрепления заказов за вебмастерами;
- Заменять API key в ЛК вебмастеров неудобно, подключать новых вебмастеров к этому лендингу проблематично.


Для подключения вам нужно выполнить следующие шаги:

  1. Откройте сайт своей партнерской программы в LeadVertex и зарегистрируйтесь в качестве вебмастера
    59e029e746.png
  2. В личном кабинете вебмастера перейдите в проект, в который планируете передавать заказы и откройте вкладку API


    49ee196f62.png
  3. Перейдите к методу "Импорт заказов" #addOrder и используйте url для отправки запросов, а также доступные параметры для составления скрипта. Скопируйте ID товаров со склада в вашем проекте. *

  4. В кабинете администратора как предприниматель перейдите в проект, в который будут передаваться заказы. Откройте на верхней панели управления "Вебмастеры" - Персональные параметры. Выберите свой зарегистрированный аккаунт вебмастера и откройте карточку с персональными настройками через кнопку "редактировать" (карандаш)
    e324d7f796.png
    В персональных настройках разрешите себе как вебмастеру Импорт заказов по API.


* На стороне вашего хостинга вы должны выполнить ряд настроек. Вам нужно написать скрипт, который будет отправлять запросы в CRM на добавление заказа. После чего настроить форму заказа на сайте на передачу заявок на этот скрипт.

К сожалению, невозможно подготовить универсальный скрипт, который бы вы могли скачать и поставить на свой хостинг (для этого вы можете использовать не API, а встраивание кода сгенерированной в проекте формы на сайт). Но мы сделали пример скрипта для очень простой формы на сверстанном лендинге.

Вот пример скрипта для передачи заказов с именем и номером телефона клиента и товарами, который клиент заказал:


 <?php
$project = "название проекта";
$webmasterID = "id вебмастера в проекте";
$apiKey = "ключ для API вебмастера";


function sendOrder($orderData, $project, $apiKey, $webID)
{
    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL =>
            "http://{$project}.leadvertex.ru/api/webmaster/v2/addOrder.html?webmasterID={$webID}&token={$apiKey}",
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST => true,
        CURLOPT_HTTPHEADER => [
            'Content-Type' => 'application/x-www-form-urlencoded'
        ],
        CURLOPT_POSTFIELDS => http_build_query($orderData)
    ]);
    $response = curl_exec($ch);
    curl_close($ch);
    return $response;
}


$productList = [
    0 => [
        'goodID' => 15,
        'quantity' => 1,
        'price' => 500
    ]
];
$orderData = [
    'fio' => $_POST['name'],
    'phone' => $_POST['phone'],
    'goods' => $productList,
];
sendOrder($orderData, $project, $apiKey, $webmasterID);


При этом в файле index в коде лендинга в параметр action формы вы прописываете название скрипта, который загрузили в директорию.




Расширенное API

Документация — https://demo-1.leadvertex.ru/admin/page/api.html

Плюсы:
- Простое подключение;
- Возможность легко подключить нового вебмастера;
- Много параметров для передачи данных в проект;
- Несложно адаптировать настройку под разные проекты.

Минусы:
- Расширенное API есть не на всех тарифах.


Для подключения вам нужно выполнить следующие шаги:

  1. Войдите в проект - Настройки - Модули - API. Заполните пароль для доступа к API и сохраните изменения.

  2. Откройте на этой же странице специальную ссылку на документацию к API уже с паролем для доступа к API и названием проекта.


    2ffd304a8c.png
  3. На стороне хостинга напишите скрипт для передачи заказов в проект, используя данные из открывшейся документации. Настройте формы на сайте таким образом, чтобы данные передавались на этот скрипт. *


* Вот простой пример скрипта для передачи заказов через API для администратора (расширенный)

<?php
$project = "название проекта";
$project = "название проекта";
$apiKey = "ключ для API проекта";
function sendOrder($orderData, $project, $apiKey)
{
    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL => "http://{$project}.leadvertex.ru/api/admin/addOrder.html?token={$apiKey}",
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST => true,
        CURLOPT_HTTPHEADER => [
            'Content-Type' => 'application/x-www-form-urlencoded'
        ],
        CURLOPT_POSTFIELDS => http_build_query($orderData)
    ]);
    $response = curl_exec($ch);
    curl_close($ch);
    return $response;
}
$productList = [
    0 => [
        'goodID' => 15,
        'quantity' => 1,
        'price' => 500
    ]
];
$orderData = [
    'fio' => $_POST['name'],
    'phone' => $_POST['phone'],
    'goods' => $productList,
];
sendOrder($orderData, $project, $apiKey);


Вы можете настроить интеграцию сайта своими силами, а можете заказать выполнение данной работы у наших специалистов через тикеты.

Заявка на обратный звонок

Мы работаем с 8-00 до 20-00 каждый день.
Пожалуйста, укажите время для обратного звонка в рабочие часы нашей поддержки!