# Űrlap: beküldések küldése Slackre, Discordra és webhookra (Zapier)

> A Slack, a Discord és a Webhook művelet beállítása: a token és az URL beszerzése, mi megy át a beküldésből, korlátozások és hibaelhárítás.

Az **Űrlap** widget minden beküldést el tud küldeni egy csevegőcsatornára vagy egy webhook-címre. Mindhárom művelet a Pro változatban érhető el (az ingyenes bővítmény nem listázza őket), és az **Űrlap** widgetet be kell kapcsolni a **The Plus Addons → Widgets** oldalon.

## A műveletek hozzáadása

1. Add hozzá az **Űrlap** widgetet az oldalhoz, és állítsd be a mezőket.
2. A **Küldési műveletek** szakasz **Művelet hozzáadása** mezőjében vedd fel a **Slack**, a **Discord** vagy a **Webhook** műveletet.
3. A panelen megjelenik a kiválasztott művelet saját szakasza. Töltsd ki, majd tedd közzé az oldalt.

![A Küldési műveletek szakasz a Művelet hozzáadása mezővel](./kepek/urlap-builder-panel-muveletek-integraciok.webp)

*A Küldési műveletek szakasz a Művelet hozzáadása mezővel* (https://minta-bolt.hu/wp-admin/post.php?post=356&action=elementor)

A képen a **Művelet hozzáadása** mező látszik: ide kerülnek a kiválasztott műveletek, és mindegyiknek külön szakasza lesz a panelen.

## Slack

Szükséged van egy Slack-munkaterületre, ahol alkalmazást telepíthetsz, egy felhasználói OAuth-tokenre és a csatorna nevére. Minden beküldés egy üzenetként érkezik a csatornára.

**A token beszerzése:**

1. Jelentkezz be a Slack API oldalára (api.slack.com), kattints a **Your apps** pontra, majd a **Create an App** gombra.
2. Válaszd a **From scratch** lehetőséget, nevezd el az alkalmazást, válaszd ki a munkaterületet, és kattints a **Create App** gombra.
3. A bal oldali sávban nyisd meg az **OAuth & Permissions** oldalt.
4. A **User Token Scopes** alatt add hozzá a `chat:write` jogosultságot. Az űrlapnak csak erre van szüksége.
5. Görgess feljebb, kattints az **Install to** (a munkaterületed neve) gombra, majd az **Allow** gombra. Ha nem vagy a munkaterület adminisztrátora, a Slack a kérést elküldi az adminisztrátornak.
6. Másold ki a megjelenő **User OAuth Token**-t.

![A Slack szakasz a Felhasználói OAuth-token és a Csatorna neve mezővel](./kepek/urlap-builder-panel-slack.webp)

*A Slack szakasz a Felhasználói OAuth-token és a Csatorna neve mezővel* (https://minta-bolt.hu/wp-admin/post.php?post=356&action=elementor)

A képen a két mező látszik: **Felhasználói OAuth-token** és **Csatorna neve**.

| Beállítás | Mit írj bele |
|---|---|
| **Felhasználói OAuth-token** | A tokent a Slack **OAuth & Permissions** oldaláról másold ki, `xoxp-` kezdetű |
| **Csatorna neve** | A csatorna, amelyre az üzenetek érkezzenek, például `#weboldal-erdeklodok` |

Működés: minden beküldés egy üzenet. Az üzenet a mezőket „mezőazonosító: érték” alakban sorolja fel, utána a dátumot, az időt, az oldal URL-jét, a böngészőt és az IP-címet.

Minden mező átmegy, a személyes adatok is. Ha az űrlap érzékeny adatot gyűjt, privát csatornát használj.

Ha nem érkezik üzenet a csatornára, ellenőrizd, hogy a tokennek megvan a `chat:write` felhasználói jogosultsága, és hogy a csatorna nevét jól írtad.

## Discord

Szükséged van egy Discord-szerverre, ahol webhookokat kezelhetsz, és a webhook URL-jére. Minden beküldés egy üzenetként érkezik a webhookhoz kiválasztott csatornára.

**A webhook URL beszerzése:**

1. A Discordban kattints a szervered nevére, és válaszd a **Server Settings** pontot.
2. A bal oldali sávban kattints az **Integrations** elemre, és hozz létre egy webhookot.
3. Nyisd meg a webhookot, válaszd ki a csatornát, amelyre posztolni fog, és kattints a **Copy Webhook URL** gombra.

![A Discord szakasz a Discord-URL és a Felhasználónév mezővel](./kepek/urlap-builder-panel-discord.webp)

*A Discord szakasz a Discord-URL és a Felhasználónév mezővel* (https://minta-bolt.hu/wp-admin/post.php?post=356&action=elementor)

A képen a **Discord-URL** és a **Felhasználónév** mező látszik.

| Beállítás | Mit írj bele |
|---|---|
| **Discord-URL** | A kimásolt webhook URL, `https://discord.com/api/webhooks/` kezdetű |
| **Felhasználónév** | A név, amely alatt az üzenetek megjelennek. Ha üresen hagyod, a **Form Bot** nevet kapják |

Működés:

- Minden beküldés egy üzenet, amely felsorolja a mezőket és értéküket, utána a dátumot, az időt, az oldal URL-jét, a böngészőt és az IP-címet.
- A hosszú beküldések több üzenetre bomlanak.
- Csak a discord.com vagy discordapp.com címen lévő webhook-URL-t fogadja el a művelet.
- Minden mező átmegy, a személyes adatok is. Ha kell, privát csatornára posztolj.

## Webhook (például Zapier)

A **Webhook** művelet minden beküldést elküld egy tetszőleges webhook-címre, így az adatok egy CRM-be, táblázatba vagy sok más alkalmazásba juthatnak, például a Zapieren át.

**A webhook URL beszerzése a Zapierben:**

1. Jelentkezz be a Zapierbe, hozz létre egy új Zapet, és kattints a **Trigger** elemre.
2. Keress rá a **Webhooks** szolgáltatásra, és válaszd ki.
3. A **Trigger event** értéke legyen **Catch Hook**, majd kattints a **Continue** gombra.
4. A **Pick off a Child Key** mezőt hagyd üresen, és kattints újra a **Continue** gombra.
5. Másold ki a webhook URL-jét.

![A Webhook szakasz az URL mezővel](./kepek/urlap-builder-panel-webhook.webp)

*A Webhook szakasz az URL mezővel* (https://minta-bolt.hu/wp-admin/post.php?post=356&action=elementor)

A képen az **URL** mező látszik.

| Beállítás | Mit írj bele |
|---|---|
| **URL** | A webhook-cím, például a Zapier Catch Hook URL-je |

Működés:

- Minden beküldés POST kérésként, JSON-nal megy el. A `fields` a mezők Egyedi ID-ját és értékét tartalmazza, a `message` pedig szöveges összefoglalót a dátummal, idővel, oldal URL-jével, böngészővel és IP-címmel.
- A Zapierben küldj egy próbabeküldést, és kattints a **Test trigger** gombra: így látod a mezőket.
- A Slack és a Discord bejövő webhookjának URL-je is működik itt, az üzenetet ezekhez igazítva küldi el.

Korlátozások:

- A kérés mindig POST.
- A saját szervereden vagy helyi hálózati címen lévő webhookot a biztonság miatt blokkolja a bővítmény.

## Hibaelhárítás

Ha a látogató a „There was an error in submitting the form.” üzenetet látja, a szolgáltató elutasította a kérést. Másold ki újra az URL-t vagy a tokent szóközök nélkül, és próbáld újra. Amíg ez a hiba látszik, az **Átirányítás** művelet nem fut le.