Форма на сайте есть, менеджеры работают в Битрикс24, а заявки теряются по дороге: письмо ушло в спам, заявка создалась без ответственного, уведомление никто не увидел. Сама связка простая. Сложность в том, что происходит при сбое.
Вебхук или приложение
Для заявок с одного сайта обычно хватает входящего вебхука. Это адрес с секретным кодом, который даёт доступ к методам REST API в пределах выбранных прав. Запросы выполняются с правами сотрудника, создавшего вебхук. Приложение нужно, если решение ставится на много порталов.
- Вебхук создаётся в разделе «Разработчикам»: Готовые сценарии, Другое, Входящий вебхук.
- Кому можно создавать вебхуки, определяет администратор в настройках безопасности.
- Права выбирайте минимальные: для заявок хватит CRM.
- Делайте один вебхук на одну интеграцию, чтобы отключать их независимо.
- Заводите вебхук не на личного менеджера, а на отдельную учётную запись.
Почему форма не должна обращаться к Битрикс24 напрямую
Документация советует не размещать адрес вебхука в клиентском коде. Если форма отправляет заявку из браузера, адрес виден любому посетителю. Поэтому браузер передаёт заявку на ваш сервер, а сервер обращается к Битрикс24. Для рабочих интеграций документация рекомендует POST: адреса GET-запросов могут попасть в логи и историю браузера.
Каким методом создавать заявку
Метод crm.lead.add встречается во многих инструкциях, но его развитие остановлено, вендор советует crm.item.add. Если заказываете новую интеграцию, спросите подрядчика, каким методом она работает.
Что ломается на практике
При ошибке REST API отвечает кодом 40x или 50x, а в теле ответа приходят error и error_description. Интеграция должна проверять ответ, а не считать заявку созданной после отправки.
Вторая причина сбоев это лимиты. На тарифах ниже Энтерпрайз счётчик запросов уменьшается на 2 в секунду при пороге 50, на Энтерпрайз на 5 в секунду при пороге 250. При превышении портал отвечает кодом 503 и ошибкой QUERY_LIMIT_EXCEEDED. Для одной формы это не страшно, для массовой выгрузки нужна очередь с паузами.
- Проверяйте ответ Битрикс24, а не только факт отправки.
- При ошибке лимита повторяйте запрос с растущей паузой, так советует документация.
- Храните заявку у себя, пока Битрикс24 не подтвердил создание.
- Настройте уведомление ответственному, если заявки перестали создаваться.
Дубли
Клиент оставил заявку второй раз, и у менеджера две карточки. Метод crm.duplicate.findbycomm ищет лиды, контакты и компании по телефону или почте, до 20 значений за запрос. Перед созданием заявки можно проверить, есть ли такой клиент, и дописать обращение в его карточку.
В самой CRM есть автоматический поиск дублей, по умолчанию раз в день. Мастер контроля дубликатов доступен не на всех тарифах. После объединения остаётся самая ранняя карточка, остальные можно восстановить из корзины CRM.
Откуда пришла заявка
Передавайте в заявку метки рекламы и страницу отправки. Через месяц станет видно, какие каналы приносят заявки, а не только клики.
Источники