Интеграция с собственным сайтом

"Полигон: CRM" предоставляет возможность интеграции с собственными сайтами для автоматического сбора лидов из форм. Интеграция осуществляется по технологии Webhook, что позволяет передавать данные из форм напрямую в CRM-систему в режиме реального времени.

Создание формы для отправки данных

Чтобы подключить Полигон: CRM к вашему сайту, необходимо добавить разработанный скрипт в код сайта.

В коде добавляем стандартные поля формы для ввода:

Имя заказчика – firstName
Фамилия заказчика – lastName
Телефон – phoneNumber
Адрес объекта недвижимости – address

В форму заявки вы можете добавить следующие поля:

Имя переменной API	Обозначение
`lastName`	Фамилия заказчика
`firstName`	Имя заказчика
`patronymic`	Отчество заказчика
`email`	Эл. почта
`phoneNumber`	Номер телефона
`comment`	Комментарий
`address`	Адрес объекта
`cadastralNumber`	Кадастровый номер объекта
`files`	Файлы заявителя, которые необходимо приложить к задаче для менеджера

Внимание

Метод обязывает передавать:

Фамилию
Номер телефона или эл. почту
Адрес или кадастровый номер

Подробнее вы можете ознакомиться в технической документацией http://92.255.231.155:5037/swagger/index.html

Как настроить ввод адресов?

Одним из важных и необходимых полей в форме является адрес объекта недвижимости.

Для удобства ввода адреса ваших потенциальных клиентов используйте сервис подсказок Полигон: API Адрес.

Полигон: API Адрес – сервис, обеспечивающий быстрый и корректный ввод адресов на вашем сайте.

Как работает сервис:

Клиент вводит адрес вручную.
Система распознает адрес по первым буквам и подскажет верное написание.
Система выводит структурированный адрес в одну строку или по нескольким реквизитам.

Пример программного кода интеграции Полигон: CRM и вашего сайта

<!doctype html>
<body>
    <form id="formElem">
        <input type="text" name="firstName" value="John">
        <input type="text" name="lastName" value="Smith">
        <input type=“text“ name =“email“ value = test@mail.ru>
        <input type="submit">
    </form>

    <script>
        formElem.onsubmit = async (e) => {
            e.preventDefault();

            let response = await fetch('/article/formdata/post/user', {
                headers: {
                    'Content-Length': file.length
                    'Authorization: Bearer <authorization token>',
                    'Content-Type': 'multipart/form-data'
                },
                method: 'POST',
                body: new FormData(formElem)
            });

            let result = await response.json();
            alert(result.message);
        };
    </script>
</body>

После заполнения формы и сопоставления их с объектом formData производится отправка с использованием метода «POST». При использовании метода необходимо передавать определенные заголовки.

Для передачи данных вам потребуется авторизационный токен.

headers: {
    'Content-Length': file.length
    'Authorization: Bearer <authorization token>',
    'Content-Type': 'multipart/form-data'
},

Откуда взять интеграционный токен?

Интеграционный токен может получить владелец или администратор в Полигон: CRM. Для этого перейдите в раздел «Настройки» → «Профиль компании» и скопируйте значение из поля.

image alt center

Как заявка попадает в CRM-систему?

После того, как потенциальный клиент заполнит форму на вашем сайте и отправит ее, заявка направляется в Полигон: CRM.

image alt center

В разделе «Задачи» создается новая задача о необходимости обработать заявку клиента. Задача содержит контакты клиента и информацию об объекте недвижимости. Обработать заявку необходимо в течение 24 часов с момента ее поступления в систему.