В этой статье я поделюсь простым и рабочим способом, как настроить передачу заявок из формы Elementor прямо в Google Таблицу — без сторонних плагинов и дополнительных расходов. Всё будет работать только с помощью встроенной функции Webhook и бесплатного сервиса Google Apps Script.
Вот пошаговая инструкция — от пустой таблицы до работающих заявок из Elementor.
Смотреть на RuTube
Оглавление
1) Таблица и Apps Script
- Создайте новую Google Таблицу (Drive → New → Google Sheets).
- В таблице откройте Расширения → Apps Script.
- В редакторе удалите шаблонный код и вставьте ваш скрипт (тот, что вы прислали). Нажмите Сохранить (Ctrl/Cmd+S).
Код для добавления в Apps Script
/**
* Google app-script to utilise Elementor Pro From webhook.
*
* In order to enable this script, follow these steps:
*
* From your Google Sheet, from the "Exstensions" menu select "App Script"…
* Paste the script from this gist into the script code editor and hit Save.
* From the "Deploy" menu, select Deploy as web app…
* Choose to execute the app as yourself, and allow Anyone, even anonymous to execute the script. (Note: depending on your Google Apps instance, this option may not be available. You will need to contact your Google Apps administrator, or else use a Gmail account.)
* Now click Deploy. You may be asked to review permissions now.
* The URL that you get will be the webhook that you can use in your elementor form, You can test this webhook in your browser first by pasting it.
* It will say "Yepp this is the webhook URL, request received".
* Last all you have to do is set up and Elementor Pro Form with a form name and Webhook action pointing to the URL from above.
*
* Update: 09/06/2022
* - Name the sheet: you can now add a field (could be hidden) to your form labeled "e_gs_SheetName" and set the defualt value to the name of the sheet you want to use.
* - Set the Order: you can now add a form field (hidden) labeled "e_gs_order" and set its defualt value to the names of the columns you want to seperated by comma in the order you want, any other colum not in that list will be added after.
* - Exclude Columns: you can now add a field (could be hidden) labeled "e_gs_exclude" and set its value to the names of the columns you want to exclude seperated by comma.
*/
// Change to true to enable email notifications
let emailNotification = false;
let emailAddress = "Change_to_your_Email";
// DO NOT EDIT THESE NEXT PARAMS
let isNewSheet = false;
let postedData = [];
const EXCLUDE_PROPERTY = 'e_gs_exclude';
const ORDER_PROPERTY = 'e_gs_order';
const SHEET_NAME_PROPERTY = 'e_gs_SheetName';
/**
* this is a function that fires when the webapp receives a GET request
* Not used but required.
*/
function doGet( e ) {
return HtmlService.createHtmlOutput( "Yepp this is the webhook URL, request received" );
}
// Webhook Receiver - triggered with form webhook to published App URL.
function doPost( e ) {
let params = JSON.stringify( e.parameter );
params = JSON.parse( params );
postedData = params;
insertToSheet( params );
// HTTP Response
return HtmlService.createHtmlOutput( "post request received" );
}
/**
* flattenObject
* Flattens a nested object for easier use with a spreadsheet
* @param ob
* @returns {{}}
*/
const flattenObject = ( ob ) => {
let toReturn = {};
for ( let i in ob ) {
if ( ! ob.hasOwnProperty( i ) ) {
continue;
}
if ( ( typeof ob[ i ] ) !== 'object' ) {
toReturn[ i ] = ob[ i ];
continue;
}
let flatObject = flattenObject( ob[ i ] );
for ( let x in flatObject ) {
if ( ! flatObject.hasOwnProperty( x ) ) {
continue;
}
toReturn[ i + '.' + x ] = flatObject[ x ];
}
}
return toReturn;
}
/**
* getHeaders
* normalize headers
* @param formSheet
* @param keys
* @returns {*[]}
*/
const getHeaders = ( formSheet, keys ) => {
let headers = [];
// retrieve existing headers
if ( ! isNewSheet ) {
headers = formSheet.getRange( 1, 1, 1, formSheet.getLastColumn() ).getValues()[0];
}
const newHeaders = keys.filter( h => ! headers.includes( h ) );
headers = [ ...headers, ...newHeaders ];
// maybe set order
headers = getColumnsOrder( headers );
// maybe exclude headers
headers = excludeColumns( headers );
// filter out control columns
headers = headers.filter( header => ! [ EXCLUDE_PROPERTY, ORDER_PROPERTY, SHEET_NAME_PROPERTY ].includes( header ) );
return headers;
};
/**
* getValues
* normalize values
* @param headers
* @param flat
* @returns {*[]}
*/
const getValues = ( headers, flat ) => {
const values = [];
// push values based on headers
headers.forEach( ( h ) => values.push( flat[ h ] ) );
return values;
}
/**
* insertRowData
* inserts values to a given sheet at a given row
* @param sheet
* @param row
* @param values
* @param bold
*/
const insertRowData = ( sheet, row, values, bold = false ) => {
const currentRow = sheet.getRange( row, 1, 1, values.length );
currentRow.setValues( [ values ] )
.setFontWeight( bold ? "bold" : "normal" )
.setHorizontalAlignment( "center" );
}
/**
* setHeaders
* Insert headers
* @param sheet
* @param values
*/
const setHeaders = ( sheet, values ) => insertRowData( sheet, 1, values, true );
/**
* setValues
* Insert Data into Sheet
* @param sheet
* @param values
*/
const setValues = ( sheet, values ) => {
const lastRow = Math.max( sheet.getLastRow(), 1 );
sheet.insertRowAfter( lastRow );
insertRowData( sheet, lastRow + 1, values );
}
/**
* getFormSheet
* Find or create sheet for form
* @param sheetName
* @returns Sheet
*/
const getFormSheet = ( sheetName ) => {
const activeSheet = SpreadsheetApp.getActiveSpreadsheet();
// create sheet if needed
if ( activeSheet.getSheetByName( sheetName ) == null ) {
const formSheet = activeSheet.insertSheet();
formSheet.setName( sheetName );
isNewSheet = true;
}
return activeSheet.getSheetByName( sheetName );
}
/**
* insertToSheet
* magic function where it all happens
* @param data
*/
const insertToSheet = ( data ) => {
const flat = flattenObject( data ),
keys = Object.keys( flat ),
formSheet = getFormSheet( getSheetName( data ) ),
headers = getHeaders( formSheet, keys ),
values = getValues( headers, flat );
setHeaders( formSheet, headers );
setValues( formSheet, values );
if ( emailNotification ) {
sendNotification( data, getSheetURL() );
}
}
/**
* getSheetName
* get sheet name based on form field named "e_gs_SheetName" if exists or used form name
* @param data
* @returns string
*/
const getSheetName = ( data ) => data[SHEET_NAME_PROPERTY] || data["form_name"];
/**
* getSheetURL
* get sheet url as string
* @returns string
*/
const getSheetURL = () => SpreadsheetApp.getActiveSpreadsheet().getActiveSheet().getUrl();
/**
* stringToArray
* split and trim comma seperated string to array
* @param str
* @returns {*}
*/
const stringToArray = ( str ) => str.split( "," ).map( el => el.trim() );
/**
* getColumnsOrder
* used to set the columns order, set this by adding a form field (hidden) named "e_gs_order"
* and set its value to the names of the columns you want to seperated by comma in the order you want,
* any other colum not in that field will be added after
* @param data
* @param headers
* @returns {*}
*/
const getColumnsOrder = ( headers ) => {
if ( ! postedData[ORDER_PROPERTY] ) {
return headers;
}
let sortingArr = stringToArray( postedData[ORDER_PROPERTY] );
// filter out non existing headers
sortingArr = sortingArr.filter( h => headers.includes( h ) );
// filterout sorted headers
headers = headers.filter( h => ! sortingArr.includes( h ) );
return [ ...sortingArr, ...headers ];
}
/**
* excludeColumns
* used to exclude columns, set this by adding a form field (hidden) named "e_gs_exclude"
* and set its value to the names of the columns you want to exclude seperated by comma
* @param data
* @param headers
* @returns {*}
*/
const excludeColumns = ( headers ) => {
if ( ! postedData[EXCLUDE_PROPERTY] ) {
return headers;
}
const columnsToExclude = stringToArray( postedData[EXCLUDE_PROPERTY] );
return headers.filter( header => ! columnsToExclude.includes( header ) );
}
/**
* sendNotification
* send email notification if enabled
* @param data
* @param url
*/
const sendNotification = ( data, url ) => {
MailApp.sendEmail(
emailAddress,
"A new Elementor Pro Forms submission has been inserted to your sheet", // mail subject
`A new submission has been received via ${data['form_name']} form and inserted into your Google sheet at: ${url}`, //mail body
{
name: 'Automatic Emailer Script'
}
);
}; 2) Публикация как веб-приложение
- Вверху нажмите Развернуть → Новое развертывание.
- В карточке развертывания нажмите Выбрать тип (иконка шестерёнки) → Web app (Веб-приложение).
- Поля заполните так:
- Описание: например,
Leads. - Execute as (Кто выполняет): Me / Я.
- Who has access (Кому доступно): Anyone / Anyone, even anonymous.
- Нажмите Развернуть → подтвердите права (Review permissions) и разрешите доступ.
- Скопируйте URL из блока “Веб-приложение” (не из “Библиотека”!).
- Проверка: откройте этот URL в браузере — должны увидеть:
Yepp this is the webhook URL, request received.
Если меняете код позднее — делайте Развернуть → Управление развертываниями → Редактировать → Развернуть, чтобы получить актуальную версию по тому же URL.
3) Подключение в Elementor
- Откройте нужную форму в Elementor (Form).
- В Actions After Submit укажите:
Email(если хотите продолжать получать письма),Webhook.
- Появится вкладка Webhook — вставьте URL веб-приложения из Apps Script.
- Вверху задайте Form Name (имя формы) — простое и латиницей, например
LandingLeads. - Сохраните страницу и протестируйте отправку.
- В таблице появится новый лист с именем формы и строка с данными.
4) Если форм несколько → отдельные листы в одной таблице
В вашем скрипте имя листа берётся из:
- поля
e_gs_SheetName(если есть), иначе - Form Name в Elementor.
Варианты:
- Хотите, чтобы у каждой формы был свой лист → дайте разные Form Name.
- Хотите вручную задать имя листа → добавьте в форму скрытое поле:
- Type: Hidden
- Label:
e_gs_SheetName - Default Value: например,
ConsultRequests. - Этот же URL вебхука вставьте в каждую форму — скрипт сам разложит заявки по листам.
5) Быстрая диагностика, если видите “Webhook error”
- 403/ошибка вебхука чаще всего из-за доступа: проверьте, что развернули как Web app с Anyone и Execute as: Me.
- Откройте URL в браузере — должна быть строка «Yepp…».
- В Apps Script слева Executions / Запуски — там видны входящие запросы и ошибки (например, из-за отсутствия прав к таблице).
- Убедитесь, что в форме есть Form Name и он без спецсимволов.
- Если не хотите создавать новый лист — заранее создайте лист с нужным именем или используйте
e_gs_SheetName.
Готово! Теперь заявки уходят и на email (если действие
