Заявки с форм сайта в CRM

Как подключить

Заявка попадает в CRM без почты и таблиц

Подойдёт любая форма, квиз или калькулятор, у которых есть обработчик на сервере.

Выпустите ключ
«Настройки компании», страница «API-ключи», кнопка «Выпустить ключ». Значение показывается один раз.
Сохраните ключ на сервере
В настройках сервера, а не в коде страницы и не в JavaScript.
Добавьте запрос
В обработчике формы отправьте данные на POST /api/v1/leads. Заявка сразу появится в списке.

Пример

Десяток строк в обработчике формы

Ответы 201 и 200 означают одно: заявка у менеджера. В первом случае создана новая, во втором обращение добавлено к существующей.

Метки рекламыUTM, страница формы и реферер сохраняются в блоке «Аналитика» карточки.
Данные посетителяIP-адрес и браузер передаёт ваш сервер: CRM не подставляет вместо них свои.
Запасной путьЕсли CRM не ответила, сохраните заявку у себя и повторите запрос позже.

PHP: обработчик формы

$lead = [
    'name'      => $_POST['name'] ?? '',
    'phone'     => $_POST['phone'] ?? '',
    'message'   => $_POST['message'] ?? '',
    'source'    => 'Сайт example.com',
    'form_page' => $_SERVER['HTTP_REFERER'] ?? '',
];

$ch = curl_init('https://crm.linkodium.com/api/v1/leads');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => json_encode($lead),
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'X-API-Key: ' . getenv('CRM_API_KEY'),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$body = curl_exec($ch);

// 201: новая заявка, 200: повторное обращение

Поля запроса

Что можно передать

Передавайте то, что знаете о клиенте. Контакты, текст обращения и метки менеджер увидит в карточке заявки.

Поле	Что передавать
`name, phone, email`	Контакты клиента. Обязательно хотя бы одно из трёх
`message`	Текст обращения
`client_needs`	Что нужно клиенту: например, название формы или квиза
`source`	Источник: название сайта или рекламной кампании
`service`	Услуга, любой текст
`company, website`	Компания и сайт клиента
`landing_page, form_page, referrer`	Страница первого захода, страница формы и откуда пришёл посетитель
`utm_source, utm_medium, utm_campaign, utm_term, utm_content`	Метки UTM
`ym_client_id`	ClientID Яндекс Метрики
`status`	Статус заявки. По умолчанию «Новая заявка»

Вопросы

Вопросы о заявках с сайта

Можно ли отправлять заявку прямо из JavaScript на странице?

Нет. Ключ API в коде страницы увидит любой посетитель. Форма должна отправлять данные на ваш сервер, а сервер передаёт их в CRM. Если сервера нет, посмотрите чат-виджет: он ставится одной строкой кода и тоже создаёт заявки.

Какие поля обязательны?

Хотя бы одно из трёх: имя, телефон или email. Остальные поля необязательны. Слишком длинные значения обрезаются, а неизвестные поля игнорируются: заявка из-за этого не теряется.

Как CRM понимает, что обращение повторное?

По телефону (сравниваются последние 10 цифр) или по email. Если у компании есть активная заявка с теми же контактами, новая не создаётся: в существующую добавляется событие «Повторное обращение», а в ответе приходит её номер и признак is_duplicate.

Что делать со спамом с форм?

Если антиспам формы пометил заявку, передайте её со статусом «Спам». Она сохранится в CRM под фильтром «Спам», но уведомление сотрудникам не уйдёт. Если антиспам ошибся, заявку легко найти.

Кому назначается заявка с сайта?

Менеджеру по умолчанию компании. Его выбирает администратор в разделе «Сотрудники». Сотрудники получают уведомление о новой заявке в Telegram по своим настройкам.

Дальше

Соберите все заявки в одном месте

Регистрация по коду из письма занимает минуту. Банковская карта не нужна.

Начать бесплатно

Формы сайта и API

Заявка попадает в CRM без почты и таблиц

Выпустите ключ

Сохраните ключ на сервере

Добавьте запрос