Уебхукове за формуляри

Уебхукът е най-бързият начин отговорът на формуляр да стигне до вашата система. Не е нужно да питате „има ли нещо ново?“ — Gatherino извиква вашата крайна точка в мига, в който пристигне отговор.

Добре е да знаете: редакторът и потребителският профил в Gatherino са на английски или чешки език. Формулярите, които попълват респондентите ви, могат да се показват на 18 езика, включително български.

Типични употреби

Запис във вашата система

Поръчка директно във вашия магазин, запитване в CRM или кандидатура във вътрешна база данни.

Свързване с инструменти за автоматизация

Насочете уебхука към всяка услуга, която приема входящи уебхукове — обикновено Zapier, Make или n8n.

Персонализирани известия

Съобщение във вътрешен чат, SMS шлюз или във вашето собствено табло.

Как да го настроите

  1. 1

    Подгответе крайна точка

    URL адрес на вашия сървър, който приема HTTPS POST заявка с тяло в JSON формат.

  2. 2

    Добавете URL адреса към формуляра

    Въведете URL адреса на уебхука в настройките на формуляра или използвайте стъпка с уебхук в автоматизация.

  3. 3

    Обработете данните

    Тялото съдържа отговора, включително стойностите на полетата. Ключовете са идентификаторите на полетата във формуляра — извлечете техните етикети от подробностите за формуляра през API.

  4. 4

    Тествайте го

    Изпратете тестов отговор и се уверете, че вашата система е получила и обработила заявката.

Пример за приемане (Node.js)

Минимален приемник, който съхранява изпратеното от вашата страна:

app.post('/gatherino-hook', express.json(), (req, res) => {
  const submission = req.body;
  // submission.data holds the form field values
  saveToDatabase(submission);
  res.sendStatus(200);   // respond fast, do the work in the background
});

Сигурност: уебхукове достигат само до публични HTTPS адреси — заявки към вътрешни и частни IP диапазони се блокират, така че уебхукът не може да се използва за сондиране на вашата вътрешна мрежа. Защитете крайната си точка със секретен токен в URL адреса и проверявайте дали съдържанието е такова, каквото се очаква.

Често задавани въпроси

В какъв формат са данните?

JSON, описващ изпращането — идентификатор, времева марка, статус и обект със стойностите на полетата.

Какво става, ако сървърът ми временно не работи?

Приемете заявката бързо и прехвърлете обработката във фонов режим. Винаги можете да допълните липсващите данни през REST API.

Мога ли да имам повече от един уебхук?

Да — освен уебхука на ниво формуляр, можете да добавяте стъпки с уебхук в автоматизации, с условия.

Работи ли със Zapier или Make?

Да, просто поставете входящия URL адрес на уебхука, който генерират тези услуги, във формуляра.

Свързани материали

Опитайте Gatherino безплатно

Безплатен план: 3 формуляра и 100 отговора месечно. Без кредитна карта, данните се съхраняват в ЕС.

Започнете безплатно →