Organizácia – Webhooky#

Stránka Webhooky súvisí so spúšťaním agentov udalosťami z iných služieb. Vďaka webhookom môžu agenti reagovať na to, čo sa stane v Mergade alebo vo FreeScoute – napríklad na dokončený export feedu alebo na novú odpoveď zákazníka.

Rozloženie stránky#

Webhooky Mergada#

Webhooky Mergada sú pre organizáciu dostupné automaticky, nič sa tu nenastavuje. Na ktoré udalosti z Mergada má agent reagovať, vyberiete priamo pri agentovi.

FreeScout#

Sekcia FreeScout slúži na napojenie helpdesku FreeScout. Obsahuje:

• Základnú URL, na ktorej aplikácia prijíma udalosti z FreeScoutu,
• tlačidlo Nový webhook,
• zoznam založených webhookov s počtom.

Webhooky zakladá, upravuje a maže rola Vlastník a Správca; ostatní členovia zoznam len vidia a môžu si skopírovať URL.

Nový FreeScout webhook#

1. Kliknite na Nový webhook a zadajte Názov (napr. „Podpora“). Pod poľom uvidíte, ako bude vyzerať URL webhooku.
2. Do poľa Secret Key vložte tajný kľúč, ktorý FreeScout zobrazuje v Manage » API & Webhooks. Slúži na overenie podpisu každého doručenia.
3. Tlačidlom Pridať webhook uložíte. URL dostane náhodnú koncovku, aby bola jedinečná.
4. URL webhooku skopírujte (ikonou vedľa nej) a zadajte ju vo FreeScoute v Manage » API & Webhooks.

Na karte webhooku je:

• URL s tlačidlom na skopírovanie,
• Používa – agenti, ktorých tento webhook spúšťa,
• ceruzka na úpravu – zmeníte názov alebo Secret Key; voľbou Zmeniť aj URL webhooku vygenerujete novú adresu (stará potom prestane fungovať a je potrebné ju vo FreeScoute vymeniť; agenti zostanú pripojení),
• kôš na zmazanie – nedá sa použiť, kým webhook používa niektorý agent.

Vlastné udalosti#

FreeScout posiela typ udalosti v hlavičke X-FreeScout-Event. Okrem bežných udalostí (nová konverzácia, priradenie, zmena stavu, odpoveď zákazníka, odpoveď agenta, poznámka, nový či upravený zákazník…) môžete na karte webhooku cez Pridať udalosť zadať aj vlastnú – Názov a Typ (hodnotu hlavičky). Vlastné udalosti sa potom ponúkajú pri nastavovaní spúšťača agenta.

Ako sa webhooky používajú#

Samotné reakcie na udalosti nastavujete pri agentoch v sekcii Spúšťače voľbou Webhook:

1. Vyberiete službu (Mergado alebo konkrétny FreeScout webhook).
2. Vyberiete konkrétnu udalosť.
3. Pri Mergade doplníte e‑shop a prípadne projekt, ktorých sa má spúšťač týkať.

Keď udalosť nastane, spustí sa agent a výsledok sa objaví ako nová konverzácia s predponou [Hook] a v histórii na stránke Prehľad.

Čo tu môžete urobiť#

• Založiť FreeScout webhook a získať jeho URL.
• Doplniť vlastné typy udalostí z FreeScoutu.
• Skontrolovať, ktorí agenti webhook používajú.

FAQ#

Spúšťač sa nespúšťa – kde hľadať chybu? Skontrolujte nastavenie spúšťača pri agentovi (správna udalosť, správny e‑shop a projekt). Pri FreeScoute overte, že je vo FreeScoute zadaná správna URL a že sedí Secret Key. Prijaté webhooky nájdete v histórii na stránke Prehľad.

Môžem si webhooky vypnúť? Webhooky Mergada sa spravujú na strane Mergada. V aplikácii len odoberiete webhookové spúšťače pri agentoch. FreeScout webhook zmažete na tejto stránke, len čo ho žiadny agent nepoužíva.

Ktoré udalosti sú k dispozícii? Pri Mergade napríklad udalosti okolo importu, exportu a aplikovania pravidiel, zmeny projektov, elementov, výberov, pravidiel a kľúčenky. Pri FreeScoute udalosti konverzácií, odpovedí a zákazníkov a vaše vlastné udalosti.

Môžu webhooky spúšťať automatizácie? Nie, automatizácie sa spúšťajú ručne alebo podľa plánu. Na udalosti reagujú len agenti.