Súgó · Összekötések

Webhook: beküldés a saját rendszeredbe

Minden beküldésről JSON-t küldünk POST kéréssel a megadott címre, aláírással. Fejlesztőknek és saját integrációkhoz.

English summary: Every submission is POSTed as JSON to your URL with an HMAC-SHA256 signature header; retries for a day; 410 disables the hook.

Ha saját rendszered van (CRM, készletkezelő, webshop), a webhookkal azonnal megkapja a beküldéseket. Ugyanez a JSON megy a Make, az n8n és a Zapier felé is.

Beállítás

  1. 1Cím. Szerkesztő → Összekötések → Saját rendszer: add meg a HTTPS-címet, mentsd. Azonnal küldünk egy próbát mintaadatokkal.
  2. 2Válasz. A 2xx válasz jelenti a sikert (10 másodpercen belül). Más válasznál vagy időtúllépésnél újrapróbáljuk; a 410-es válasz kikapcsolja az összekötést.
  3. 3Aláírás. Az Aláíró kulcs gombbal kapod a titkot; ezzel ellenőrizheted, hogy a kérés tényleg tőlünk jött.

A kérés

Fejlécek: X-FormEmpire-Event (submission.created, submission.partial vagy test), X-FormEmpire-Delivery (a küldés azonosítója, újrapróbálásnál ugyanaz), X-FormEmpire-Timestamp, X-FormEmpire-Signature.

Az answers a mezők kulcsával (a mező beállításainál „Kulcs a linkes előtöltéshez”) lapos objektum, a fields a teljes leírás címkével. A csatolmányok linkje belépés nélkül 30 napig tölthető le.

{
  "event": "submission.created",
  "deliveryId": "cm…",
  "sentAt": "2026-10-07T10:15:00.000Z",
  "test": false,
  "form": { "id": "cm…", "name": "Ajánlatkérés" },
  "submission": { "id": "cm…", "createdAt": "…", "partial": false,
                  "url": "https://formempire.hu/app/bekuldesek/cm…", "page": "https://pelda.hu/kapcsolat" },
  "answers": { "nev": "Kiss Anna", "e_mail_cim": "anna@pelda.hu", "darabszam": 3 },
  "fields": [{ "id": "f…", "key": "nev", "label": "Név", "type": "short", "value": "Kiss Anna", "text": "Kiss Anna" }, …]
}

Az aláírás: sha256=HMAC_SHA256(titok, timestamp + "." + nyers_törzs). Ellenőrizd a timestampet is (±5 perc). Ugyanaz a beküldés ritkán kétszer is megérkezhet (pl. kézi újraküldés), a submission.id alapján szűrheted.

Félbehagyott kitöltések

Az összekötésnél bekapcsolhatod, hogy a félbehagyott kitöltéseket is küldje: 20 perc tétlenség után „submission.partial” eseményként. Ha később beküldik, rendes beküldésként is megérkezik.

Napló és újrapróbálás

Minden küldés a szerkesztő Összekötések fülén, a kártya Napló gombja alatt látszik. Ha a fogadó nem válaszol vagy hibát ad, 1, 5, 30 perc, 2 és 8 óra múlva újrapróbáljuk; ha egy napon át nem sikerül, e-mailt küldünk (naponta legfeljebb egyet), és a naplóból kézzel újraküldheted. A beküldés közben nem vész el, a FormEmpire-ben megvan.

Kinek érhető el?

A webhook a Pro csomag része, a többi összekötéssel és az API-val együtt. Egy űrlaphoz legfeljebb tíz összekötés tartozhat, egyszerre többféle is.

Kapcsolódó: MailerLite-összekötés · SalesAutopilot-összekötés · Mailchimp-összekötés · Make (ex-Integromat) összekötés · Zapier-összekötés · n8n-összekötés · Google Sheets-összekötés · API-kulcs és a FormEmpire API

Frissítve: 2026. október 10.