Szervezet – Webhookok#

A Webhooks oldal az ügynökök más szolgáltatások eseményei általi indításához kapcsolódik. A webhookoknak köszönhetően az ügynökök reagálhatnak arra, ami a Mergadóban vagy a FreeScoutban történik – például egy befejezett feedexportra vagy egy új ügyfélválaszra.

Az oldal elrendezése#

Mergado-webhookok#

A Mergado-webhookok automatikusan elérhetők a szervezet számára, itt semmit sem kell beállítani. Hogy az ügynök a Mergado mely eseményeire reagáljon, azt közvetlenül az ügynöknél választod ki.

FreeScout#

A FreeScout rész a FreeScout ügyfélszolgálati rendszer csatlakoztatására szolgál. Tartalma:

• Base URL – a cím, amelyen a bővítmény a FreeScout eseményeit fogadja,
• a New webhook gomb,
• a létrehozott webhookok listája a számukkal.

Webhookokat az Owner és Admin szerepkör hozhat létre, szerkeszthet és törölhet; a többi tag csak a listát látja, és kimásolhatja az URL-t.

Új FreeScout-webhook#

1. Kattints a New webhook gombra, és add meg a Name mezőt (pl. „Support”). A mező alatt látod, hogyan fog kinézni a webhook URL-je.
2. A Secret Key mezőbe illeszd be azt a titkos kulcsot, amelyet a FreeScout a Manage » API & Webhooks menüpontban mutat. Ez minden kézbesítés aláírásának ellenőrzésére szolgál.
3. Az Add gombbal elmented a webhookot. Az URL véletlenszerű végződést kap, hogy egyedi legyen.
4. Másold ki a webhook URL-jét (a mellette lévő ikonnal), és add meg a FreeScoutban a Manage » API & Webhooks menüpontban.

A webhook kártyáján a következők találhatók:

• az URL a másolás gombbal,
• Used by – azok az ügynökök, amelyeket ez a webhook indít,
• ceruza a szerkesztéshez – módosíthatod a nevet vagy a Secret Key értékét; a Change webhook URL as well lehetőséggel új címet generálsz (a régi ezután nem működik, és a FreeScoutban ki kell cserélni; az ügynökök csatlakoztatva maradnak),
• kuka a törléshez – nem használható, amíg a webhookot valamelyik ügynök használja.

Egyéni események#

A FreeScout az esemény típusát az X-FreeScout-Event fejlécben küldi. A szokásos eseményeken túl (új beszélgetés, hozzárendelés, állapotváltozás, ügyfélválasz, ügyintézői válasz, megjegyzés, új vagy módosított ügyfél…) a webhook kártyáján az Add event lehetőséggel saját eseményt is megadhatsz – Name és Type (a fejléc értéke). Az egyéni események ezután az ügynök indítójának beállításakor is megjelennek.

Hogyan használhatók a webhookok?#

Az eseményekre adott reakciókat az ügynököknél, a Triggers részben, a Webhook lehetőséggel állítod be:

1. Kiválasztod a szolgáltatást (Mergado vagy egy konkrét FreeScout-webhook).
2. Kiválasztod a konkrét eseményt.
3. Mergadónál megadod a webáruházat és szükség esetén a projektet, amelyre az indító vonatkozik.

Amikor az esemény bekövetkezik, elindul az ügynök, és az eredmény új beszélgetésként jelenik meg [Hook] előtaggal, valamint a Dashboard oldal előzményeiben.

Mit tehetsz itt?#

• Létrehozhatsz egy FreeScout-webhookot, és megkaphatod az URL-jét.
• Egyéni eseménytípusokat adhatsz hozzá a FreeScoutból.
• Ellenőrizheted, mely ügynökök használják a webhookot.

GYIK#

Az indító nem indul el – hol keressem a hibát? Ellenőrizd az indító beállításait az ügynöknél (megfelelő esemény, webáruház és projekt). FreeScoutnál ellenőrizd, hogy a FreeScoutban a helyes URL van-e megadva, és egyezik-e a Secret Key. A beérkezett webhookokat a Dashboard oldal előzményeiben találod.

Kikapcsolhatom a webhookokat? A Mergado-webhookokat a Mergado oldalán kezelik. A bővítményben csak az ügynökök webhookos indítóit távolíthatod el. A FreeScout-webhookot ezen az oldalon törölheted, amint egyik ügynök sem használja.

Milyen események érhetők el? Mergadónál például az import, az export és a szabályok alkalmazásának eseményei, valamint a projektek, elemek, lekérdezések, szabályok és a kulcstartó módosításai. FreeScoutnál a beszélgetésekkel, válaszokkal és ügyfelekkel kapcsolatos események, valamint a saját egyéni eseményeid.

Indíthatnak a webhookok automatizálásokat? Nem, az automatizálások kézzel vagy ütemezés szerint indulnak. Eseményekre csak az ügynökök reagálnak.