API по опрацюванню форм в G-PLUS CRM, надає можливість, передавати в CRM-систему ліди з форм сайту, іншого софту, сторонніх рішень.
Щоб створити новий лід в системі, використовуйте
POST https://crm.g-plus.app/api/actions
Опрацювання довільних форм
Форма надає можливість опрацьовувати довільні поля
| Field name | Description | |
| token | required | Your personal token |
| action | required | Should be “partner-custom-form” |
| partner_id | required | Your partner id |
| ip | IP address of the user who submitted a form on your site | |
| name | Name from the from | |
| phone | Phone from the form | |
| Email from the form | ||
| building_id | ID of the Building from CRM | |
| lang | Language code of the user who submitted a form (“en”, “ru”, “ua”, “ka”…) | |
| note | Note for this lead. For example: “Запит з форми зворотного дзвінка” | |
| adv_id | Custom identifier of this form. It is useful when adding the form handler in the Ad Center in your CRM. |
Поставити питання по використанню API ви можете в коментарях до запису, або персональному менеджеру.
Передача UTM-міток
Щоб передати такі маркетингові дані, як UTM-мітка, ви можете використати поля UTM у тілі запиту. Зверніть увагу, що ви можете передати поля UTM як у тілі POST так і в параметрах GET URL-адреси API:
utm_source | Example: google | |
utm_medium | Example: banner | |
utm_campaign | Example: promo_code | |
utm_term | Example: christmas | |
utm_content | Example: Christmas_present |
Популярні питання
1. Де отримати значення “partner_id” і “token”?
Щоб отримати значення для “partner_id” і “token” перейдіть на сторінку інтеграцій в вашій CRM системі.
2. Чому в мене немає доступу до сторінки інтеграцій в CRM?
Перевірте, що профайл (роль) в CRM був рівня адміністратор, керівник, або програміст. Імовірно, у вас інший рівень доступу (менеджер з продажу, економіст, бухгалтер). Ці ролі не мають доступу до налаштувань інтеграцій.
Приклад JavaScript для опрацювання форми на сайті забудовника
Наводимо приклад JavaScrip, який ви можете поставити на сторінку для опрацювання форм на сайті житлового комплексу чи сайті забудовника. (Налаштувати логіку розподілення лідів з форм, можна в центрі реклами)
var data = {
action: 'partner-custom-form',
token: 'TOKEN HERE',
partner_id: PARTNER ID HERE,
name: name,
phone: phone,
email: email,
building_id: BUILDING ID HERE,
lang: 'ua',
note: 'Запит з форми контактів',
adv_id: '123123123'
}
$.ajax({
url: 'https://crm.g-plus.app/api/actions',
method: 'post',
data: data
}).done(function(data) {
if (data.success) {
alert('Форму надіслано');
}
else {
alert('Помилка при відправлені форми');
}
});